Crear anulación de configuración de herramienta MCP

POST

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

POST

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

curl -X POST https://api.elevenlabs.io/v1/convai/mcp-servers/mcp_server_id/tool-configs \
     -H "Content-Type: application/json" \
     -d '{
  "tool_name": "string"
}'

{
  "id": "string",
  "config": {
    "url": "string",
    "name": "string",
    "approval_policy": "require_approval_all",
    "tool_approval_hashes": [
      {
        "tool_name": "string",
        "tool_hash": "string",
        "approval_policy": "requires_approval"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "string"
    },
    "request_headers": {},
    "request_meta": {},
    "auth_connection": {
      "auth_connection_id": "string"
    },
    "description": "",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 30,
    "tool_config_overrides": [
      {
        "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
      }
    ],
    "disable_compression": false,
    "force_pre_tool_speech": false,
    "disable_interruptions": false
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "string"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "string",
      "name": "string",
      "referenced_resource_ids": [
        "string"
      ]
    }
  ]
}

Crea anulaciones de configuración para una herramienta MCP específica.

Parámetros de ruta

mcp_server_idstringRequerido

ID del servidor MCP.

Parámetros de consulta

environmentstringOpcionalValor predeterminado: production

Entorno cuyos valores se usan cuando la URL, las cabeceras o la conexión de autenticación del servidor MCP hacen referencia a variables de entorno. Refleja el entorno en el que se ejecutaría una conversación; el valor predeterminado es producción.

Solicitud

This endpoint expects an object.

tool_namestringRequerido

El nombre de la herramienta MCP

pre_tool_speechenum or nullOpcionalValor predeterminado: auto

Si se establece, anula la configuración pre_tool_speech del servidor para esta herramienta.

Valores permitidos:

interruption_modeenum or nullOpcionalValor predeterminado: allow

Si se establece, anula la configuración interruption_mode del servidor para esta herramienta.

Valores permitidos:

tool_call_soundenum or "off" or nullOpcional

Anula la configuración tool_call_sound del servidor para esta herramienta. Un nombre de sonido reproduce ese sonido; ‘off’ anula el sonido por silencio; null significa no anularla (heredar el valor predeterminado del servidor).

tool_call_sound_behaviorenum or nullOpcionalValor predeterminado: auto

Si se establece, anula la configuración tool_call_sound_behavior del servidor para esta herramienta.

Valores permitidos:

execution_modeenum or nullOpcionalValor predeterminado: immediate

Si se establece, anula la configuración execution_mode del servidor para esta herramienta.

Valores permitidos:

response_timeout_secsinteger or nullOpcional5-300

Si se establece, anula el tiempo de espera de respuesta del servidor para esta herramienta MCP.

assignmentslist of objects or nullOpcional

Asignaciones de variables dinámicas para esta herramienta MCP

input_overridesmap from strings to objects or nullOpcional

Asignación de ruta JSON a configuración de anulación de entrada

response_mockslist of objects or nullOpcional

Respuestas simuladas con condiciones de parámetros opcionales. Se evalúan de arriba abajo; prevalece la primera coincidencia.

force_pre_tool_speechboolean or nullOpcionalDeprecated

OBSOLETO: usa pre_tool_speech en su lugar. Si se establece, sustituye la configuración force_pre_tool_speech del servidor para esta herramienta.

disable_interruptionsboolean or nullOpcionalDeprecated

OBSOLETO: usa interruption_mode en su lugar. Si se establece, sustituye la configuración disable_interruptions del servidor para esta herramienta.

Respuesta

Respuesta correcta.

idstring

configobject

metadataobject

Los metadatos del servidor MCP

access_infoobject or nullOpcional

La información de acceso del servidor MCP.

dependent_agentslist of objectsOpcional

Lista de agentes que dependen de este servidor MCP.

Errores

409

Conflict Error

422

Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Solicitud

Respuesta

Errores