Actualizar anulación de configuración de la herramienta MCP

PATCH

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

PATCH

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

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

{
  "id": "id",
  "config": {
    "url": "url",
    "name": "name",
    "approval_policy": "auto_approve_all",
    "tool_approval_hashes": [
      {
        "tool_name": "tool_name",
        "tool_hash": "tool_hash"
      }
    ],
    "transport": "SSE",
    "secret_token": {
      "secret_id": "secret_id"
    },
    "request_headers": {
      "key": "value"
    },
    "request_meta": {
      "key": "value"
    },
    "auth_connection": {
      "auth_connection_id": "auth_connection_id"
    },
    "description": "description",
    "pre_tool_speech": "auto",
    "interruption_mode": "allow",
    "tool_call_sound": "typing",
    "tool_call_sound_behavior": "auto",
    "execution_mode": "immediate",
    "response_timeout_secs": 1,
    "tool_config_overrides": [
      {
        "tool_name": "tool_name",
        "assignments": [
          {
            "dynamic_variable": "user_name",
            "value_path": "user.name",
            "source": "response",
            "sanitize": false,
            "preserve_native_type": false
          }
        ]
      }
    ],
    "disable_compression": true
  },
  "metadata": {
    "created_at": 1,
    "owner_user_id": "owner_user_id"
  },
  "access_info": {
    "is_creator": true,
    "creator_name": "John Doe",
    "creator_email": "john.doe@example.com",
    "role": "admin",
    "anonymous_access_level_override": "admin",
    "access_source": "creator"
  },
  "dependent_agents": [
    {
      "type": "available",
      "access_level": "admin",
      "created_at_unix_secs": 1,
      "id": "id",
      "name": "name",
      "referenced_resource_ids": [
        "referenced_resource_ids"
      ]
    }
  ]
}

Actualiza las anulaciones de configuración de una herramienta MCP concreta.

Parámetros de ruta

mcp_server_idstringRequerido

ID del servidor MCP.

tool_namestringRequerido

Nombre de la herramienta MCP cuya anulación de configuración se actualizará.

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.

pre_tool_speechenumOpcionalValor predeterminado: auto

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

Valores permitidos:

interruption_modeenumOpcionalValor predeterminado: allow

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

Valores permitidos:

tool_call_soundenum or "off"Opcional

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_behaviorenumOpcionalValor predeterminado: auto

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

Valores permitidos:

execution_modeenumOpcionalValor predeterminado: immediate

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

Valores permitidos:

response_timeout_secsintegerOpcional5-300

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

assignmentslist of objectsOpcional

Asignaciones de variables dinámicas para esta herramienta MCP

input_overridesmap from strings to optional objectsOpcional

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

response_mockslist of objectsOpcional

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

force_pre_tool_speechbooleanOpcionalDeprecated

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_interruptionsbooleanOpcionalDeprecated

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_infoobjectOpcional

La información de acceso del servidor MCP.

dependent_agentslist of objectsOpcional

Lista de agentes que dependen de este servidor MCP.

Errores

404

Tool Configs Update Request Not Found Error

422

Tool Configs Update Request Unprocessable Entity Error

Parámetros de ruta

Encabezados

Parámetros de consulta

Solicitud

Respuesta

Errores