MCP-Tool-Konfigurationsüberschreibung aktualisieren

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

Aktualisiert Konfigurationsüberschreibungen für ein bestimmtes MCP-Tool.

Pfadparameter

mcp_server_idstringErforderlich

ID des MCP-Servers.

tool_namestringErforderlich

Name des MCP-Tools, für das Konfigurationsüberschreibungen aktualisiert werden sollen.

Abfrageparameter

environmentstringOptionalStandardwert ist production

Umgebung, deren Werte verwendet werden, wenn die MCP-Server-URL, Header oder Auth-Verbindung auf Umgebungsvariablen verweisen. Entspricht der Umgebung, in der ein Gespräch ausgeführt würde; standardmäßig production.

Anfrage

This endpoint expects an object.

pre_tool_speechenumOptionalStandardwert ist auto

Falls gesetzt, überschreibt dies die serverseitige Einstellung pre_tool_speech für dieses Tool.

Erlaubte Werte:

interruption_modeenumOptionalStandardwert ist allow

Falls gesetzt, überschreibt dies die serverseitige Einstellung interruption_mode für dieses Tool.

Erlaubte Werte:

tool_call_soundenum or "off"Optional

Überschreibt die tool_call_sound-Einstellung des Servers für dieses Tool. Ein Soundname spielt diesen Sound ab; ‘off’ überschreibt mit keinem Sound (Stille); null bedeutet nicht überschreiben (Serverstandard übernehmen).

tool_call_sound_behaviorenumOptionalStandardwert ist auto

Falls gesetzt, überschreibt dies die serverseitige Einstellung tool_call_sound_behavior für dieses Tool.

Erlaubte Werte:

execution_modeenumOptionalStandardwert ist immediate

Falls gesetzt, überschreibt dies die serverseitige Einstellung execution_mode für dieses Tool.

Erlaubte Werte:

response_timeout_secsintegerOptional5-300

Falls gesetzt, überschreibt dies das serverseitige Antwort-Timeout für dieses MCP-Tool.

assignmentslist of objectsOptional

Zuweisungen dynamischer Variablen für dieses MCP-Tool

input_overridesmap from strings to optional objectsOptional

Zuordnung von JSON-Pfaden zu Konfigurationen für Eingabeüberschreibungen

response_mockslist of objectsOptional

Mock-Antworten mit optionalen Parameterbedingungen. Sie werden von oben nach unten ausgewertet; der erste Treffer gewinnt.

force_pre_tool_speechbooleanOptionalDeprecated

VERALTET: Verwenden Sie stattdessen pre_tool_speech. Wenn festgelegt, überschreibt dies die Einstellung force_pre_tool_speech des Servers für dieses Tool.

disable_interruptionsbooleanOptionalDeprecated

VERALTET: Verwenden Sie stattdessen interruption_mode. Wenn festgelegt, überschreibt dies die Einstellung disable_interruptions des Servers für dieses Tool.

Antwort

Erfolgreiche Antwort

idstring

configobject

metadataobject

Die Metadaten des MCP-Servers

access_infoobjectOptional

Die Zugriffsinformationen des MCP-Servers

dependent_agentslist of objectsOptional

Liste der Agenten, die von diesem MCP-Server abhängen.

Fehler

404

Tool Configs Update Request Not Found Error

422

Tool Configs Update Request Unprocessable Entity Error