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

경로 매개변수

헤더

응답

오류