API कनेक्शन्स

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

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