SuperAPI AI 工具集

copilotkit-debug

编程与开发

查看项目

更新于 10-15 20:28

技能介绍

用途:该技能在 CopilotKit 运行出错时启用,典型场景包括运行时不可达或报错、智能体无法连接/响应/流式输出、前端工具不执行或不返回结果、语音转写失败、包之间版本不匹配、AG-UI SSE 事件缺失或格式异常,以及 CORS 阻断浏览器请求。

诊断流程:先收集信息再提修复方案——运行 npm ls @copilotkit/runtime @copilotkit/react-core @copilotkit/core @ag-ui/client 检查版本;确认运行时是 SSE 模式还是 Intelligence 模式;核对 runtimeUrl 与 createCopilotRuntimeHandler 的 basePath;识别智能体类型(BuiltInAgent、LangGraphAgent、A2AAgent 或自定义 AbstractAgent);收集浏览器控制台与服务端日志的完整报错;在浏览器网络面板查看 /info 探测、/agent/:id/run SSE 流与 CORS 预检。随后对照三套错误码体系(V1 遗留码、V2 CopilotKitCoreErrorCode、TranscriptionErrorCode)定位原因,并追踪 AG-UI 事件序列(RunStarted、文本与工具调用事件、StateSnapshot/StateDelta、Reasoning 事件、RunFinished、RunError)。可启用 @copilotkit/web-inspector 实时查看事件,或直接检查 Network 中的 text/event-stream。

可用参考文档包括 runtime-debugging、agent-debugging、error-patterns、quick-workflows。查找最新文档可通过 copilotkit-docs MCP 服务器的 search-docs 与 search-code 工具;Codex 需在 .codex/config.toml 添加 [mcp_servers.copilotkit-docs],type = "http",url = "https://mcp.copilotkit.ai/mcp",Claude Code 由插件 .mcp.json 自动配置。

验证方式:确认 /info 返回预期智能体列表,SSE 流产生从 RunStarted 到 RunFinished 的完整事件,控制台无残留结构化错误。

限制:资料未提供具体的错误码完整清单、各问题的具体修复代码与安装命令之外的操作细节,需参考上述参考文档与官方 troubleshooting 页面。