Суть решения: Транспорт, а не новый агент
Главная проблема интеграции AI-агентов в корпоративные мессенджеры — дублирование логики. CopilotKit Channels SDK решает это, выступая не как второй агент, а как транспортный слой и рендеринговый адаптер. Разработчики пишут сообщение один раз на JSX, а библиотека автоматически конвертирует его в нативные форматы платформ: Block Kit для Slack и Adaptive Cards для Microsoft Teams. Это избавляет от отправки простых текстовых блоков через вебхуки и позволяет использовать интерактивные элементы интерфейса.
Технические детали и совместимость
SDK работает поверх протокола AG-UI (Agent-User Interaction), который поддерживает такие фреймворки, как LangGraph, CrewAI, Mastra, Pydantic AI и Google ADK. Модель и оркестрация остаются на стороне разработчика, а CopilotKit Intelligence управляет только платформенными учетными данными, маршрутизацией и переподключением.
Для работы требуется Node.js 22+ и проект на ESM. Архитектура предполагает использование долгоживущего процесса (long-running listener), поэтому серверные решения (serverless) на данный момент не поддерживаются, так как не могут удерживать постоянное соединение.
Ключевые возможности для разработчиков
Библиотека ориентирована на сложные сценарии работы в потоках сообщений, а не просто на чат. Основные функции включают:
- Generative UI: Агент рендерит сложные интерфейсы, когда задача этого требует.
- Human in the loop: Механизм подтверждения действий. Пример: в демо OpenTag все изменения в Linear и Notion перехватываются до отправки MCP-запроса, и операция выполняется только после явного подтверждения пользователем.
- Инструменты (Tools): Прямое выполнение действий, таких как создание задач, бронирование встреч или открытие pull-реквестов.
- Постоянство (Persistence): Транскрипты сохраняют контекст и память между сессиями и платформами.
Роли и разделение ответственности
Архитектура четко разделяет зоны ответственности. Разработчик управляет агентом, моделями, инструментами, бизнес-логикой, состоянием приложения и логами. Служба CopilotKit Intelligence берет на себя управление учетными данными платформ, входящим трафиком, регистрацией рантайма, мониторингом здоровья (health checks) и переподключением.
Доступность и планы развития
Библиотека @copilotkit/channels версии 0.5.0 доступна на npm под лицензией MIT. На данный момент Slack является платформой с общим доступом (GA), а Microsoft Teams находится в стадии раннего доступа (Early Access). В пакете уже предусмотрены адаптеры для Discord, Telegram и WhatsApp, которые будут выпущены в ближайшее время.
| Платформа | Статус поддержки | Технические особенности |
|---|---|---|
| Slack | General Availability (GA) | Использует Block Kit, управляемый провайдер CopilotKit |
| Microsoft Teams | Early Access | Использует Adaptive Cards, требует ключа API Intelligence |
| Discord / Telegram / WhatsApp | Планируемые (Upcoming) | Адаптеры уже включены в пакет, но не активированы |
Как начать работу
Установка состоит из двух пакетов:
npm install @copilotkit/channels @copilotkit/runtimeИнициализация рантайма требует создания канала, подключения агента и настройки слушателя. Ключевым моментом является ожидание события channels.ready(), которое гарантирует успешное подключение или выдаст ошибку на этапе старта, предотвращая тихие сбои конфигурации.
Источник: MarkTechPost ↗