एजेंट अपडेट करें

PATCH

/v1/convai/agents/:agent_id

PATCH

/v1/convai/agents/:agent_id

curl -X PATCH "https://api.elevenlabs.io/v1/convai/agents/agent_3701k3ttaq12ewp8b7qv5rfyszkz?branch_id=agtbranch_0901k4aafjxxfxt93gd841r7tv5t" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "agent_id": "agent_7101k5zvyjhmfg983brhmhkd98n6",
  "name": "My Agent",
  "conversation_config": {
    "asr": {
      "quality": "high",
      "provider": "scribe_realtime",
      "user_input_audio_format": "pcm_16000",
      "keywords": [
        "hello",
        "world"
      ]
    },
    "turn": {
      "turn_timeout": 7,
      "silence_end_call_timeout": -1,
      "turn_eagerness": "normal",
      "spelling_patience": "auto",
      "speculative_turn": false,
      "retranscribe_on_turn_timeout": false,
      "turn_model": "turn_v3",
      "interruption_ignore_terms": [],
      "interruption_ignore_term_languages": [],
      "merge_with_default_ignore_terms": false,
      "transcribe_on_disabled_interruptions": false,
      "soft_timeout_config": {
        "timeout_seconds": -1,
        "message": "Hhmmmm...yeah."
      },
      "mode": "turn"
    },
    "tts": {
      "model_id": "eleven_turbo_v2",
      "voice_id": "cjVigY5qzO86Huf0OWal",
      "agent_output_audio_format": "pcm_16000",
      "stability": 0.5,
      "speed": 1,
      "similarity_boost": 0.8,
      "pronunciation_dictionary_locators": [],
      "optimize_streaming_latency": 3
    },
    "conversation": {
      "max_duration_seconds": 600,
      "client_events": [
        "audio",
        "interruption"
      ]
    },
    "language_presets": {},
    "vad": {
      "background_voice_detection": false
    },
    "agent": {
      "first_message": "Hello, how can I help you today?",
      "language": "en",
      "disable_first_message_interruptions": false
    }
  },
  "metadata": {
    "created_at_unix_secs": 1,
    "updated_at_unix_secs": 1
  },
  "workflow": {
    "edges": {
      "entry_to_tool_a": {
        "source": "entry_node",
        "target": "tool_node_a",
        "forward_condition": {
          "type": "llm",
          "condition": "Tool A condition"
        }
      },
      "start_to_entry": {
        "source": "start_node",
        "target": "entry_node",
        "forward_condition": {
          "type": "unconditional"
        }
      },
      "tool_a_to_failure": {
        "source": "tool_node_a",
        "target": "failure_node",
        "forward_condition": {
          "type": "result",
          "successful": false
        }
      },
      "tool_a_to_tool_b": {
        "source": "tool_node_a",
        "target": "tool_node_b",
        "forward_condition": {
          "type": "result",
          "successful": true
        }
      },
      "tool_b_to_agent_transfer": {
        "source": "tool_node_b",
        "target": "success_transfer",
        "forward_condition": {
          "type": "unconditional"
        }
      },
      "tool_b_to_conversation": {
        "source": "tool_node_b",
        "target": "success_conversation",
        "forward_condition": {
          "type": "llm",
          "condition": "Conversation condition"
        }
      },
      "tool_b_to_end": {
        "source": "tool_node_b",
        "target": "success_end",
        "forward_condition": {
          "type": "llm",
          "condition": "End condition"
        }
      },
      "tool_b_to_phone": {
        "source": "tool_node_b",
        "target": "success_phone",
        "forward_condition": {
          "type": "expression",
          "expression": {
            "type": "or_operator",
            "children": [
              {
                "type": "dynamic_variable",
                "name": "force_phone_transfer"
              },
              {
                "type": "llm",
                "value_schema": {
                  "type": "boolean",
                  "description": "Phone condition"
                },
                "prompt": "Phone condition"
              },
              {
                "type": "eq_operator",
                "left": {
                  "type": "dynamic_variable",
                  "name": "mode"
                },
                "right": {
                  "type": "string_literal",
                  "value": "dev"
                }
              }
            ]
          }
        }
      }
    },
    "nodes": {
      "entry_node": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [
          "entry_to_tool_a"
        ],
        "entry_behavior": "auto",
        "label": "Entry",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "failure_node": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [],
        "entry_behavior": "auto",
        "label": "Failure",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "start_node": {
        "type": "start",
        "edge_order": [
          "start_to_entry"
        ],
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "success_conversation": {
        "type": "override_agent",
        "additional_knowledge_base": [],
        "additional_prompt": "",
        "additional_tool_ids": [],
        "conversation_config": {},
        "edge_order": [],
        "entry_behavior": "auto",
        "label": "Success A",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "success_end": {
        "type": "end",
        "edge_order": [],
        "position": {
          "x": 0,
          "y": 0
        },
        "return_when_nested": true
      },
      "success_phone": {
        "type": "phone_number",
        "custom_sip_headers": [],
        "edge_order": [],
        "position": {
          "x": 0,
          "y": 0
        },
        "sip_refer_play_dialtone": true,
        "transfer_destination": {
          "type": "phone",
          "phone_number": "+1234567890"
        },
        "transfer_type": "conference",
        "require_acceptance": false
      },
      "success_transfer": {
        "type": "standalone_agent",
        "agent_id": "success_transfer_agent",
        "delay_ms": 0,
        "edge_order": [],
        "enable_transferred_agent_first_message": false,
        "position": {
          "x": 0,
          "y": 0
        },
        "preserve_client_tts_overrides": false,
        "drop_history": false,
        "isolate_history": false
      },
      "tool_node_a": {
        "type": "tool",
        "edge_order": [
          "tool_a_to_failure",
          "tool_a_to_tool_b"
        ],
        "position": {
          "x": 0,
          "y": 0
        },
        "tools": [
          {
            "tool_id": "tool_a"
          },
          {
            "tool_id": "tool_b"
          }
        ]
      },
      "tool_node_b": {
        "type": "tool",
        "edge_order": [
          "tool_b_to_conversation",
          "tool_b_to_end",
          "tool_b_to_phone",
          "tool_b_to_agent_transfer"
        ],
        "position": {
          "x": 0,
          "y": 0
        },
        "tools": [
          {
            "tool_id": "tool_a"
          }
        ]
      }
    },
    "prevent_subagent_loops": false,
    "subgraphs": {}
  }
}

Agent settings को patch करता है

Path parameters

agent_idstringRequired

एजेंट की id। यह एजेंट बनाते समय लौटाई जाती है।

Query parameters

enable_versioning_if_not_enabledbooleanOptionalDefaults to trueDeprecated

डीप्रिकेटेड: सभी एजेंट वर्ज़न किए गए हैं। यह पैरामीटर अनदेखा किया जाता है।

branch_idstring or nullOptional

उपयोग करने के लिए ब्रांच की ID

Request

This endpoint expects an object.

conversation_configobjectOptional

एजेंट के लिए बातचीत कॉन्फ़िगरेशन

platform_settingsobjectOptional

एजेंट की platform settings वे सभी settings हैं जो conversation orchestration और content से संबंधित नहीं हैं।

workflowobjectOptional

एजेंट के लिए वर्कफ़्लो। इसका इस्तेमाल कन्वर्सेशन का फ़्लो और एजेंट के टूल्स के साथ इंटरैक्ट करने का तरीका तय करने के लिए होता है।

namestring or nullOptional

एजेंट को आसानी से खोजने के लिए एक नाम

tagslist of strings or nullOptional

एजेंट को वर्गीकृत और फ़िल्टर करने में मदद करने वाले टैग्स

version_descriptionstring or nullOptional

बदलाव प्रकाशित करते समय इस वर्शन का विवरण (केवल वर्शन वाले एजेंट्स पर लागू)

proceduresmap from strings to objects or nullOptional

publish करने के लिए procedure versions, जो procedure_id से keyed हैं। दिए जाने पर, यह map मौजूदा draft या branch tip के procedures को बदल देता है। छोड़े जाने या null होने पर, उपलब्ध होने पर unpublished procedure edits उपयोग किए जाते हैं; अन्यथा branch tip के procedures रखे जाते हैं। सभी procedures हटाने के लिए एक खाली object पास करें।

Response

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

agent_idstring

एजेंट की ID

namestring

एजेंट का नाम

conversation_configobject

एजेंट का बातचीत कॉन्फ़िगरेशन

metadataobject

एजेंट का मेटाडेटा

platform_settingsobjectOptional

एजेंट की प्लेटफ़ॉर्म सेटिंग्स

phone_numberslist of objectsOptional

एजेंट के फ़ोन नंबर

whatsapp_accountslist of objectsOptional

एजेंट को असाइन किए गए WhatsApp अकाउंट्स

workflowobjectOptional

एजेंट का वर्कफ़्लो

access_infoobject or nullOptional

यूज़र के लिए एजेंट की एक्सेस जानकारी

tagslist of stringsOptional

एजेंट को श्रेणियों में बाँटने के लिए इस्तेमाल होने वाले टैग

version_idstring or nullOptional

एजेंट जिस वर्शन पर है उसका ID

branch_idstring or nullOptional

उस ब्रांच की ID जिस पर एजेंट है

main_branch_idstring or nullOptional

इस एजेंट की मुख्य ब्रांच की ID

proceduresmap from strings to objectsOptional

procedure_id से keyed procedures।

default_hold_audio_urlstringOptionalDefaults to https://eleven-public-cdn-common.elevenlabs.io/convai/ambient-audio-assets/elevator1.mp3

जब कोई कस्टम hold audio अपलोड नहीं किया जाता, तो कतार में मौजूद कॉलर्स के लिए बजने वाले डिफ़ॉल्ट hold tone का URL, ताकि डैशबोर्ड उसका प्रीव्यू दिखा सके।

Errors

422

Unprocessable Entity Error

Path parameters

Headers

Query parameters

Request

Response

Errors