跳转到内容

Agent Tools

Agent Tools 是一组 协议无关、可扩展 的产品 API（与 /v1/me 同类），挂在 POST /v1/tools/*，供桌面 Agent 在模型发起 tool call 后调用。它们不是 OpenAI / Anthropic / Gemini 推理协议的一部分。

能力面会随版本继续扩展。当前已接入的联网类工具：

工具	端点	说明
Web Search	`POST /v1/tools/web-search`	搜索结果列表
Web Fetch	`POST /v1/tools/web-fetch`	抓取单个 URL 正文
Web Deep Search	`POST /v1/tools/web-deep-search`	搜+读一体，结果常含正文，更贵、更慢

在管理台里要做什么

打开 Tools → Configuration。
为当前已支持的工具分别维护引擎 catalog：API Key + 单价（币种随系统计费币种）。
选择 Active 引擎；未保存 Key 的引擎不可激活。
用用户 sk-… 调用对应 /v1/tools/*；在 Tools → Invocations 或请求日志查看记录（provider_id=octafuse-tools）。

客户端最小示例

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。

下一步