Для разработчиков

Обзор

AI-агент работает с Пачкой как участник команды: читает треды, ищет обсуждения, пишет сообщения и ставит напоминания. Агенту в вашей программе, например в Claude Code, Codex или Cursor, для этого нужны доступ к Пачке и знание, как в ней работать. Доступ даёт MCP-сервер или CLI. В описаниях инструментов MCP есть и правила каждого метода, а в инструкциях сервера основы переписки. Как связать вызовы в задачу, подскажут скиллы: они работают при любом способе доступа, в том числе в CLI, где справка описывает только параметры, и когда агент пишет код на API или SDK. Агента можно сделать и ботом Пачки: его зовут по нику в чате или треде, и он отвечает тредом.

Что можно поручить агенту

Что я пропустил в Пачке со вчерашнего дня?
Соберёт по чатам решения, вопросы к вам и ближайшие сроки со ссылками на сообщения
Где на этой неделе обсуждали переезд на новый сервер и кто в этом участвовал?
Поищет сообщения за неделю и назовёт чаты и авторов
Что нужно поправить по треду 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 сервер и скиллы можно поставить и одной установкой плагина «Пачка».

Другие способы

Кто работает и гдеЧто подходит
Вы пишете свою интеграцию, сервис, скрипт или задание CIREST API, SDK для TypeScript, Python, Go, Kotlin, Swift и C# или CLI
Агент живёт в Пачке: его зовут по нику в чате или треде либо пишут ему в личные сообщенияБот, подробнее — в разделе Взаимодействие с агентом
Сценарий в n8n с узлом AI AgentПачка как инструмент AI Agent

Что включить у бота под вашу задачу, сказано в разделе С чего начать. Агент, который пишет код под API, берёт справку из документации для агента или из CLI, а как писать такой код правильно, подскажут скиллы.

Токен и доступ агентов

Каждый способ выдаёт агенту обычный токен API, поэтому подключать агентов разрешают те же настройки пространства, что и доступ к API.

Пачка как среда для AI-агентов

Агента зовут в тред, и он отвечает туда же, не засоряя общий чат. Так работает и бот Пачки, которого зовут по нику, и агент в вашей программе, который следит за тредом.

Пример работы AI-агента в треде Пачки

Тред — единица работы агента. У треда одна тема и свой контекст, как у отдельного чата с агентом. Обсуждение в треде обычно укладывается в несколько дней и несколько десятков сообщений, поэтому агент читает его целиком и не теряет нить, а беседа или личные сообщения длятся без конца, и темы в них сменяют друг друга. Подробнее — на странице Треды.

  • Агент — участник команды. Работу выполняет агент, а отвечает за неё тот, кто его позвал.
  • Доступ по треду. Если агента нет в закрытом чате, из этого чата он видит только свой тред и сообщение, к которому тред открыт. Открытую беседу или канал агент читает целиком и без добавления, подробнее — в разделе Доступы к чатам и сообщениям.
  • Сквозные треды. Упомяните в треде сотрудника, и он увидит тред, даже если не состоит в исходном чате. Так упоминание работает по умолчанию. От чего это зависит — в разделе Участники треда. Один тред — общая точка координации сотрудников и агента.
  • Самостоятельные треды. Тред можно создать без привязки к чату — как отдельное место для диалога с агентом, куда добавляют только нужных участников.

Бот получает сообщения исходящим вебхуком или из истории событий, для которой публичный адрес не нужен, и отвечает токеном бота. Как это устроено — в разделах Взаимодействие с агентом и Общение с ботом, а как мы сделали такого агента, рассказано в блоге Пачки.

Чем бот отличается от агента в программе, сказано в разделе Когда лучше бот. Чтобы агент в программе писал вам с уведомлением, дайте ему личного бота.

Документация для агента

Агенту, который пишет код под API или разово разбирается, как устроена Пачка, дайте документацию ссылкой в просьбе.

Пример просьбы
Напиши обработчик исходящего вебхука Пачки.Документация: https://dev.pachca.com/llms.txt
ЧтоЧто это и когда подходит
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: так агенту не нужно искать и загружать страницы документации.