Aggiorna override della configurazione dello strumento 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 \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "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"
      ]
    }
  ]
}

Aggiorna le sostituzioni della configurazione per uno specifico tool MCP.

Parametri di percorso

mcp_server_idstringObbligatorio

ID del server MCP.

tool_namestringObbligatorio

Nome dello strumento MCP per cui aggiornare le sostituzioni della configurazione.

Parametri di query

environmentstringOpzionalePredefinito a production

Ambiente i cui valori vengono usati quando l'URL del server MCP, gli header o la connessione di autenticazione fanno riferimento a variabili di ambiente. Rispecchia l'ambiente in cui verrebbe eseguita una conversazione; per impostazione predefinita è production.

Richiesta

This endpoint expects an object.

pre_tool_speechenum or nullOpzionalePredefinito a auto

Se impostato, sostituisce l'impostazione pre_tool_speech del server per questo strumento.

Valori consentiti:

interruption_modeenum or nullOpzionalePredefinito a allow

Se impostato, sostituisce l'impostazione interruption_mode del server per questo strumento.

Valori consentiti:

tool_call_soundenum or "off" or nullOpzionale

Sostituisce l'impostazione tool_call_sound del server per questo strumento. Un nome di suono riproduce il suono corrispondente; 'off' imposta l'assenza di suono (silenzio); null indica di non sostituire l'impostazione (viene ereditato il valore predefinito del server).

tool_call_sound_behaviorenum or nullOpzionalePredefinito a auto

Se impostato, sostituisce l'impostazione tool_call_sound_behavior del server per questo strumento.

Valori consentiti:

execution_modeenum or nullOpzionalePredefinito a immediate

Se impostato, sostituisce l'impostazione execution_mode del server per questo strumento.

Valori consentiti:

response_timeout_secsinteger or nullOpzionale5-300

Se impostato, sostituisce il timeout di risposta del server per questo strumento MCP.

assignmentslist of objects or nullOpzionale

Assegnazioni di variabili dinamiche per questo strumento MCP

input_overridesmap from strings to objects or nullOpzionale

Mappatura del path JSON alla configurazione di override dell'input

response_mockslist of objects or nullOpzionale

Risposte mock con condizioni opzionali sui parametri. Vengono valutate dall'alto verso il basso; viene scelta la prima corrispondenza.

force_pre_tool_speechboolean or nullOpzionaleDeprecated

DEPRECATO: usa invece pre_tool_speech. Se impostato, sostituisce l'impostazione force_pre_tool_speech del server per questo strumento.

disable_interruptionsboolean or nullOpzionaleDeprecated

DEPRECATO: usa invece interruption_mode. Se impostato, sostituisce l'impostazione disable_interruptions del server per questo strumento.

Risposta

Risposta riuscita

idstring

configobject

metadataobject

I metadati del server MCP

access_infoobject or nullOpzionale

Le informazioni di accesso del server MCP

dependent_agentslist of objectsOpzionale

Elenco degli agenti che dipendono da questo server MCP.

Errori

404

Not Found Error

422

Unprocessable Entity Error

Parametri di percorso

Header

Parametri di query

Richiesta

Risposta

Errori