डायनामिक वेरिएबल्स

डायनामिक वेरिएबल्स आपको अपने एजेंट के संदेशों, सिस्टम प्रॉम्प्ट और टूल्स में रनटाइम वैल्यू शामिल करने देते हैं। इससे आप कई एजेंट बनाए बिना, हर बातचीत को यूज़र के हिसाब से डेटा के साथ वैयक्तिकृत कर सकते हैं।

ओवरव्यू

डायनामिक वेरिएबल्स को आपके एजेंट के कई हिस्सों में इंटीग्रेट किया जा सकता है:

• व्यवहार और संदर्भ को कस्टमाइज़ करने के लिए सिस्टम प्रॉम्प्ट्स
• अभिवादन को वैयक्तिकृत करने के लिए पहले संदेश
• यूज़र-विशिष्ट डेटा पास करने के लिए टूल पैरामीटर और हेडर्स

डायनामिक वेरिएबल्स इन स्थितियों में उपयोगी होते हैं:

• यूज़र नामों के साथ अभिवादन को वैयक्तिकृत करना
• जवाबों में अकाउंट की जानकारी शामिल करना
• टूल कॉल्स को डेटा पास करना
• सब्सक्रिप्शन टियर के आधार पर व्यवहार को कस्टमाइज़ करना
• बातचीत ID या कॉल अवधि जैसी सिस्टम जानकारी एक्सेस करना

डायनामिक वेरिएबल्स तीन तरह की वैल्यू सपोर्ट करते हैं:

सिस्टम डायनामिक वेरिएबल्स

आपके एजेंट के पास हर बातचीत में बिना रनटाइम कॉन्फ़िगरेशन के बिल्ट-इन system__* वेरिएबल्स का एक्सेस होता है। इन वेरिएबल्स के आगे आरक्षित system__ नेमस्पेस लगा होता है और बातचीत आगे बढ़ने के साथ ये अपने-आप अपडेट होते हैं। कस्टम डायनामिक वेरिएबल्स system__ प्रीफ़िक्स का इस्तेमाल नहीं कर सकते या सिस्टम वेरिएबल्स को ओवरराइड नहीं कर सकते।

† से चिह्नित वेरिएबल्स टर्न के बीच बदलते हैं। इन्हें प्रॉम्प्ट टेक्स्ट में रखने से प्रॉम्प्ट कैशिंग रुक सकती है; विकल्पों के लिए सर्वोत्तम तरीके देखें।

एजेंट और बातचीत की पहचान

समय और टाइमज़ोन

टेलीफ़ोनी और मैसेजिंग

ये वेरिएबल्स टेलीफ़ोनी और मैसेजिंग चैनलों के लिए लागू होने पर भरे जाते हैं:

हर टर्न की बातचीत स्थिति

बातचीत इतिहास फ़ॉर्मैट

system__conversation_history वेरिएबल में इस संरचना वाला एक JSON ऑब्जेक्ट होता है:

{
  "x-elevenlabs-history": true,
  "entries": [
    { "role": "user", "message": "Hello" },
    { "role": "agent", "message": "Hi, how can I help?" },
    {
      "role": "agent",
      "tool_requests": [{ "tool_name": "lookup_order", "params_as_json": { "order_id": "123" } }]
    },
    {
      "role": "tool",
      "tool_results": [{ "tool_name": "lookup_order", "result_value": "{\"status\": \"shipped\"}" }]
    }
  ]
}

हर एंट्री में एक role ("user", "agent", या "tool") और इनमें से एक होता है:

• message: टर्न की टेक्स्ट सामग्री
• tool_requests: एजेंट द्वारा किए गए टूल कॉल्स का एक ऐरे, जिसमें रिज़ॉल्व किए गए पैरामीटर वैल्यू होते हैं
• tool_results: टूल रिस्पॉन्स का एक ऐरे

अगर किसी टूल रिज़ल्ट या पैरामीटर में नेस्टेड बातचीत इतिहास है, तो अनबाउंडेड रिकर्सिव विस्तार से बचने के लिए उसे प्लेसहोल्डर (जैसे [conversation_history (5 turns)]) से रिडैक्ट कर दिया जाता है।

यह वेरिएबल टूल्स (जैसे वेबहुक या कस्टम LLMs) को बातचीत का संदर्भ पास करने या हैंडऑफ़ के दौरान सब-एजेंट प्रॉम्प्ट्स में बातचीत इतिहास शामिल करने के लिए उपयोगी है।

सीक्रेट डायनामिक वेरिएबल्स

सीक्रेट डायनामिक वेरिएबल्स सामान्य डायनामिक वेरिएबल्स की तरह ही भरे जाते हैं, लेकिन ये ElevenAgents को बताते हैं कि इनका उपयोग केवल डायनामिक वेरिएबल हेडर्स में किया जाना चाहिए और एजेंट के सिस्टम प्रॉम्प्ट या पहले संदेश के हिस्से के रूप में कभी किसी LLM प्रोवाइडर को नहीं भेजा जाना चाहिए।

ऐसे ऑथ टोकन या निजी IDs के लिए सीक्रेट डायनामिक वेरिएबल्स इस्तेमाल करें जिन्हें LLM को नहीं भेजना चाहिए। सीक्रेट डायनामिक वेरिएबल बनाने के लिए, डायनामिक वेरिएबल के आगे secret__ लगाएं।

टूल्स से डायनामिक वेरिएबल्स अपडेट करना

अगर टूल कॉल्स एक वैध JSON ऑब्जेक्ट लौटाते हैं, तो वे डायनामिक वेरिएबल्स बना या अपडेट कर सकते हैं। क्या एक्सट्रैक्ट किया जाना चाहिए, यह तय करने के लिए डॉट नोटेशन से ऑब्जेक्ट पाथ सेट करें। अगर फ़ील्ड या पाथ मौजूद नहीं है, तो कुछ भी अपडेट नहीं होगा।

रिस्पॉन्स ऑब्जेक्ट और डॉट नोटेशन का उदाहरण:

• स्टेटस इस पाथ से संबंधित है: response.status
• users ऐरे में पहले यूज़र का ईमेल इस पाथ से संबंधित है: response.users.0.email

{
  "response": {
    "status": 200,
    "message": "Successfully found 5 users",
    "users": [
      "user_1": {
        "user_name": "test_user_1",
        "email": "test_user_1@email.com"
      }
    ]
  }
}

डायनामिक वेरिएबल को पहले यूज़र के ईमेल से अपडेट करने के लिए, असाइनमेंट इस तरह सेट करें।

असाइनमेंट हर वेबहुक टूल पर कॉन्फ़िगर किए जाते हैं; API रेफरेंस में टूल असाइनमेंट्स देखें।

गाइड

ज़रूरी शर्तें:

• एक ElevenLabs अकाउंट
• कॉन्फ़िगर किया हुआ ElevenAgents एजेंट (इसे बनाने के लिए क्विकस्टार्ट देखें)

import os
import signal
from elevenlabs.client import ElevenLabs
from elevenlabs.conversational_ai.conversation import Conversation, ConversationInitiationData
from elevenlabs.conversational_ai.default_audio_interface import DefaultAudioInterface
agent_id = os.getenv("AGENT_ID")
api_key = os.getenv("ELEVENLABS_API_KEY")
elevenlabs = ElevenLabs(api_key=api_key)
dynamic_vars = {
    "user_name": "Angelo",
}
config = ConversationInitiationData(
    dynamic_variables=dynamic_vars
)
conversation = Conversation(
    elevenlabs,
    agent_id,
    config=config,
    # Assume auth is required when API_KEY is set.
    requires_auth=bool(api_key),
    # Use the default audio interface.
    audio_interface=DefaultAudioInterface(),
    # Callbacks that print the conversation to the console.
    callback_agent_response=lambda response: print(f"Agent: {response}"),
    callback_agent_response_correction=lambda original, corrected: print(f"Agent: {original} -> {corrected}"),
    callback_user_transcript=lambda transcript: print(f"User: {transcript}"),
    # Uncomment the below if you want to see latency measurements.
    # callback_latency_measurement=lambda latency: print(f"Latency: {latency}ms"),
)
conversation.start_session()
signal.signal(signal.SIGINT, lambda sig, frame: conversation.end_session())

पब्लिक टॉक-टू पेज इंटीग्रेशन

पब्लिक टॉक-टू पेज URL पैरामीटर्स के ज़रिए डायनामिक वेरिएबल्स सपोर्ट करता है, जिससे एजेंट लिंक शेयर करते समय आप बातचीत को वैयक्तिकृत कर सकते हैं। यह खास तौर पर वेबसाइट्स, ईमेल या मार्केटिंग कैंपेन में वैयक्तिकृत एजेंट एम्बेड करने के लिए उपयोगी है।

URL पैरामीटर तरीके

पब्लिक टॉक-टू पेज पर डायनामिक वेरिएबल्स पास करने के दो तरीके हैं:

तरीका 1: Base64-एन्कोडेड JSON

vars पैरामीटर का इस्तेमाल करके वेरिएबल्स को base64-एन्कोडेड JSON ऑब्जेक्ट के रूप में पास करें:

https://elevenlabs.io/app/talk-to?agent_id=agent_7101k5zvyjhmfg983brhmhkd98n6&vars=eyJ1c2VyX25hbWUiOiJKb2huIiwiYWNjb3VudF90eXBlIjoicHJlbWl1bSJ9

vars पैरामीटर में base64-एन्कोडेड JSON होता है:

{ "user_name": "John", "account_type": "premium" }

तरीका 2: अलग-अलग क्वेरी पैरामीटर्स

var_ प्रीफ़िक्स वाले क्वेरी पैरामीटर्स से वेरिएबल्स पास करें:

https://elevenlabs.io/app/talk-to?agent_id=agent_7101k5zvyjhmfg983brhmhkd98n6&var_user_name=John&var_account_type=premium

पैरामीटर प्राथमिकता

जब दोनों तरीके एक साथ इस्तेमाल किए जाते हैं, तो टकराव रोकने के लिए अलग-अलग var_ पैरामीटर्स की प्राथमिकता base64-एन्कोडेड वेरिएबल्स से ज़्यादा होती है:

https://elevenlabs.io/app/talk-to?agent_id=agent_7101k5zvyjhmfg983brhmhkd98n6&vars=eyJ1c2VyX25hbWUiOiJKYW5lIn0=&var_user_name=John

इस उदाहरण में user_name, "Jane" (base64-एन्कोडेड vars से) की जगह "John" (var_user_name से) होगा।

इंप्लीमेंटेशन उदाहरण

// Method 1: Base64-encoded JSON
function generateTalkToURL(agentId, variables) {
  const baseURL = 'https://elevenlabs.io/app/talk-to';
  const encodedVars = btoa(JSON.stringify(variables));
  return `${baseURL}?agent_id=${agentId}&vars=${encodedVars}`;
}
// Method 2: Individual parameters
function generateTalkToURLWithParams(agentId, variables) {
  const baseURL = 'https://elevenlabs.io/app/talk-to';
  const params = new URLSearchParams({ agent_id: agentId });
  Object.entries(variables).forEach(([key, value]) => {
    params.append(`var_${key}`, encodeURIComponent(value));
  });
  return `${baseURL}?${params.toString()}`;
}
// Usage
const variables = {
  user_name: "John Doe",
  account_type: "premium",
  session_id: "sess_123"
};
const urlMethod1 = generateTalkToURL("agent_7101k5zvyjhmfg983brhmhkd98n6", variables);
const urlMethod2 = generateTalkToURLWithParams("agent_7101k5zvyjhmfg983brhmhkd98n6", variables);

सर्वोत्तम तरीके

समस्या निवारण