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

किसी खास MCP टूल के लिए कॉन्फ़िगरेशन ओवरराइड बनाएं।

पाथ पैरामीटर

mcp_server_idstringआवश्यक

MCP सर्वर की ID।

क्वेरी पैरामीटर

environmentstringवैकल्पिकडिफ़ॉल्ट: production

वह environment जिसकी वैल्यू तब इस्तेमाल होती हैं, जब MCP सर्वर URL, headers या auth connection environment variables को रेफ़र करते हैं। यह उस environment जैसा होता है जिसमें बातचीत चलती; डिफ़ॉल्ट रूप से production है।

अनुरोध

This endpoint expects an object.

tool_namestringआवश्यक

MCP टूल का नाम

pre_tool_speechenumवैकल्पिकडिफ़ॉल्ट: auto

सेट होने पर, इस टूल के लिए सर्वर की pre_tool_speech सेटिंग को ओवरराइड करता है।

अनुमत मान:

interruption_modeenumवैकल्पिकडिफ़ॉल्ट: allow

सेट होने पर, इस टूल के लिए सर्वर की interruption_mode सेटिंग को ओवरराइड करता है।

अनुमत मान:

tool_call_soundenum or "off"वैकल्पिक

इस tool के लिए server की tool_call_sound setting को override करता है। sound name उस sound को चलाता है; ‘off’ का मतलब कोई sound नहीं (silence); null का मतलब override न करें (server default अपनाएं)।

tool_call_sound_behaviorenumवैकल्पिकडिफ़ॉल्ट: auto

सेट होने पर, इस टूल के लिए सर्वर की tool_call_sound_behavior सेटिंग को ओवरराइड करता है

अनुमत मान:

execution_modeenumवैकल्पिकडिफ़ॉल्ट: immediate

सेट होने पर, इस टूल के लिए सर्वर की execution_mode सेटिंग को ओवरराइड करता है

अनुमत मान:

response_timeout_secsintegerवैकल्पिक5-300

सेट होने पर, इस MCP टूल के लिए सर्वर के रिस्पॉन्स टाइमआउट को ओवरराइड करता है।

assignmentslist of objectsवैकल्पिक

इस MCP टूल के लिए डायनामिक वेरिएबल असाइनमेंट

input_overridesmap from strings to optional objectsवैकल्पिक

json पाथ और इनपुट ओवरराइड कॉन्फ़िगरेशन की मैपिंग

response_mockslist of objectsवैकल्पिक

वैकल्पिक पैरामीटर शर्तों वाले मॉक जवाब। ऊपर से नीचे तक मूल्यांकन होता है; पहला मैच चुना जाता है।

force_pre_tool_speechbooleanवैकल्पिकDeprecated

डीप्रिकेटेड: इसके बजाय pre_tool_speech इस्तेमाल करें। सेट होने पर यह इस टूल के लिए सर्वर की force_pre_tool_speech सेटिंग को ओवरराइड करता है।

disable_interruptionsbooleanवैकल्पिकDeprecated

डीप्रिकेटेड: इसके बजाय interruption_mode इस्तेमाल करें। सेट होने पर यह इस टूल के लिए सर्वर की disable_interruptions सेटिंग को ओवरराइड करता है।

रिस्पॉन्स

सफल रिस्पॉन्स

idstring

configobject

metadataobject

MCP सर्वर का मेटाडेटा

access_infoobjectवैकल्पिक

MCP सर्वर की एक्सेस जानकारी

dependent_agentslist of objectsवैकल्पिक

इस MCP Server पर निर्भर एजेंट की सूची।

त्रुटियाँ

409

Tool Configs Create Request Conflict Error

422

Tool Configs Create Request Unprocessable Entity Error

पाथ पैरामीटर

हेडर

क्वेरी पैरामीटर

अनुरोध

रिस्पॉन्स

त्रुटियाँ