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

किसी खास 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 or nullवैकल्पिकडिफ़ॉल्ट: auto

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

अनुमत मान:

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

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

अनुमत मान:

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

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

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

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

अनुमत मान:

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

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

अनुमत मान:

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

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

assignmentslist of objects or nullवैकल्पिक

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

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

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

response_mockslist of objects or nullवैकल्पिक

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

force_pre_tool_speechboolean or nullवैकल्पिकDeprecated

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

disable_interruptionsboolean or nullवैकल्पिकDeprecated

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

रिस्पॉन्स

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

idstring

configobject

metadataobject

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

access_infoobject or nullवैकल्पिक

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

dependent_agentslist of objectsवैकल्पिक

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

त्रुटियाँ

409

Conflict Error

422

Unprocessable Entity Error

पाथ पैरामीटर

हेडर

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

अनुरोध

रिस्पॉन्स

त्रुटियाँ