Взаимодействие с агентом
Агент в Пачке — это бот: его зовут по нику в чате или треде либо пишут ему в личные сообщения, он читает контекст, делает работу и отвечает там же. Как бот получает сообщения, понимает, что обращаются к нему, и куда отвечает — в разделе Общение с ботом. Здесь — то, что нужно именно агенту.
Создай бота с ИИ-агентом, который отвечает сотрудникам в треде. Скачай страницы документации и делай по ним: `curl -sL https://dev.pachca.com/guides/ai-agents/interaction.md https://dev.pachca.com/guides/bots/conversations.md https://dev.pachca.com/guides/webhook/deploy.md`. Инструмент для веба отдаёт пересказ, бери его, только если curl не сработал. Если страницы не открылись и так или у тебя нет инструментов Пачки, остановись и скажи. Если у тебя есть скилл `pachca-ai-agent`, работай и по нему. 1. Спроси, как назвать бота, на чём писать обработчик и какую модель вызывать. 2. Создай бота с токеном и беседу для проверки с ботом. Настрой его по разделу «Что настроить», кроме шага «Бот в чатах», без адреса вебхука. 3. В этой папке напиши обработчик по разделу «Как работает агент» на основе раздела «Пример бота». Если реакции `agent-thinking` в пространстве нет, обходись без неё. Токен и Signing secret держи только в `.env`, добавленном в `.gitignore`. Ключ модели я положу туда сам: назови переменную и жди. 4. Запусти в фоне обработчик и пересылку событий из раздела «Разработка без публичного адреса». Попроси меня спросить бота в беседе через @ в приложении и проверь ответ в треде. 5. Перечисли, что создано, как всё перезапустить и убрать. Если мешают права, роль или настройки пространства, не обходи: скажи, что мешает и кто это изменит. Чего не можешь сам, например запустить код, дай мне готовыми командами.
Как работает агент
Получает сообщение
Агенту нужен режим Любые сообщения: отдельного режима «только упоминания» нет, и агент сам решает, обращаются ли к нему. Как это понять, сказано в разделе Когда отвечать. Публичного бота зовут в тред упоминанием, даже если его нет в чате, а непубличного добавляют в чат или тред участником. Условия — в разделе Треды.
Показывает, что работает
Сразу ставит на сообщение реакцию agent-thinking: сотрудник видит таймер и понимает, что агент взялся за дело. Подробнее — в разделе Реакция agent-thinking.
Собирает контекст
Читает историю треда и родительское сообщение: суть просьбы обычно там, выше сообщения с упоминанием. Как их получить — в разделе Контекст разговора.
Делает работу
Вызывает методы API и внешние сервисы, например:
- POSTНовое напоминание — напоминание по итогам разговора
- POSTНовое сообщение — сообщение в другой чат
- POSTНовый самостоятельный тред — отдельное обсуждение без привязки к чату
Если среда агента поддерживает MCP, те же методы доступны инструментами MCP-сервера с токеном бота. Подробнее — в разделе Токен бота.
Отвечает и снимает реакцию
Отвечает там, где позвали: в личные сообщения, в тот же тред, а в беседе или канале тредом к сообщению. Подробнее — в разделе Куда отвечать. Длинный результат удобно прислать файлом .md — подробнее в разделе Оформление ответов. После ответа агент снимает реакцию методом DELETEУдаление реакции с тем же name.
Реакция agent-thinking
Создайте кастомную реакцию с именем agent-thinking и загрузите анимированную иконку. Когда агент ставит эту реакцию на сообщение, интерфейс Пачки показывает вместо счётчика живой таймер: сотрудник видит, сколько секунд агент уже работает. Таймер идёт до 5 минут от первой такой реакции на сообщении, потом вместо него снова виден счётчик. В методе POSTДобавление реакции передайте name со значением agent-thinking и любое непустое code до 16 символов, например ⏳. Без code метод ответит 422 с кодом blank, а на более длинное code ответит 400 с кодом too_long. Если кастомной реакции agent-thinking в пространстве нет, метод ответит 404. Снимают реакцию с тем же name, иначе метод будет искать обычный эмодзи по code.
Таймер реакции agent-thinking
Практические советы
- Один бот — один агент. Отдельный бот на каждого агента разделяет права, токены и логику.
- Ошибка — тоже ответ. Если агент не может выполнить задачу, пусть ответит в тред с пояснением, а не молчит: прозрачность важнее идеального результата.
- Черновик — с личным токеном сотрудника. Агенту-боту черновики недоступны, подробнее — в разделе Работает только личным токеном. Если ответ нужно проверить, пришлите его вызвавшему сотруднику в личные сообщения с ботом как предложение, и он отправит его сам.
- Права сотрудника — через авторизацию. Если агенту нужны данные того, кто его позвал, например его напоминания или чаты, сотрудник авторизует бота — подробнее в разделе Авторизация от имени сотрудника.
- Агент видит больше, чем сотрудники, которым он отвечает. Бот читает все открытые беседы и каналы и все чаты и треды, где состоит, кто бы его ни спросил. Сообщения, файлы и участников другого чата агент приводит в ответе, если этот чат видят все, кто прочтёт ответ. Иначе он пишет, что не может поделиться ими здесь. Чат видят сотрудники из его
member_idsв методе GETИнформация о чате, а открытую беседу или канал сpublic: trueвидят также все сотрудники, кроме гостей и мульти-гостей. Кто видит тред, сказано в разделе Кто видит тред. - Другим ботам и программам агент отвечает, когда его зовут. Иначе два агента, которые отвечают на любые сообщения, могут отвечать друг другу без конца, подробнее — в разделе Сообщения. Автора-бота узнают методом GETИнформация о сотруднике: у бота поле
botравноtrue. У сообщения, которое программа отправила токеном сотрудника, например другой агент через MCP, заполнено полеsource.