Skapa konfigurationsåsidosättning för MCP-verktyg

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

Skapa konfigurationsåsidosättningar för ett specifikt MCP-verktyg.

Sökvägsparametrar

mcp_server_idstringObligatorisk

MCP-serverns ID.

Frågeparametrar

environmentstringValfriStandard är production

Miljö vars värden används när MCP-serverns URL, rubriker eller autentiseringsanslutning refererar till miljövariabler. Motsvarar miljön som ett samtal skulle köras i; standardvärdet är produktion.

Förfrågan

This endpoint expects an object.

tool_namestringObligatorisk

Namnet på MCP-verktyget

pre_tool_speechenumValfriStandard är auto

Om angivet åsidosätter det serverns inställning pre_tool_speech för detta verktyg.

Tillåtna värden:

interruption_modeenumValfriStandard är allow

Om angivet åsidosätter det serverns inställning interruption_mode för detta verktyg.

Tillåtna värden:

tool_call_soundenum or "off"Valfri

Åsidosätter serverns inställning tool_call_sound för det här verktyget. Ett ljudnamn spelar upp det ljudet; 'off' innebär inget ljud (tystnad); null innebär att inställningen inte åsidosätts (serverns standardvärde används).

tool_call_sound_behaviorenumValfriStandard är auto

Om angivet åsidosätter det serverns inställning tool_call_sound_behavior för detta verktyg

Tillåtna värden:

execution_modeenumValfriStandard är immediate

Om angivet åsidosätter det serverns inställning execution_mode för detta verktyg

Tillåtna värden:

response_timeout_secsintegerValfri5-300

Om angivet åsidosätter det serverns svarstidsgräns för detta MCP-verktyg.

assignmentslist of objectsValfri

Tilldelningar av dynamiska variabler för detta MCP-verktyg

input_overridesmap from strings to optional objectsValfri

Mappning av JSON-sökväg till konfiguration för åsidosättning av indata

response_mockslist of objectsValfri

Mock-svar med valfria parametervillkor. Utvärderas uppifrån och ned; den första matchningen används.

force_pre_tool_speechbooleanValfriDeprecated

FÖRÅLDRAT: använd pre_tool_speech i stället. Om det är inställt åsidosätter det serverns inställning force_pre_tool_speech för det här verktyget.

disable_interruptionsbooleanValfriDeprecated

FÖRÅLDRAT: använd interruption_mode i stället. Om det är inställt åsidosätter det serverns inställning disable_interruptions för det här verktyget.

Svar

Lyckat svar

idstring

configobject

metadataobject

MCP-serverns metadata

access_infoobjectValfri

MCP-serverns åtkomstinformation

dependent_agentslist of objectsValfri

Lista över agenter som är beroende av den här MCP-servern.

Fel

409

Tool Configs Create Request Conflict Error

422

Tool Configs Create Request Unprocessable Entity Error

Sökvägsparametrar

Headers

Frågeparametrar

Förfrågan

Svar

Fel