获取工具

GET

/v1/convai/tools

GET

/v1/convai/tools

curl https://api.elevenlabs.io/v1/convai/tools

{
  "tools": [
    {
      "id": "string",
      "tool_config": {
        "type": "system",
        "name": "end_call",
        "params": {
          "system_tool_type": "end_call"
        },
        "description": ""
      },
      "access_info": {
        "is_creator": true,
        "creator_name": "John Doe",
        "creator_email": "john.doe@example.com",
        "role": "admin",
        "access_source": "creator"
      },
      "usage_stats": {
        "avg_latency_secs": 1.1,
        "total_calls": 0
      },
      "response_mocks": [
        {
          "mock_result": "string",
          "parameter_conditions": [
            {
              "eval": {
                "description": "string",
                "type": "string"
              },
              "path": "string"
            }
          ],
          "is_error": false
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}

获取工作区内所有可用工具。

查询参数

searchstring or null可选

指定后，此端点仅返回名称以此字符串开头的工具。

page_sizeinteger or null可选1-100

最多返回的文档数量。不能超过 100，默认为 30。

show_only_owned_documentsboolean可选默认为 falseDeprecated

设为 true 时，此端点仅返回你拥有的工具（不包括他人分享的工具）。已弃用：请改用 created_by_user_id。

created_by_user_idstring or null可选

按创建者用户 ID 筛选工具。设置后，仅返回该用户创建的工具。此项优先于 show_only_owned_documents。使用 ‘@me’ 表示已认证用户。

typeslist of enums or null可选

提供后，端点仅返回指定类型的工具。

允许的值:

sort_directionenum可选

结果排序方向

允许的值:

sort_byenum or null可选

用于排序结果的字段

允许的值:

cursorstring or null可选

用于获取下一页。响应中会返回游标。

响应

成功响应

toolslist of objects

has_moreboolean

next_cursorstring or null可选

错误

422

Unprocessable Entity Error

请求头

查询参数

响应

错误