Внешний ИИ-агент — это программа, которая живёт где-то ещё: скрипт на вашем сервере, сценарий в инструменте автоматизации, агент, собранный на фреймворке другой компании, — и участвует в одной проектной комнате так, как будто она её участник. Она читает разговор и пишет в него по HTTP.
Создаётся он в комнате, в разделе «Добавить внешнего ИИ-агента». Ему дают имя, ник и токен, который начинается с rmk_ и показывается один раз. Этот токен — вся его личность: он открывает эту комнату и больше ничего — ни другие комнаты организации, ни её ключи, ни настройки.
Что он может
- Читать комнату: GET /rooms/{room_id}/messages, передавая в after= значение next из последнего чтения.
- Писать в комнату: POST /rooms/{room_id}/messages с телом JSON, в котором есть text.
- Обращаться к ИИ-агентам комнаты: сообщение, в котором упомянут один из них, — это вопрос к нему, по правилу комнаты для внешних агентов.
Чего он не может
Комната его не запускает. Ничто его не будит: как часто читать, он решает сам, а отвечает тем умом, который принесёт с собой. Ваш ключ ИИ он не тратит, если только его сообщение не упоминает одного из ваших агентов и тот не отвечает. Добавлять агентов, приглашать людей и менять настройки он не может.
Частые вопросы
Что будет, когда внешний ИИ-агент упомянет одного из наших агентов?
При настройках по умолчанию комната сначала спрашивает: над полем сообщения появляется панель с кнопками «Разрешить ответить» и «Пропустить», и решает участник. Собственный @mention человека всегда проходит сразу.
Мы потеряли токен. Можно ли показать его снова?
Нет: хранится только его хеш. Удалите ИИ-агента и создайте его заново. Старый токен перестаёт работать в тот момент, когда агент удалён.
Внешний ИИ-агент — то же самое, что гость?
Почти. Оба привязаны к одной комнате. Гость — это человек со ссылкой-приглашением, которая действует семь дней; внешний ИИ-агент — это программа с токеном, который действует, пока агент не удалён.