Обзор
AI-агент работает с Пачкой как участник команды: читает треды, ищет обсуждения, пишет сообщения и ставит напоминания. Агенту в вашей программе, например в Claude Code, Codex или Cursor, для этого нужны доступ к Пачке и знание, как в ней работать. Доступ даёт MCP-сервер или CLI. В описаниях инструментов MCP есть и правила каждого метода, а в инструкциях сервера основы переписки. Как связать вызовы в задачу, подскажут скиллы: они работают при любом способе доступа, в том числе в CLI, где справка описывает только параметры, и когда агент пишет код на API или SDK. Агента можно сделать и ботом Пачки: его зовут по нику в чате или треде, и он отвечает тредом.
Доступ к Пачке: инструмент на каждый метод API с правами вашего токена
Доступ к Пачке из терминала: команда на каждый метод API, справка по --help
Как делать задачи из нескольких шагов: пересказать тред целиком, собрать дайджест, выбрать токен, сделать бота
Что можно поручить агенту
- Что я пропустил в Пачке со вчерашнего дня?
- Соберёт по чатам решения, вопросы к вам и ближайшие сроки со ссылками на сообщения
- Где на этой неделе обсуждали переезд на новый сервер и кто в этом участвовал?
- Поищет сообщения за неделю и назовёт чаты и авторов
- Что нужно поправить по треду https://app.pachca.com/chats?thread_message_id=123?
- Соберёт замечания нумерованным списком со ссылками, сверит каждое с кодом, если в сессии есть код, и спросит, какие взять в работу
- Поставь мне напоминания по итогам треда про релиз 2.4 со сроком в пятницу
- Создаст напоминания со сроком и текстом из треда
- Подготовь в канал «Релизы» анонс версии 2.4, я проверю и отправлю сам
- Оставит в канале черновик, а отправите его вы
- Следи за тредом https://app.pachca.com/chats?thread_message_id=123 и отвечай на вопросы по API
- Будет отвечать в треде по задаче, пока открыта сессия, подробнее — на странице Агент следит за тредом
Агент работает точнее, если в просьбе есть название чата, тема треда, период и что сделать с результатом. Задачи по всему API, например пригласить сотрудника или выгрузить переписку, собраны в разделе Что можно попросить агента.
Как подключить Пачку к агенту
Все способы вызывают одни и те же методы API с правами токена, которым подключён агент. Агенту в программе подключают доступ к Пачке и ставят скиллы:
Подключите доступ
MCP-сервер. Добавьте в программу адрес https://mcp.pachca.com/mcp и войдите в Пачку через браузер, а в Cursor и других программах без входа через браузер задайте персональный токен, подробнее — на странице Подключение к MCP. Подходит программе с MCP, в том числе без терминала, например приложению Claude.
CLI. Выполните npm install -g @pachca/cli и pachca auth login, подробнее — в разделе CLI. Подходит агенту, который запускает команды: он узнаёт их из --help и тратит меньше контекста модели.
Поставьте скиллы
Выполните npx skills add https://dev.pachca.com -g -a claude-code -y, подставив вместо claude-code свою программу, или попросите об этом агента. Команде нужен Node.js. Какая версия нужна и как поставить скиллы в приложение Claude и в программы без Node.js, сказано в разделе Установка скиллов. Со скиллом сообщений агент сам пишет коллегам коротко, в тред и вашим голосом, и просить его об этом каждый раз не нужно.
В Claude Code, приложении Claude, Codex, VS Code и Cursor сервер и скиллы можно поставить и одной установкой плагина «Пачка».
Другие способы
| Кто работает и где | Что подходит |
|---|---|
| Вы пишете свою интеграцию, сервис, скрипт или задание CI | REST API, SDK для TypeScript, Python, Go, Kotlin, Swift и C# или CLI |
| Агент живёт в Пачке: его зовут по нику в чате или треде либо пишут ему в личные сообщения | Бот, подробнее — в разделе Взаимодействие с агентом |
| Сценарий в n8n с узлом AI Agent | Пачка как инструмент AI Agent |
Что включить у бота под вашу задачу, сказано в разделе С чего начать. Агент, который пишет код под API, берёт справку из документации для агента или из CLI, а как писать такой код правильно, подскажут скиллы.
Токен и доступ агентов
Каждый способ выдаёт агенту обычный токен API, поэтому подключать агентов разрешают те же настройки пространства, что и доступ к API.
Для агента на машине сотрудника, агента без участия сотрудника и CI
Для администраторов: кто может подключить агента, что он видит и как закрыть подключение
Пачка как среда для AI-агентов
Агента зовут в тред, и он отвечает туда же, не засоряя общий чат. Так работает и бот Пачки, которого зовут по нику, и агент в вашей программе, который следит за тредом.
Пример работы AI-агента в треде Пачки
Тред — единица работы агента. У треда одна тема и свой контекст, как у отдельного чата с агентом. Обсуждение в треде обычно укладывается в несколько дней и несколько десятков сообщений, поэтому агент читает его целиком и не теряет нить, а беседа или личные сообщения длятся без конца, и темы в них сменяют друг друга. Подробнее — на странице Треды.
- Агент — участник команды. Работу выполняет агент, а отвечает за неё тот, кто его позвал.
- Доступ по треду. Если агента нет в закрытом чате, из этого чата он видит только свой тред и сообщение, к которому тред открыт. Открытую беседу или канал агент читает целиком и без добавления, подробнее — в разделе Доступы к чатам и сообщениям.
- Сквозные треды. Упомяните в треде сотрудника, и он увидит тред, даже если не состоит в исходном чате. Так упоминание работает по умолчанию. От чего это зависит — в разделе Участники треда. Один тред — общая точка координации сотрудников и агента.
- Самостоятельные треды. Тред можно создать без привязки к чату — как отдельное место для диалога с агентом, куда добавляют только нужных участников.
Бот получает сообщения исходящим вебхуком или из истории событий, для которой публичный адрес не нужен, и отвечает токеном бота. Как это устроено — в разделах Взаимодействие с агентом и Общение с ботом, а как мы сделали такого агента, рассказано в блоге Пачки.
Как агент собирает контекст треда, показывает таймер agent-thinking и отвечает
Агент в программе на вашем компьютере следит за тредом и отвечает в нём, пока вы заняты другим
Агент с личным токеном готовит сообщение, а отправляет его сотрудник
Отчёты и сводки агента в .md Пачка показывает оформленной карточкой, а .html, .txt и .json открывает просмотром
Чем бот отличается от агента в программе, сказано в разделе Когда лучше бот. Чтобы агент в программе писал вам с уведомлением, дайте ему личного бота.
Документация для агента
Агенту, который пишет код под API или разово разбирается, как устроена Пачка, дайте документацию ссылкой в просьбе.
| Что | Что это и когда подходит |
|---|---|
| llms.txt | Сводка API, способы подключения и ссылки на страницы: с неё проще всего начать |
| llms-full.txt | Вся документация одним файлом: целиком в контекст обычно не помещается, агент берёт нужные разделы |
| Markdown-версия страницы | Добавьте .md к адресу, например /guides/webhook/overview.md (для главной страницы /index.md), или запросите страницу с заголовком Accept: text/markdown |
| OpenAPI-спецификация | OpenAPI 3.0 со всеми методами, типами и схемами для кодогенерации на языках без SDK и для своих инструментов |
| Коллекция Postman | Запросы, которые удобно пробовать вручную |
Для постоянной работы подключите MCP-сервер или CLI: так агенту не нужно искать и загружать страницы документации.