У Znosin з’явилися агенти — самостійні учасники чатів, за якими працює ваш сервіс, програма або модель ШІ. Кожен має власне ім’я, унікальний нік та окремий токен. Створити агента можна в розмові з AgentFather.
Ми також відкрили розділ для розробників. Документація доступна без входу. Для захищених методів потрібен токен: відкритий API не робить чужу переписку загальнодоступною.
Помічники для ваших завдань
Агент може відповідати в особистому чаті та працювати у групі, отримувати адресовані йому повідомлення, надсилати текст, відповідати на повідомлення, змінювати й видаляти власні відповіді. Розробник може завантажувати вкладення з доступних агенту повідомлень.
На цій основі можна створити помічника за базою знань, приймання заявок або інтерфейс до свого сервісу. Наприклад, натискання кнопки запускає вашу програму, яка перевіряє права користувача та повертає результат. Бізнес-логіку реалізує розробник.
Створення через AgentFather
Відкрийте @agentfather і надішліть /newagent. Укажіть ім’я та вільний нік із закінченням _agent. Далі натисніть кнопку випуску токена та підтвердьте дію.
Токен показується окремо від переписки. Зберігайте його на сервері зі своїм кодом, не додавайте до публічних сторінок чи репозиторіїв. Через менеджер можна переглянути своїх агентів, змінити профіль, перевипустити токен, вимкнути агента або ввімкнути знову.
Менеджер і документація підтримують англійську, російську, українську, німецьку, французьку, польську та спрощену китайську.
Команди та кнопки
Введіть / у полі повідомлення, щоб побачити команди з описами. Список фільтрується під час введення. Оберіть команду мишею або стрілками й Enter, додайте аргументи за потреби та надішліть.
У групах меню підставляє отримувача: /help@support_agent. Розробник задає меню через API, а власник може скористатися /setcommands @nickname uk у AgentFather і надіслати рядки на зразок help - Допомога. Для кожної мови доступно до 20 команд.
- Кнопки дій під повідомленням передають окремі події, не створюючи нових повідомлень.
- HTTPS-посилання відкривають сайти.
- Кнопки міні-застосунків відкривають звичайну картку застосунку зі збереженням правил доступу.
- Клавіатура готових відповідей надсилає звичайні відповіді агенту й може ховатися після одного вибору.
На натискання агент може відповісти сповіщенням або окремим вікном і змінити власне повідомлення. Пересилання не переносить активні кнопки.
Мовою користувача
AgentFather автоматично відповідає мовою вашого інтерфейсу. Команда /language uk закріплює українську, а /language auto повертає автоматичний вибір. Доступні всі сім мов Znosin.
Для сторонніх агентів API передає from.language_code у вхідних повідомленнях і натисканнях кнопок, зокрема у групах. Розробник може обрати перекладені відповіді й кнопки для кожної людини. Це мова інтерфейсу на момент події; для старих подій або невідомої мови повертається null. API не перекладає тексти вашого агента автоматично.
Права доступу та ШІ
Токен самостійного агента не відкриває акаунт власника, пошту чи гаманець. Дії від імені користувача потребують окремих дозволів. В особистому діалозі людина пише першою. У групі агент отримує команди та відповіді на свої повідомлення; звичайна розмова не передається через чергу оновлень.
Під час обробки кнопок доступ до чату та повідомлення перевіряється повторно. Розробник додатково перевіряє бізнес-права: наприклад, чи може ця людина підтвердити конкретну заявку.
Оберіть свою мову програмування та середовище запуску. Підключення власної моделі ШІ або зовнішнього провайдера реалізується у вашому коді.
Почніть із прикладу
У посібнику Agent API є методи, обмеження та приклади. Доступні OpenAPI-схема і приклад Python із кнопками. Для натискань увімкніть callbacks=true. Події надходять через long polling; webhook і завантаження вихідних вкладень поки не підтримуються.
Почніть із /start, /help та однієї корисної кнопки, а потім розширюйте агента під своє завдання.
ZnosinУсі новини →