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": "tool_name",
  "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": "user_name",
      "value_path": "user.name",
      "source": "response",
      "sanitize": false,
      "preserve_native_type": false
    }
  ],
  "input_overrides": {
    "key": {
      "source": "constant",
      "constant_value": "constant_value"
    }
  },
  "response_mocks": [
    {
      "mock_result": "mock_result",
      "parameter_conditions": [
        {
          "eval": {
            "type": "anything"
          },
          "path": "path"
        }
      ],
      "is_error": true
    }
  ],
  "force_pre_tool_speech": true,
  "disable_interruptions": true
}

特定のMCPツールの設定オーバーライドを取得します。

パスパラメータ

mcp_server_idstring必須

MCPサーバーのID。

tool_namestring必須

設定オーバーライドを取得するMCPツールの名前。

レスポンス

成功レスポンス。

tool_namestring

MCPツールの名前。

pre_tool_speechenumオプションデフォルト値 auto

設定すると、このツールのサーバー側pre_tool_speech設定を上書きします。

許可された値:

interruption_modeenumオプションデフォルト値 allow

設定すると、このツールのサーバー側interruption_mode設定を上書きします。

許可された値:

tool_call_soundenum or "off"オプション

このツールのサーバー側tool_call_sound設定をオーバーライドします。サウンド名を指定するとそのサウンドを再生し、‘off’を指定すると無音にオーバーライドします。nullはオーバーライドしないこと（サーバーのデフォルトを継承）を意味します。

tool_call_sound_behaviorenumオプションデフォルト値 auto

設定すると、このツールのサーバー側tool_call_sound_behavior設定を上書きします

許可された値:

execution_modeenumオプションデフォルト値 immediate

設定すると、このツールのサーバー側execution_mode設定を上書きします

許可された値:

response_timeout_secsintegerオプション5-300

設定すると、このMCPツールのサーバー側応答タイムアウト（秒）を上書きします。

assignmentslist of objectsオプション

このMCPツールの動的変数の割り当て

input_overridesmap from strings to optional objectsオプション

jsonパスから入力オーバーライド設定へのマッピング

response_mockslist of objectsオプション

オプションのパラメータ条件を持つモック応答。上から順に評価され、最初に一致したものが使用されます。

force_pre_tool_speechbooleanオプションDeprecated

非推奨：代わりにpre_tool_speechを使用してください。設定すると、このツールに対するサーバーのforce_pre_tool_speech設定を上書きします。

disable_interruptionsbooleanオプションDeprecated

非推奨：代わりにinterruption_modeを使用してください。設定すると、このツールに対するサーバーのdisable_interruptions設定を上書きします。

エラー

404

Tool Configs Get Request Not Found Error

422

Tool Configs Get Request Unprocessable Entity Error

パスパラメータ

ヘッダー

レスポンス

エラー