API कनेक्शन्स

कोणतेही HTTP API तुमचा एजंट संभाषणादरम्यान कॉल करू शकणाऱ्या फंक्शनमध्ये बदला: cURL कमांड पेस्ट करा आणि विझार्ड टूलची व्याख्या, पॅरामीटर्स आणि ऑथ तयार करतो.

API कनेक्शन ही सानुकूल HTTP फंक्शन्स आहेत जी तुमचे एजंट संभाषणादरम्यान कॉल करू शकतात — ऑर्डर शोधणे, तिकीट तयार करणे, तुमच्या स्वतःच्या बॅकएंडमधून खात्याची स्थिती मिळवणे. तुम्ही एंडपॉइंट एकदा कनेक्शन → APIs (/dashboard/api-connections) अंतर्गत परिभाषित करता; ज्या एजंटना कनेक्शन जोडलेले आहे ते संभाषणाला गरज भासेल तेव्हा ते कॉल करू शकतात.

ते तयार करण्याचे दोन मार्ग आहेत: विझार्ड विश्लेषित करू शकणारी माहिती पेस्ट करा, किंवा कनेक्शन स्वहस्ते सेट अप करा.

जलद मार्ग: पेस्ट करा आणि विश्लेषित करा#

1. नवीन API कनेक्शनवर क्लिक करा

   डायलॉग विझार्डवर उघडतो. बॉक्समध्ये नमुना cURL कमांड, OpenAPI/Swagger स्पेक, Postman एक्सपोर्ट, TypeScript इंटरफेस, किंवा Zod स्कीमा पेस्ट करा.

2. विश्लेषण करा वर क्लिक करा

   ThunderPhone तुमच्या पेस्टमधून संपूर्ण कनेक्शन अनुमानित करते — URL, पद्धत, हेडर्स आणि त्याला सापडलेल्या क्वेरी पॅरामीटर्स व विनंती बॉडीवरून तयार केलेली पॅरामीटर स्कीमा. तुम्ही पेस्ट केलेले हेडर्स (ऑथ हेडर्ससह) एंडपॉइंट कॉन्फिगरेशनमध्ये समाविष्ट केले जातात.

3. हायलाइट केलेल्या फील्ड्सची पुष्टी करा

   अनुमानित कॉन्फिगरेशन पुनरावलोकनासाठी अंदाजित फील्ड्स हायलाइट करून उघडते. नावे, वर्णने आणि पॅरामीटर प्रकार समायोजित करा, जेणेकरून एजंटला फंक्शन केव्हा आणि कसे कॉल करायचे हे समजेल — वर्णन मॉडेल वाचते.

4. तपासा आणि जतन करा

   जतन करण्यापूर्वी तुमच्या एंडपॉइंटवर थेट चाचणी विनंती चालवली जाते. विनंती अयशस्वी झाल्यास कनेक्शन जतन केले जात नाही — URL, ऑथ हेडर्स किंवा बॉडी दुरुस्त करा आणि पुन्हा प्रयत्न करा. यशस्वी झाल्यावर कनेक्शन तपासलेले बॅजसह संग्रहित केले जाते.

तुमच्या पेस्टमध्ये विझार्डला विनंती URL सापडला नाही, तर ते तसे सांगेल — पूर्ण http(s) एंडपॉइंट समाविष्ट करा आणि पुन्हा प्रयत्न करा.

स्वहस्ते सेट अप#

विझार्डमध्ये स्वहस्ते सेट अप करा → वर क्लिक करा (किंवा परत जाण्यासाठी AI ने हे अनुमानित करावे का? विझार्ड वापरून पाहा → वर क्लिक करा). स्वहस्ते बिल्डरमध्ये दोन एडिटर्स आहेत:

• दृश्य — डिस्प्ले नाव, फंक्शन नाव, विनंती URL, पद्धत (POST, GET, PUT, PATCH, DELETE), सानुकूल हेडर्स, आणि पॅरामीटर स्कीमासाठी फॉर्म फील्ड्स (एजंट देऊ शकणाऱ्या प्रत्येक आर्ग्युमेंटसाठी प्रॉपर्टी जोडा).
• JSON — टूल स्पेक थेट पेस्ट करण्यासाठी किंवा सूक्ष्म समायोजनासाठी, कच्च्या JSON स्वरूपातील तीच व्याख्या.

पर्यायी चाचणी विनंती पॅनेल तुम्हाला जतन करण्यापूर्वी कॉन्फिगर केलेली विनंती पाठवू देते आणि स्थिती, विलंब व प्रतिसादाचे पूर्वावलोकन दाखवते. तपासा आणि जतन करा ही चाचणी नेहमी चालवते आणि फक्त यशस्वी झाल्यावर जतन करते.

तुमची कनेक्शन्स व्यवस्थापित करा#

प्रत्येक कनेक्शन रांगेत त्याची पडताळणी स्थिती — तपासलेले, न तपासलेले, किंवा त्रुटी — त्याचे फंक्शन नाव आणि ते वापरणारे एजंट दिसतात. रांगेच्या कृती मेनूमधून तुम्ही हे करू शकता:

• संपादित करा — कॉन्फिगरेशन पुन्हा उघडा.
• क्लोन करा — प्रारंभबिंदू म्हणून त्याची प्रत तयार करा (प्रत सुरुवातीला न तपासलेली असते).
• आवृत्ती इतिहास — आधीच्या आवृत्त्या पहा आणि एक आवृत्ती एडिटरमध्ये पुनर्स्थापित करा.
• हस्तांतरित करा — तुम्ही सदस्य असलेल्या दुसऱ्या संस्थेमध्ये कनेक्शन कॉपी करा किंवा हलवा. हलवल्यावर ते येथून काढले जाते; ते वापरणाऱ्या एजंटना पुन्हा कॉन्फिगर करावे लागू शकते.
• हटवा — कायमस्वरूपी; कनेक्शन वापरणाऱ्या एजंटना पुन्हा कॉन्फिगर करावे लागेल.

एजंटला जोडा#

बिल्डरच्या API कनेक्शन्स विभागात एजंटला कनेक्शन जोडा (एजंट तयार करा). सूचीमध्ये प्रत्येक कनेक्शन वापरणारे एजंट दिसतात, म्हणून बदलाचा परिणाम कशावर होईल हे तुम्ही एका नजरेत ओळखू शकता.

पुढील पायऱ्या#