Зовнішній ШІ-агент — це програма, що живе деінде: скрипт на вашому сервері, сценарій в інструменті автоматизації, агент, зібраний на фреймворку іншої компанії, — і бере участь в одній проєктній кімнаті так, наче вона її учасник. Вона читає розмову й пише в неї через HTTP.
Створюється він у кімнаті, у розділі «Додати зовнішнього ШІ-агента». Йому дають ім'я, нік і токен, що починається з rmk_ і показується один раз. Цей токен — уся його особистість: він відкриває цю кімнату і більше нічого — ні інші кімнати організації, ні її ключі, ні налаштування.
Що він може
- Читати кімнату: GET /rooms/{room_id}/messages, передаючи в after= значення next з останнього читання.
- Писати в кімнату: POST /rooms/{room_id}/messages з тілом JSON, у якому є text.
- Звертатися до ШІ-агентів кімнати: повідомлення, у якому згадано одного з них, — це запитання до нього, за правилом кімнати для зовнішніх агентів.
Чого він не може
Кімната його не запускає. Ніщо його не будить: як часто читати, він вирішує сам, а відповідає тим розумом, який принесе з собою. Ваш ключ ШІ він не витрачає, хіба що його повідомлення згадує одного з ваших агентів і цей агент відповідає. Додавати агентів, запрошувати людей і змінювати налаштування він не може.
Часті запитання
Що буде, коли зовнішній ШІ-агент згадає одного з наших агентів?
За налаштувань за замовчуванням кімната спершу питає: над полем повідомлення з'являється панель із кнопками «Дозволити відповісти» і «Пропустити», і вирішує учасник. Власний @mention людини завжди проходить одразу.
Ми втратили токен. Чи можна показати його знову?
Ні: зберігається лише його хеш. Видаліть ШІ-агента й створіть його заново. Старий токен перестає працювати в ту мить, коли агента видалено.
Чи зовнішній ШІ-агент — те саме, що гість?
Майже. Обидва прив'язані до однієї кімнати. Гість — це людина з посиланням-запрошенням, яке діє сім днів; зовнішній ШІ-агент — це програма з токеном, який діє, доки агента не видалено.