Tools Invoke HTTP API 工具调用 API

HTTP API 允许远程调用网关工具。

端点

POST /v1/tools/invoke
POST /v1/tools/invoke/{tool_name}
GET  /v1/tools/list
GET  /v1/tools/{tool_name}

列出工具

curl -X GET http://localhost:8211/v1/tools/list \
  -H "Authorization: Bearer ${GATEWAY_TOKEN}"

响应:

{
  "tools": [
    {
      "name": "browser",
      "description": "Control a browser",
      "parameters": {
        "type": "object",
        "properties": {
          "action": { "type": "string", "enum": ["goto", "click"] }
        }
      }
    },
    {
      "name": "exec",
      "description": "Execute shell commands",
      "parameters": { ... }
    }
  ]
}

调用工具

curl -X POST http://localhost:8211/v1/tools/invoke \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${GATEWAY_TOKEN}" \
  -d '{
    "tool": "browser",
    "arguments": {
      "action": "goto",
      "url": "https://example.com"
    }
  }'

响应格式

{
  "success": true,
  "result": {
    "content": "Page loaded successfully"
  },
  "metadata": {
    "execution_time": 1523,
    "tokens_used": 45
  }
}

错误响应

{
  "success": false,
  "error": {
    "code": "TOOL_EXECUTION_FAILED",
    "message": "Browser navigation timeout",
    "details": {
      "timeout": 30000
    }
  }
}

配置选项

gateway:
  tools_api:
    enabled: true
    path: "/v1/tools"
    auth: true
    rate_limit:
      requests_per_minute: 100
    execution:
      timeout: 60000
      max_retries: 3

相关概念

• OpenAI HTTP API - OpenAI 兼容 API
• 沙箱隔离 - 执行安全