वेबहुक टूल्स

टूल्स आपके असिस्टेंट को बाहरी डेटा और सिस्टम से कनेक्ट करने में मदद करते हैं। आप ऐसे टूल्स का एक सेट तय कर सकते हैं, जिनका असिस्टेंट इस्तेमाल कर सके, और बातचीत के आधार पर ज़रूरत पड़ने पर असिस्टेंट उनका इस्तेमाल करेगा।

ओवरव्यू

कई ऐप्लिकेशन में असिस्टेंट को रीयल-टाइम जानकारी पाने के लिए बाहरी APIs कॉल करने की ज़रूरत होती है। टूल्स आपके असिस्टेंट को थर्ड-पार्टी ऐप्स के लिए बाहरी फ़ंक्शन कॉल करने की क्षमता देते हैं, ताकि आप रीयल-टाइम जानकारी पा सकें।

यहां कुछ उदाहरण दिए गए हैं, जहां टूल्स उपयोगी हो सकते हैं:

• डेटा फ़ेच करना: यूज़र को जवाब देने से पहले असिस्टेंट को किसी भी REST-सक्षम डेटाबेस या थर्ड-पार्टी इंटीग्रेशन से रीयल-टाइम डेटा पाने की सुविधा दें।
• कार्रवाई करना: बातचीत के आधार पर असिस्टेंट को प्रमाणित कार्रवाइयां ट्रिगर करने दें, जैसे मीटिंग शेड्यूल करना या ऑर्डर रिटर्न शुरू करना।

टूल कॉन्फ़िगरेशन

ElevenLabs एजेंट्स को बाहरी APIs के साथ इंटरैक्ट करने के लिए टूल्स से लैस किया जा सकता है। पारंपरिक रिक्वेस्ट के विपरीत, असिस्टेंट आपके दिए गए बातचीत और पैरामीटर विवरणों के आधार पर query, body और path पैरामीटर डाइनैमिक रूप से जनरेट करता है।

सभी टूल कॉन्फ़िगरेशन और पैरामीटर विवरण असिस्टेंट को यह तय करने में मदद करते हैं कि इन टूल्स का इस्तेमाल कब और कैसे करना है। टूल के इस्तेमाल को प्रभावी ढंग से व्यवस्थित करने के लिए, इन कॉल्स का क्रम और लॉजिक तय करने हेतु असिस्टेंट का सिस्टम प्रॉम्प्ट अपडेट करें। इसमें शामिल है:

• कौन सा टूल इस्तेमाल करना है और किन स्थितियों में।
• टूल को ठीक से काम करने के लिए किन पैरामीटर्स की ज़रूरत है।
• रिस्पॉन्स को कैसे हैंडल करना है।

गाइड

इस गाइड में, हम एक मौसम असिस्टेंट बनाएंगे जो किसी भी जगह की रीयल-टाइम मौसम जानकारी दे सके। असिस्टेंट जगह के नामों को निर्देशांकों में बदलने और सटीक मौसम डेटा पाने के लिए अपने भौगोलिक ज्ञान का इस्तेमाल करेगा।

You are a helpful conversational agent with access to a weather tool. When users ask about
weather conditions, use the get_weather tool to fetch accurate, real-time data. The tool requires
a latitude and longitude - use your geographic knowledge to convert location names to coordinates
accurately.
Never ask users for coordinates - you must determine these yourself. Always report weather
information conversationally, referring to locations by name only. For weather requests:
1. Extract the location from the user's message
2. Convert the location to coordinates and call get_weather
3. Present the information naturally and helpfully
For non-weather queries, provide friendly assistance within your knowledge boundaries. Always be
concise, accurate, and helpful.
First message: "Hey, how can I help you today?"

समर्थित ऑथेंटिकेशन तरीके

ElevenLabs एजेंट्स आपके टूल्स को बाहरी APIs से सुरक्षित रूप से कनेक्ट करने के लिए कई ऑथेंटिकेशन तरीकों का समर्थन करता है। ऑथेंटिकेशन तरीकों को आपके एजेंट सेटिंग्स में कॉन्फ़िगर किया जाता है और फिर ज़रूरत के अनुसार अलग-अलग टूल्स से कनेक्ट किया जाता है।

कॉन्फ़िगर हो जाने के बाद, आप इन ऑथेंटिकेशन तरीकों को अपने टूल्स से कनेक्ट कर सकते हैं और टूल कॉन्फ़िगरेशन में कस्टम हेडर्स मैनेज कर सकते हैं:

OAuth2 क्लाइंट क्रेडेंशियल्स

OAuth2 client credentials flow को अपने आप हैंडल करता है। अपने client ID, client secret और token URL (जैसे, https://api.example.com/oauth/token) के साथ कॉन्फ़िगर करें। वैकल्पिक रूप से comma-separated वैल्यू के रूप में scopes और अतिरिक्त JSON पैरामीटर्स तय करें। अपने एजेंट सेटिंग्स पेज के Agent सेक्शन में Workspace Auth Connections पर Add Auth क्लिक करके सेट अप करें।

OAuth2 JWT

OAuth 2.0 JWT Bearer flow के लिए JSON Web Token ऑथेंटिकेशन का इस्तेमाल करता है। इसके लिए आपका JWT signing secret, token URL और algorithm (डिफ़ॉल्ट: HS256) ज़रूरी है। issuer, audience और subject समेत JWT claims कॉन्फ़िगर करें। वैकल्पिक रूप से key ID, expiration (डिफ़ॉल्ट: 3600 सेकंड), scopes और अतिरिक्त पैरामीटर्स सेट करें। अपने एजेंट सेटिंग्स पेज के Agent सेक्शन में Workspace Auth Connections पर Add Auth क्लिक करके सेट अप करें।

बेसिक ऑथेंटिकेशन

HTTP Basic Auth को सपोर्ट करने वाले APIs के लिए सरल username और password ऑथेंटिकेशन। अपने एजेंट सेटिंग्स पेज के Agent सेक्शन में Workspace Auth Connections पर Add Auth क्लिक करके सेट अप करें।

Bearer टोकन्स

टोकन-आधारित ऑथेंटिकेशन जो आपकी bearer token वैल्यू को रिक्वेस्ट हेडर में जोड़ता है। टूल कॉन्फ़िगरेशन में हेडर जोड़कर, हेडर टाइप के रूप में Secret चुनकर और Create New Secret क्लिक करके कॉन्फ़िगर करें।

कस्टम हेडर्स

प्रोप्रायटरी ऑथेंटिकेशन तरीकों के लिए किसी भी नाम और वैल्यू वाले कस्टम ऑथेंटिकेशन हेडर्स जोड़ें। टूल कॉन्फ़िगरेशन में हेडर जोड़कर और उसका name और value तय करके कॉन्फ़िगर करें।

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

टूल्स के नाम सहज रखें और विस्तृत descriptions दें

अगर आपको लगता है कि assistant सही टूल्स को कॉल नहीं कर रहा है, तो आपको टूल के names और descriptions अपडेट करने पड़ सकते हैं, ताकि assistant को बेहतर तरीके से समझ आए कि हर टूल कब चुनना है। टूल और argument names को छोटा करने के लिए abbreviations या acronyms इस्तेमाल न करें।

आप यह भी बता सकते हैं कि किसी टूल को कब कॉल करना चाहिए। Complex tools के लिए, हर argument का description शामिल करें, ताकि assistant को पता हो कि उस argument को पाने के लिए यूज़र से क्या पूछना है।

टूल parameters के नाम सहज रखें और विस्तृत descriptions दें

टूल parameters के लिए स्पष्ट और descriptive names इस्तेमाल करें। अगर लागू हो, तो description में parameter का expected format बताएं (जैसे किसी date के लिए YYYY-mm-dd या dd/mm/yy)।

अपने assistant के system prompt में टूल्स को कैसे और कब कॉल करना है, इसकी अतिरिक्त जानकारी देने पर विचार करें

अपने system prompt में स्पष्ट निर्देश देने से assistant की टूल-कॉलिंग accuracy काफ़ी बेहतर हो सकती है। उदाहरण के लिए, assistant को इस तरह के निर्देश दें:

Use `check_order_status` when the user inquires about the status of their order, such as 'Where is my order?' or 'Has my order shipped yet?'.

Complex scenarios के लिए context दें। उदाहरण के लिए:

Before scheduling a meeting with `schedule_meeting`, check the user's calendar for availability using check_availability to avoid conflicts.

LLM चयन

यह ध्यान रखना ज़रूरी है कि function calls की सफलता में LLM का चयन अहम होता है। कुछ LLMs को conversation से relevant parameters निकालने में मुश्किल हो सकती है।

टूल कॉल साउंड्स

यूज़र अनुभव बेहतर बनाने के लिए आप टूल के चलने के दौरान चलने वाला ambient ऑडियो कॉन्फ़िगर कर सकते हैं। टूल कॉल साउंड्स के बारे में और जानें।