SuperAPI AI 工具集

troubleshoot

智能体与模型

查看项目

更新于 10-16 00:32

技能介绍

用途:该技能基于 Copilot Chat 写入的调试日志,调查并解释聊天智能体的异常行为,回答诸如请求为何耗时过久、某工具或子代理为何被调用、指令/技能/代理文件为何未加载、工具调用为何被阻止或失败、模型为何未按预期执行等问题。结论需以日志证据为依据,不得猜测。

数据来源:分析目标为 {{VSCODE_TARGET_SESSION_LOG}} 指向的会话日志目录,核心文件为 debug-logs/<sessionId>/main.jsonl,包含完整对话流程,应优先读取;可选文件包括 models.json(会话开始时可用模型快照)、system_prompt_.json(未截断的系统提示)、tools_.json(工具定义)、runSubagent/searchSubagent 等子代理日志,以及仅用于界面的 title、categorization、summarize 文件。main.jsonl 中的 child_session_ref 条目按文件名链接各子文件。

日志格式:每行一个 JSON 对象,常见字段有 ts、dur、sid、type、name、spanId、parentSpanId、status、attrs。事件类型涵盖 discovery(加载指令、技能、代理、钩子)、tool_call(工具调用,含 args、result、error)、llm_request(模型往返,含 model、token 数、ttft、systemPromptFile、userRequest 等)、agent_response、user_message、subagent、generic(含 system_prompt_ref、tools_ref)、session_start、turn_start/turn_end 等。事件通过 spanId/parentSpanId 构成树状层级。

使用方式:日志文件位于工作区之外,工作区范围的 grep_search 无法访问,需改用终端。macOS/Linux/WSL/Git Bash 可用 grep、jq;Windows 可用 Select-String 或 node -e 单行命令。可查找错误、慢事件(dur>5000)、可疑事件上下文,并借助 spanId 关联。文件可能很大,应先查看大小,避免整文件读入内存,优先流式工具;read_file 仅用于已知行号的少量行。

限制:仅能基于已有日志证据得出结论;日志未覆盖的原因应明确说明。若怀疑网络或认证问题,可运行 VS Code 命令 github.copilot.debug.collectDiagnostics 获取诊断报告。需要核对自定义文件格式时,可参考 VS Code 官方自定义文档页面。若无法定位根因且无修复建议,可查阅 Copilot Issues wiki(https://github.com/microsoft/vscode/wiki/Copilot-Issues),仍无相关信息则建议在 https://github.com/microsoft/vscode/issues 提交问题。回答时应描述发生了什么及原因、关键日志证据(转述而非原样粘贴)、修复或后续尝试建议,避免叙述排查过程或使用内部术语。