智能体工具(Agent Tools)
智能体工具是一组协议无关、可扩展的产品 API(与 /v1/me 同类),挂载在 POST /v1/tools/*,供桌面智能体在模型发起工具调用后使用。它们不是 OpenAI、Anthropic 或 Gemini 推理协议的一部分。
当前已接入:
| 工具 | 端点 | 可选供应商(Provider) |
|---|---|---|
| 网页搜索(Web Search) | POST /v1/tools/web-search | 博查、Tavily、阿里云 CleverSee、腾讯云联网搜索 WSA |
| 网页抓取(Web Fetch) | POST /v1/tools/web-fetch | Firecrawl、Tavily Extract、Jina Reader |
| 深度搜索(Web Deep Search) | POST /v1/tools/web-deep-search | Firecrawl Search、Jina Search |
| AI 率检测(AI Detection) | POST /v1/tools/ai-detection | 腾讯云 TMS(当前已实现) |
在管理台里要做什么
Section titled “在管理台里要做什么”- 打开工具配置(Tools → Configuration)。
- 在对应工具下点击供应商卡片,使用右侧抽屉填写凭证与 S / C / M 三账本单价(币种随系统计费币种变化)。
- 点击**仅保存配置(Save config only)可预配置非活跃引擎;点击保存并启用(Save & activate)**会保存草稿,并将其切换为该工具唯一的活跃引擎。未实现或凭证不完整的引擎不可启用。
- 清空当前活跃引擎的凭证前,请先保存并启用另一个凭证完整的引擎。
- 使用用户
sk-…调用对应的/v1/tools/*;在工具调用记录(Tools → Invocations)或 请求日志 中查看记录(provider_id=octafuse-tools)。
客户端最小示例
Section titled “客户端最小示例”curl -sS "$GATEWAY_URL/v1/tools/web-search" \ -H "Authorization: Bearer sk-your-api-key" \ -H "Content-Type: application/json" \ -d '{"query":"OctaFuse gateway","count":5}'完整字段与引擎白名单见 GitHub · 用户 API。