Atualizar substituição de configuração da ferramenta 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"
      ]
    }
  ]
}

Atualiza as substituições de configuração de uma ferramenta MCP específica.

Parâmetros de caminho

mcp_server_idstringObrigatório

ID do servidor MCP.

tool_namestringObrigatório

Nome da ferramenta MCP para a qual atualizar as substituições de configuração.

Parâmetros de consulta

environmentstringOpcionalPadrão é production

Ambiente cujos valores são usados quando a URL do servidor MCP, os cabeçalhos ou a conexão de autenticação fazem referência a variáveis de ambiente. Corresponde ao ambiente em que uma conversa seria executada; o padrão é production.

Solicitação

This endpoint expects an object.

pre_tool_speechenumOpcionalPadrão é auto

Se definido, substitui a configuração pre_tool_speech do servidor para esta ferramenta.

Valores permitidos:

interruption_modeenumOpcionalPadrão é allow

Se definido, substitui a configuração interruption_mode do servidor para esta ferramenta.

Valores permitidos:

tool_call_soundenum or "off"Opcional

Substitui a configuração tool_call_sound do servidor para esta ferramenta. Um nome de som reproduz esse som; ‘off’ substitui por nenhum som (silêncio); null significa não substituir (herdar o padrão do servidor).

tool_call_sound_behaviorenumOpcionalPadrão é auto

Se definido, substitui a configuração tool_call_sound_behavior do servidor para esta ferramenta.

Valores permitidos:

execution_modeenumOpcionalPadrão é immediate

Se definido, substitui a configuração execution_mode do servidor para esta ferramenta.

Valores permitidos:

response_timeout_secsintegerOpcional5-300

Se definido, substitui o tempo limite de resposta do servidor para esta ferramenta MCP.

assignmentslist of objectsOpcional

Atribuições de variáveis dinâmicas para esta ferramenta MCP

input_overridesmap from strings to optional objectsOpcional

Mapeamento do caminho JSON para a configuração de substituição de entrada

response_mockslist of objectsOpcional

Respostas simuladas com condições de parâmetros opcionais. Avaliadas de cima para baixo; a primeira correspondência prevalece.

force_pre_tool_speechbooleanOpcionalDeprecated

DESCONTINUADO: use pre_tool_speech. Se definido, substitui a configuração force_pre_tool_speech do servidor para esta ferramenta.

disable_interruptionsbooleanOpcionalDeprecated

DESCONTINUADO: use interruption_mode. Se definido, substitui a configuração disable_interruptions do servidor para esta ferramenta.

Resposta

Resposta bem-sucedida

idstring

configobject

metadataobject

Os metadados do servidor MCP

access_infoobjectOpcional

As informações de acesso do servidor MCP

dependent_agentslist of objectsOpcional

Lista de agentes que dependem deste servidor MCP.

Erros

404

Tool Configs Update Request Not Found Error

422

Tool Configs Update Request Unprocessable Entity Error

Parâmetros de caminho

Cabeçalhos

Parâmetros de consulta

Solicitação

Resposta

Erros