codebuddy子代理可一键自动化接口调试全流程。它通过创建debug-api.md文件注册调试智能体，支持http请求发送、状态码校验、json schema验证、字段逻辑比对及差异报告生成，并可在cli、chat或ide中调用，实现高效精准的接口调试闭环。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
接口调试时需要反复构造请求、验证响应、比对字段、定位异常，手动操作耗时且容易遗漏边界条件。CodeBuddy子代理能将这一整套流程封装为可复用的“调试智能体”，在CLI中一键调用，自动完成请求发送→响应解析→字段校验→错误定位闭环。
创建调试子代理
在项目根目录下新建 【.codebuddy/agents/debug-api.md】 文件，确保路径准确——若目录不存在需手动创建，否则代理注册失败。
用文本编辑器打开该文件，写入以下内容：
---<br>name: "debug-api"<br>description: "专用于RESTful接口调试，支持JSON Schema校验与状态码语义分析"<br>tools: "http,fs,json"<br>color: "#2E86AB"<br>---<br>你是一个接口调试专家。用户会提供目标URL、HTTP方法、请求头（可选）、请求体（可选）及预期响应Schema。你的任务是：<br>1. 发送真实HTTP请求（使用curl或内置http工具）<br>2. 检查HTTP状态码是否在2xx/3xx范围内；若非，直接返回错误原因及建议<br>3. 若响应体为JSON，用提供的Schema验证结构与类型<br>4. 对比实际字段值与业务逻辑预期（如id应为数字、status应为枚举值）<br>5. 输出带行号标记的差异报告，并标注高危字段（如token过期、权限不足）
保存后，子代理即刻注册生效，无需重启CLI。
调用子代理执行调试
方法一：CLI命令行直接触发
运行 codebuddy -a debug-api，随后按提示输入：
URL：https://api.example.com/v1/users/123
Method：GET
Headers（留空则跳过）：Authorization: Bearer abc123
Expected Schema（粘贴JSON Schema片段）：{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"}}}
CodeBuddy Code CLI 的安装、配置与使用指南。CodeBuddy Code 是腾讯推出的 AI 驱动 CLI 编程助手，支持自然语言驱动开发。 - 必备触发词：CodeBuddy, codebuddy, AI CLI, Tencent AI coding, @tencent-ai/codebuddy-code, terminal AI assistant - 适用场景：安装 CodeBuddy CLI、配置 CodeBuddy、使用 CodeBuddy 命令、排查 CodeBuddy 问题
子代理会立即发起请求并返回结构化诊断结果，含响应耗时、字段缺失项、类型不匹配位置。
方法二：在Chat会话中作为工具调用
进入交互模式：codebuddy → 输入：请用debug-api子代理调试这个POST接口：https://api.example.com/v1/orders，请求体为{"product_id": 42, "qty": "3"}
【注意：请求体中qty字段传字符串而非数字，子代理会精准捕获该类型错误并标红提示】
对接IDE实时调试流
第一步：在VS Code中打开项目，确保CodeBuddy插件已启用“Sub-agent Integration”选项
第二步：右键点击任意API调用代码行（如 fetch('/api/users')），选择“Debug with debug-api”
第三步：插件自动提取URL、method、headers及上下文变量，生成调试参数并调用CLI子代理
第四步：结果直接内联显示在编辑器底部面板，点击“Show Full Response”可展开原始JSON，点击字段名可跳转至Schema定义处
这一步依赖插件与CLI的双向通信通道，若首次调用失败，请先运行 codebuddy --ide 启动本地代理桥接服务。
