Créer une substitution de configuration d’outil 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"
      ]
    }
  ]
}

Crée des remplacements de configuration pour un outil MCP spécifique.

Paramètres de chemin

mcp_server_idstringRequis

ID du serveur MCP.

Paramètres de requête

environmentstringOptionnelPar défaut production

Environnement dont les valeurs sont utilisées lorsque l’URL du serveur MCP, les en-têtes ou la connexion d’authentification font référence à des variables d’environnement. Reflète l’environnement dans lequel une conversation s’exécuterait ; production par défaut.

Requête

This endpoint expects an object.

tool_namestringRequis

Le nom de l’outil MCP

pre_tool_speechenum or nullOptionnelPar défaut auto

Si défini, remplace le paramètre pre_tool_speech du serveur pour cet outil.

Valeurs autorisées:

interruption_modeenum or nullOptionnelPar défaut allow

Si défini, remplace le paramètre interruption_mode du serveur pour cet outil.

Valeurs autorisées:

tool_call_soundenum or "off" or nullOptionnel

Remplace le paramètre tool_call_sound du serveur pour cet outil. Un nom de son joue ce son ; ‘off’ remplace ce réglage par l’absence de son, c’est-à-dire le silence ; null signifie qu’aucun remplacement n’est appliqué et que la valeur par défaut du serveur est héritée.

tool_call_sound_behaviorenum or nullOptionnelPar défaut auto

Si défini, remplace le paramètre tool_call_sound_behavior du serveur pour cet outil.

Valeurs autorisées:

execution_modeenum or nullOptionnelPar défaut immediate

Si défini, remplace le paramètre execution_mode du serveur pour cet outil.

Valeurs autorisées:

response_timeout_secsinteger or nullOptionnel5-300

Si défini, remplace le délai d’expiration de réponse du serveur pour cet outil MCP.

assignmentslist of objects or nullOptionnel

Affectations de variables dynamiques pour cet outil MCP

input_overridesmap from strings to objects or nullOptionnel

Mappage du chemin JSON vers la configuration de remplacement de l’entrée

response_mockslist of objects or nullOptionnel

Réponses simulées avec conditions facultatives sur les paramètres. Évaluées de haut en bas, la première correspondance est retenue.

force_pre_tool_speechboolean or nullOptionnelDeprecated

OBSOLÈTE : utilisez plutôt pre_tool_speech. S’il est défini, remplace le paramètre force_pre_tool_speech du serveur pour cet outil.

disable_interruptionsboolean or nullOptionnelDeprecated

OBSOLÈTE : utilisez plutôt interruption_mode. S’il est défini, remplace le paramètre disable_interruptions du serveur pour cet outil.

Réponse

Réponse réussie

idstring

configobject

metadataobject

Les métadonnées du serveur MCP

access_infoobject or nullOptionnel

Informations d’accès du serveur MCP

dependent_agentslist of objectsOptionnel

Liste des agents qui dépendent de ce serveur MCP.

Erreurs

409

Conflict Error

422

Unprocessable Entity Error

Paramètres de chemin

En-têtes

Paramètres de requête

Requête

Réponse

Erreurs