> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://dev.pachca.com/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ. # AI агенты Пачка — готовая среда для AI-агентов. Эта страница для команд и разработчиков: чем Пачка уже помогает в работе с агентами, как агента подключить и куда смотреть дальше. ## Пачка как среда для AI-агентов Упомяните агента в треде — остальное он сделает сам. Агент находится внутри разговора, видит контекст и действует автономно. - **Агент — участник команды** — действует как сотрудник: читает обсуждения, создаёт задачи, отправляет результаты. Ответственность остаётся за человеком, агент выполняет работу - **Треды как единица работы** — каждый тред изолирован, агент видит только его содержимое и отвечает туда же, не загрязняя общий чат - **Сквозные треды** — упомяните любого сотрудника в треде, и он увидит весь контекст, даже если не состоит в исходном чате. Один тред — единая точка координации между людьми и агентом > Как мы сделали AI-агента, который живёт в корпоративном мессенджере — [читайте в блоге Пачки](https://pachca.com/blog/ai-agent-v-korporativnom-messendzhere) ![Пример работы AI-агента в треде Пачки](/images/ai-agent-kai.webp) *Пример работы AI-агента в треде Пачки* - [Взаимодействие с агентом](/guides/ai-agents/interaction) — Как агент получает события, собирает контекст и отвечает. Реакция-индикатор и таймер agent-thinking - [Markdown и документы](/guides/ai-agents/markdown) — Агент присылает отчёты и сводки в .md, Пачка рендерит их оформленной карточкой ## Как подключить Пачку к агенту ### llms.txt Самый простой способ для разовых задач. Скопируйте ссылку в промпт агента — он получит сводку API со ссылками на документацию. Подходит, когда нужно быстро попросить агента сделать что-то конкретное в Пачке. ```text title="Пример промпта" Сделай X, потом Y в Пачке. Посмотри как надо: https://dev.pachca.com/llms.txt ``` Полная документация в одном файле — [llms-full.txt](/llms-full.txt) (~329K токенов). В стандартные контекстные окна не помещается: 200K у Claude и 128K у GPT-4o. Целиком грузится только в модели с расширенным окном — Gemini 1.5 Pro, Claude 1M. Для постоянной работы предпочтителен CLI — он не нагружает контекст (см. ниже). - [llms.txt](/llms.txt) — Краткая сводка документации со ссылками на страницы - [llms-full.txt](/llms-full.txt) — Полная документация в одном файле для загрузки в контекст агента > Любая страница документации доступна в markdown-формате — добавьте `.md` к адресу страницы. Например: `/guides/webhook.md` ### CLI Самый быстрый и производительный способ и основной путь для постоянной работы. Минимальное влияние на контекст агента — не нужно загружать документацию, агент узнаёт возможности через `--help`. Если есть доступ к shell, агент может генерировать скрипты для типовых задач. ```bash # Без установки — для разовых задач, CI и агентов с временным окружением npx -y @pachca/cli api ls --token # Или глобально — для регулярной работы npm install -g @pachca/cli pachca messages create --entity-id 123 --content "Готово" pachca users list -o json ``` Через CLI доступны и произвольные запросы к любому эндпоинту, и вся документация API прямо в терминале — список методов, их параметры, схемы и полный справочник. Агенту не нужно открывать сайт или грузить документацию в контекст. Подробнее — в разделе [Прямые запросы](/guides/cli/api-requests). ```bash # Произвольный запрос к любому эндпоинту pachca api POST /messages -F message[chat_id]=123 -f message[content]="Привет" # Документация по API прямо в терминале pachca api ls # список эндпоинтов pachca api POST /messages --describe # параметры, тело, эквивалентная команда pachca api GET /messages --spec # OpenAPI-фрагмент pachca api POST /messages --docs # полный markdown-референс ``` - [@pachca/cli](https://www.npmjs.com/package/@pachca/cli) — Пакет на npm - [Руководство CLI](/guides/cli/overview) — Установка, авторизация, скрипты и CI, полный справочник команд ### Context7 Сторонний MCP-сервис. [Context7](https://context7.com) отдаёт актуальную документацию Пачки в контекст агента — только документацию, без выполнения действий в API. Подходит, когда вы часто просите агента делать разные задачи в Пачке из промптов и хотите, чтобы у него была свежая документация под рукой. ```bash claude mcp add context7 https://mcp.context7.com/mcp ``` Для других агентов добавьте MCP-сервер `https://mcp.context7.com/mcp` в настройках. Чтобы агент использовал документацию Пачки, добавьте в промпт `use context7` или настройте это через правила агента. - [Пачка на Context7](https://context7.com/pachca/openapi) — Документация Пачки в Context7 — сторонний MCP-сервис с актуальной документацией для AI-агентов ### OpenAPI-спецификация Классический вариант для разработчиков. Наиболее полное описание API без дополнительных обвязок — типы, схемы, все эндпоинты. Подходит для кодогенерации (openapi-generator, Kiota, Orval), GPT Actions и когда вы строите собственную интеграцию с API. ```text https://dev.pachca.com/openapi.yaml ``` - [OpenAPI-спецификация](/openapi.yaml) — OpenAPI 3.0 — типы, схемы, все эндпоинты ### Arazzo (многошаговые сценарии) OpenAPI описывает отдельные методы. [Arazzo](https://spec.openapis.org/arazzo/latest.html) — стандарт OpenAPI Initiative для готовых последовательностей вызовов. Машиночитаемое описание типовых сценариев Пачки (в каком порядке какие методы вызывать) — полезно агентам и workflow-движкам для многошаговых задач. ```text https://dev.pachca.com/workflows.arazzo.yaml ``` - [Arazzo-сценарии](/workflows.arazzo.yaml) — Многошаговые сценарии API в формате Arazzo 1.0.1 ### Agent Skills Набор специфичных знаний об API, разбитый на предметные области (сообщения, чаты, задачи и др.). Каждый скилл содержит описания методов, [сценарии](/guides/workflows) с curl-примерами, обработку ошибок и gotchas. Скиллы — не обязательный и не единственный способ работы с API, а отправная точка, которую можно модифицировать под свои задачи. ```bash npx skills add pachca/openapi ``` Команда автоматически определит установленные агенты и подключит скиллы. Совместимы с 40+ AI-агентами через [Skills CLI](https://skills.sh). - [Agent Skills](https://agentskills.io) — Спецификация формата скиллов - [Agent Skills Discovery RFC](https://github.com/cloudflare/agent-skills-discovery-rfc) — Протокол обнаружения скиллов