Агенты

Методы раздела работают с одним агентом — тем, для которого создан API-ключ. Через них ваше приложение узнаёт настройки агента, отправляет сообщения и получает ответы, ведёт диалоги, собирает оценки и загружает файлы.

Какие агенты доступны

• Все методы раздела работают для агентов типов Ассистент и Агент.

• Для остальных типов (Chatflow, автономный агент и другие) доступна только карточка агента; остальные методы отвечают 400 с кодом unsupported_agent_type.

• Агент должен быть настроен и опубликован. Иначе отправка сообщения получает 400 с кодом agent_unavailable, а запрос настроек не настроенного агента — тот же код. Агент, который недоступен на платформе, отвечает этим кодом на любой метод, включая карточку.

• Доступ по API включается в блоке API на вкладке Управление агента. Там же создаётся ключ; он начинается с evo_agent_.

Пользователь вашего приложения — user_id

Большинство методов агента требуют user_id — идентификатор пользователя на вашей стороне: строку длиной от 1 до 255 символов. Используйте один и тот же user_id для одного и того же человека.

• Диалоги, сообщения, оценки и загруженные файлы принадлежат своему user_id. С другим user_id их не видно: чтение и изменение получают 404, а удаление отвечает 204 и ничего не меняет.

• user_id передаётся в теле JSON полем user_id, в multipart/form-data — полем формы, в запросах GET и DELETE — параметром запроса: ?user_id=....

Типичный порядок работы

1. Запросите настройки агента: какие переменные нужно заполнить в начале диалога и какие файлы агент принимает.

2. Если нужно отправить файлы, загрузите их и сохраните их идентификаторы.

3. Отправьте первое сообщение без dialog_id, со значениями переменных, — в ответе придёт dialog_id нового диалога.

4. Продолжайте диалог: отправляйте следующие сообщения с этим dialog_id.

5. При необходимости запросите историю диалога, оценку ответа или подсказки вопросов.

Методы