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

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

Crea override di configurazione per uno specifico strumento MCP.

Parametri di percorso

mcp_server_idstringObbligatorio

ID del server MCP.

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.

tool_namestringObbligatorio

Il nome dello strumento MCP

pre_tool_speechenumOpzionalePredefinito a auto

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

Valori consentiti:

interruption_modeenumOpzionalePredefinito a allow

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

Valori consentiti:

tool_call_soundenum or "off"Opzionale

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_behaviorenumOpzionalePredefinito a auto

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

Valori consentiti:

execution_modeenumOpzionalePredefinito a immediate

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

Valori consentiti:

response_timeout_secsintegerOpzionale5-300

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

assignmentslist of objectsOpzionale

Assegnazioni di variabili dinamiche per questo strumento MCP

input_overridesmap from strings to optional objectsOpzionale

Mappatura del path JSON alla configurazione di override dell'input

response_mockslist of objectsOpzionale

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

force_pre_tool_speechbooleanOpzionaleDeprecated

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

disable_interruptionsbooleanOpzionaleDeprecated

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_infoobjectOpzionale

Le informazioni di accesso del server MCP

dependent_agentslist of objectsOpzionale

Elenco degli agenti che dipendono da questo server MCP.

Errori

409

Tool Configs Create Request Conflict Error

422

Tool Configs Create Request Unprocessable Entity Error

Parametri di percorso

Header

Parametri di query

Richiesta

Risposta

Errori