स्टेट अपडेट करें

खास जानकारी

Update state टूल आपके एजेंट को बातचीत जारी रहने के दौरान एक या अधिक डायनामिक वेरिएबल सेट करने देता है। दूसरे सिस्टम टूल्स की तरह, यह सिर्फ़ बातचीत की आंतरिक स्थिति बदलता है — यह कभी किसी बाहरी API या क्लाइंट-साइड फ़ंक्शन को कॉल नहीं करता।

कॉल के दौरान जानकारी रिकॉर्ड करने के लिए इसका इस्तेमाल करें, जैसे यह फ़्लैग करना कि बातचीत को एस्केलेट किया जाना चाहिए, यूज़र द्वारा दी गई वैल्यू सेव करना, या दूसरे डायनामिक वेरिएबल से निकली वैल्यू की गणना करना।

सुविधाएं

• हर कॉल में कई अपडेट: एक टूल कॉल एक साथ अधिकतम 10 डायनामिक वेरिएबल असाइन कर सकती है।
• एक्सप्रेशन-आधारित वैल्यू: हर वैल्यू किसी एक्सप्रेशन का नतीजा होती है, जो कॉन्स्टेंट, मौजूदा डायनामिक वेरिएबल, बातचीत से LLM द्वारा निकाली गई वैल्यू और ऑपरेटर को मिला सकती है।
• LLM एक्सट्रैक्शन सिर्फ़ ज़रूरत पड़ने पर: टूल सिर्फ़ उन अपडेट के लिए LLM से पैरामीटर निकालने को कहता है, जिनमें इसकी ज़रूरत होती है। सिर्फ़ कॉन्स्टेंट और/या मौजूदा डायनामिक वेरिएबल से बने अपडेट, फ़ंक्शन कॉल में कोई पैरामीटर नहीं जोड़ते।
• तुरंत उपलब्धता: टूल चलने के बाद, अपडेट किए गए डायनामिक वेरिएबल बाकी बातचीत में उपलब्ध होते हैं — बाद के प्रॉम्प्ट, दूसरे टूल कॉल और ओवरराइड, सभी इन्हें किसी भी दूसरे डायनामिक वेरिएबल की तरह रेफ़र कर सकते हैं।

यह कैसे काम करता है

हर स्टेट अपडेट, किसी एक्सप्रेशन का नतीजा एक डायनामिक वेरिएबल को असाइन करता है:

variable_name = expression

एक एक्सप्रेशन इनमें से किसी एक टाइप का होता है, और अधिक जटिल लॉजिक बनाने के लिए एक्सप्रेशन को एक-दूसरे के अंदर नेस्ट किया जा सकता है:

उदाहरण के लिए, अगर LLM यह तय करता है कि यूज़र बातचीत से परेशान है, या retry_count डायनामिक वेरिएबल पहले से 3 से ज़्यादा है, तो नीचे दिया गया स्टेट अपडेट should_escalate को true पर सेट करता है:

should_escalate = (llm: "User sounds frustrated with the conversation") OR (retry_count > 3)

कॉन्फ़िगरेशन

इस्तेमाल के मामले

• एस्केलेशन फ़्लैग्स: कोई डायनामिक वेरिएबल (जैसे should_escalate) सेट करें, जिसे डाउनस्ट्रीम सिस्टम या बिज़नेस रूल जाँचता है, जैसा कि Genesys इंटीग्रेशन गाइड में दिखाया गया है।
• निकाली गई जानकारी रिकॉर्ड करना: यूज़र की दी हुई वैल्यू (ऑर्डर नंबर, प्राथमिकता या चुना गया विभाग) को बातचीत में बाद में इस्तेमाल करने के लिए डायनामिक वेरिएबल के रूप में स्टोर करें।
• डिराइव्ड वैल्यू: दूसरे डायनामिक वेरिएबल से कोई वैल्यू कैलकुलेट करें, जैसे काउंटर बढ़ाना या दो वेरिएबल को एक में मिलाना।

उद्देश्य: एजेंट को बातचीत के आधार पर एक या अधिक dynamic variables update करने दें, बिना किसी external API को call किए।

ट्रिगर स्थितियां: LLM को इस tool को तब call करना चाहिए, जब:

• बातचीत में ऐसी जानकारी मिले जिसे record किया जाना चाहिए (जैसे escalation flag, चुना गया option या यूज़र द्वारा दी गई value)
• configured state update किसी ऐसी value पर निर्भर हो जिसे LLM को बातचीत से तय या extract करना हो

Parameters:

Function के parameters इस बात पर निर्भर करते हैं कि tool कैसे configured है। LLM-extracted value इस्तेमाल करने वाला हर configured state update schema में एक property जोड़ता है, जिसका नाम उस update के dynamic variable पर होता है और जिसका type string, number या boolean होता है। केवल constants या दूसरे dynamic variables से बने state updates कोई parameters नहीं जोड़ते।

Function call format:

{
  "type": "function",
  "function": {
    "name": "update_state",
    "arguments": "{\"should_escalate\": true}"
  }
}

Implementation: एजेंट extracted parameters और बातचीत के मौजूदा dynamic variables के साथ हर configured expression को evaluate करता है, फिर नतीजों को संबंधित dynamic variables में assign करता है। कोई external request नहीं की जाती।

FAQ