获取 MCP 工具配置覆盖

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

GET

/v1/convai/mcp-servers/:mcp_server_id/tool-configs/:tool_name

curl https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs/tool_name

{
  "tool_name": "string",
  "pre_tool_speech": "auto",
  "interruption_mode": "allow",
  "tool_call_sound": "typing",
  "tool_call_sound_behavior": "auto",
  "execution_mode": "immediate",
  "response_timeout_secs": 1,
  "assignments": [
    {
      "dynamic_variable": "string",
      "value_path": "string",
      "source": "response",
      "sanitize": false,
      "preserve_native_type": false
    }
  ],
  "input_overrides": {},
  "response_mocks": [
    {
      "mock_result": "string",
      "parameter_conditions": [
        {
          "eval": {
            "description": "string",
            "type": "string"
          },
          "path": "string"
        }
      ],
      "is_error": false
    }
  ],
  "force_pre_tool_speech": true,
  "disable_interruptions": true
}

获取指定 MCP 工具的配置覆盖项。

路径参数

mcp_server_idstring必需

MCP 服务器 ID。

tool_namestring必需

要获取配置覆盖的 MCP 工具名称。

响应

成功响应

tool_namestring

MCP 工具名称

pre_tool_speechenum or null可选默认为 auto

设定后，覆盖服务器对此工具的 pre_tool_speech 设置。

允许的值:

interruption_modeenum or null可选默认为 allow

设定后，覆盖服务器对此工具的 interruption_mode 设置。

允许的值:

tool_call_soundenum or "off" or null可选

覆盖服务器对此工具的 tool_call_sound 设置。声音名称会播放对应声音；‘off’ 覆盖为无声音（静音）；null 表示不覆盖（继承服务器默认值）。

tool_call_sound_behaviorenum or null可选默认为 auto

设定后，覆盖服务器对此工具的 tool_call_sound_behavior 设置。

允许的值:

execution_modeenum or null可选默认为 immediate

设定后，覆盖服务器对此工具的 execution_mode 设置。

允许的值:

response_timeout_secsinteger or null可选5-300

设定后，覆盖服务器对此 MCP 工具的响应超时设置（秒）。

assignmentslist of objects可选

此 MCP 工具的动态变量赋值

input_overridesmap from strings to objects or null可选

JSON 路径到输入覆盖配置的映射

response_mockslist of objects or null可选

带可选参数条件的模拟响应。按从上到下的顺序评估，首个匹配项生效。

force_pre_tool_speechboolean or null可选Deprecated

已弃用：请改用 pre_tool_speech。设置后，将覆盖服务器对此工具的 force_pre_tool_speech 设置。

disable_interruptionsboolean or null可选Deprecated

已弃用：请改用 interruption_mode。设置后，将覆盖服务器对此工具的 disable_interruptions 设置。

错误

404

Not Found Error

422

Unprocessable Entity Error

路径参数

请求头

响应

错误