Agent Tools

Agent Tools are protocol-agnostic, extensible product APIs (same family as /v1/me) under POST /v1/tools/* for desktop agents after a model tool call. They are not part of OpenAI / Anthropic / Gemini chat protocols.

Available today:

Tool	Endpoint	Available Providers
Web Search	POST /v1/tools/web-search	Bocha, Tavily, Alibaba Cloud CleverSee, Tencent Cloud 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 Detection	POST /v1/tools/ai-detection	Tencent Cloud TMS (currently implemented)

Dependencies and limits

• You must supply third-party engine API keys (see the Admin whitelist).
• Exactly one Active engine per tool; calls return 503 when the Active engine has no key.
• Web tools bill per call; AI Detection bills by billingUnitChars character units. Upstream failures are not charged.
• Configure S standard / C charged / M metered prices separately for every Provider. Only C increases the user budget, and the three prices may differ.
• Model Route factors and daily schedules do not apply. Cards flag unsaved changes, missing credentials, unavailable engines, and loss pricing (C < M).

What to do in Admin

1. Open Tools → Configuration.
2. Click a Provider card and use the right-side drawer to enter credentials plus S / C / M prices (currency follows system billing currency).
3. Use Save configuration only to prepare a non-Active engine. Save and activate stores the draft and switches the tool’s single Active engine; unimplemented engines or incomplete credentials cannot be activated.
4. Before clearing credentials from the current Active engine, save and activate another fully configured engine.
5. Call /v1/tools/* with a user sk-…; inspect Tools → Invocations or Request logs (provider_id=octafuse-tools).

Minimal client call

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}'

Full fields and engine whitelists: GitHub · user API.

Next

• Image generation / edit
• System config · Request logs