agent-Specialization/api_doc/tools.md

工具列表 API

该接口用于让 API 调用方获知服务端“工具分类”与“每个分类下的工具名称”。

鉴权：需要 Authorization: Bearer <TOKEN>

---

GET /api/v1/tools

成功响应（200）：

{
  "success": true,
  "categories": [
    {
      "id": "network",
      "label": "网络检索",
      "default_enabled": true,
      "silent_when_disabled": false,
      "tools": ["web_search", "extract_webpage", "save_webpage"]
    },
    {
      "id": "terminal_command",
      "label": "终端指令",
      "default_enabled": true,
      "silent_when_disabled": false,
      "tools": ["run_command", "run_python"]
    }
  ]
}

字段说明：

• categories[].id：工具分类 id（服务端内部标识）
• categories[].label：分类展示名
• categories[].tools：该分类下具体工具名称列表（用于前端渲染/筛选/白名单提示）
• default_enabled/silent_when_disabled：用于 UI/策略展示（并不等于“你一定能调用到该工具”，真实可用性仍取决于服务端策略与运行时环境）