AIKraft/Skills/copilotkit-agui

copilotkit-agui

Используется для создания пользовательских бэкендов агентов, реализации протокола AG-UI и отладки потоковой передачи. Охватывает типы событий, транспорт SSE, паттерны AbstractAgent/HttpAgent, синхронизацию состояния, вызовы инструментов и сценарии с участием человека.

COCopilotKit official Разработка ★ 37.7k

Что делает навык

AG-UI — это открытый событийный протокол CopilotKit для взаимодействия агентов с интерфейсом, обеспечивающий потоковую передачу структурированных событий через SSE или бинарный транспорт Protobuf. Skill позволяет создавать пользовательские бэкенды агентов, реализующие интерфейс AbstractAgent.run(), и управлять синхронизацией состояния, вызовами инструментов и потоками с участием человека.

Когда применять

  • Создание пользовательского бэкенда агента, который должен взаимодействовать с фронтендом через AG-UI.
  • Отладка проблем, когда события не доходят до фронтенда или приходят с ошибками.
  • Реализация интеграции нового фреймворка через метод AbstractAgent.run().
  • Настройка потоков с участием человека (human-in-the-loop) с возможностью прерывания и возобновления.
  • Работа с синхронизацией состояния, включая использование снимков (snapshots) и дельт JSON Patch.

Как работает

  1. Реализовать метод AbstractAgent.run(), который возвращает RxJS Observable<BaseEvent>.
  2. Настроить транспорт для потоковой передачи событий, используя SSE или бинарный протокол Protobuf.
  3. Обеспечить правильный порядок событий: жизненный цикл, текст, вызовы инструментов и состояние.
  4. Управлять синхронизацией состояния, выбирая между полными снимками (snapshots) и дельтами (JSON Patch).
  5. Обработать сценарии human-in-the-loop, реализуя логику прерывания и возобновления выполнения.
  6. Отлаживать проблемы потоковой передачи, проверяя кодировку и целостность доставляемых событий.

Примеры запросов агенту

Создай кастомный бэкенд агента, который отправляет события через AG-UI протокол.
Отладь проблему, при которой текстовые события от агента не отображаются на фронтенде.
Реализуй метод run() для нового фреймворка, возвращающий поток событий BaseEvent.

Что понадобится

  • Среда выполнения, поддерживающая RxJS и Observable.
  • Клиентский SDK CopilotKit для обработки применения событий и управления историей сообщений.
  • Настроенный транспорт (SSE или Protobuf) для потоковой передачи данных.

Описание составлено по SKILL.md навыка, сверено 06.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «copilotkit-copilotkit-agui» из репозитория: # https://github.com/copilotkit/copilotkit
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r copilotkit-copilotkit-agui/ ~/.claude/skills/copilotkit-copilotkit-agui/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.