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

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": [],
        "outcome": "success",
        "position": {
          "x": 0,
          "y": 0
        }
      },
      "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,
        "preserve_voice_settings": 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 करता है

पाथ पैरामीटर

agent_idstringआवश्यक

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

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

enable_versioning_if_not_enabledbooleanवैकल्पिकडिफ़ॉल्ट: trueDeprecated

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

branch_idstring or nullवैकल्पिक

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

include_procedure_generated_workflow_elementsbooleanवैकल्पिकडिफ़ॉल्ट: true

संरचित प्रक्रियाओं से जनरेट किए गए workflow नोड और एज शामिल करने हैं या नहीं। false होने पर workflow में सिर्फ़ लिखे गए एलिमेंट शामिल होते हैं।

अनुरोध

This endpoint expects an object.

conversation_configobjectवैकल्पिक

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

platform_settingsobjectवैकल्पिक

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

workflowobjectवैकल्पिक

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

namestring or nullवैकल्पिक

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

tagslist of strings or nullवैकल्पिक

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

version_descriptionstring or nullवैकल्पिक

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

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

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

रिस्पॉन्स

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

agent_idstring

एजेंट की ID

namestring

एजेंट का नाम

conversation_configobject

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

metadataobject

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

platform_settingsobjectवैकल्पिक

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

phone_numberslist of objectsवैकल्पिक

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

whatsapp_accountslist of objectsवैकल्पिक

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

workflowobjectवैकल्पिक

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

access_infoobject or nullवैकल्पिक

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

tagslist of stringsवैकल्पिक

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

version_idstring or nullवैकल्पिक

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

branch_idstring or nullवैकल्पिक

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

main_branch_idstring or nullवैकल्पिक

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

proceduresmap from strings to objectsवैकल्पिक

procedure_id से keyed procedures।

default_hold_audio_urlstringवैकल्पिकडिफ़ॉल्ट: https://eleven-public-cdn-common.elevenlabs.io/convai/ambient-audio-assets/elevator1.mp3

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

त्रुटियाँ

422

Unprocessable Entity Error

पाथ पैरामीटर

हेडर

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

अनुरोध

रिस्पॉन्स

त्रुटियाँ