AIKraft/AI/Войти
AIKraft/Skills/copilotkit-debug

copilotkit-debug

Используется для диагностики проблем CopilotKit: сбоев подключения, ошибок стриминга, выполнения инструментов, проблем с транскрипцией, рассинхрона версий и трассировки событий AG-UI.

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

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

Навык предназначен для диагностики проблем CopilotKit, включая сбои подключения, ошибки стриминга, выполнение инструментов, проблемы с транскрипцией, рассинхрон версий и трассировку событий AG-UI. Он помогает выявлять корневые причины сбоев через анализ логов, сетевых запросов и кодов ошибок.

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

  • Когда CopilotKit runtime недоступен или возвращает ошибки, а агенты не могут подключиться или ответить.
  • При сбое фронтенд-инструментов, которые не выполняются или не возвращают результаты.
  • Если голосовая транскрипция не работает или возникают ошибки CORS, блокирующие запросы браузера.
  • При появлении ошибок рассинхрона версий между пакетами @copilotkit/runtime и @copilotkit/react-core.
  • Когда события AG-UI SSE имеют неверный формат или отсутствуют в потоке данных.

Как работает

  1. Соберите информацию: проверьте версии пакетов (npm ls), режим работы runtime (SSE или Intelligence), конфигурацию transport, тип агента и точные сообщения об ошибках из консоли и логов.
  2. Проанализируйте логи и коды ошибок, сопоставив их с каталогом в references/error-patterns.md, учитывая системы кодов V1, V2 (CopilotKitCoreErrorCode) и TranscriptionErrorCode.
  3. Отследите поток событий AG-UI (RunStartedEvent, TextMessageChunkEvent, ToolCallEvent и др.) через CopilotKit Web Inspector или вкладку Network браузера.
  4. Используйте справочные документы (references/runtime-debugging.md, references/agent-debugging.md) для сопоставления симптомов с известными проблемами.
  5. Примените исправление, затем проверьте, что эндпоинт /info возвращает список агентов, а SSE-поток формирует полную последовательность событий от RunStarted до RunFinished.

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

Проверь, почему агент не отвечает и в консоли ошибка agent_connect_failed.
Диагностируй проблему с транскрипцией голоса, где возникает ошибка service_not_configured.
Объясни, почему фронтенд не выполняет инструменты, и проверь соответствие версий пакетов CopilotKit.

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

  • Доступ к консоли браузера и вкладке Network для анализа запросов и SSE-потоков.
  • Установленные пакеты @copilotkit/runtime, @copilotkit/react-core, @copilotkit/core и @ag-ui/client.
  • Сервер copilotkit-docs MCP для поиска документации и примеров кода (опционально, через search-docs или search-code).

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

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

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

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