अनुरोध कार्यक्षेत्र और एनवायरनमेंट
अनुरोध कार्यक्षेत्र में डिज़ाइन किया गया ऑपरेशन वास्तविक कॉल बनता है। यह स्थानीय मुख्य प्रोसेस से अनुरोध भेजता है, प्रतिक्रिया दिखाता है और हर रन में बदलने वाले मानों के लिए एनवायरनमेंट तथा वेरिएबल इस्तेमाल करता है।
अनुरोध भेजना
- अनुरोध कार्यक्षेत्र में ऑपरेशन खोलें। मेथड, पथ, पैरामीटर, हेडर और बॉडी स्पेसिफ़िकेशन से लिए जाते हैं।
- जहाँ ठोस इनपुट चाहिए, वहाँ मान भरें, जैसे पथ पैरामीटर या टोकन।
- अनुरोध भेजें। उस टैब में स्टेटस कोड, हेडर, बॉडी और समय की जानकारी दिखाई जाती है।
- तुलना करने या बाद में देखने के लिए कई अनुरोध टैब में खुले रखें।
निष्पादन वेब व्यू के बजाय मुख्य प्रोसेस में होता है, इसलिए ब्राउज़र की CORS पाबंदियाँ कॉल को नहीं रोकतीं और अनुरोध का विवरण ब्राउज़र के नेटवर्क पैनल में नहीं दिखता।
एनवायरनमेंट और OAS सर्वर
दोनों आपस में जुड़े हैं, लेकिन अलग हैं। उनका अंतर समझने से एक आम भ्रम दूर होता है।
| कस्टम एनवायरनमेंट | OAS servers | |
|---|---|---|
| कहाँ रहता है | ऐप की स्थानीय सेटिंग में | OpenAPI दस्तावेज़ के अंदर |
| क्या अनुरोध टूल से बदल सकते हैं | हाँ | नहीं; स्पेसिफ़िकेशन पैच से बदलें |
| उद्देश्य | नए अनुरोध टैब और परिदृश्य रन के लिए डिफ़ॉल्ट बेस URL | कॉन्ट्रैक्ट में घोषित बेस URL |
| क्या दस्तावेज़ के साथ साझा होता है | नहीं | हाँ |
जब सहायक बेस URL की सूची देता है (env.listServers), तो पहले आपके संपादन योग्य कस्टम एनवायरनमेंट आते हैं, फिर सक्रिय दस्तावेज़ में घोषित केवल-पढ़ने योग्य सर्वर।
- स्थानीय बेस URL जोड़ने या चुनने के लिए कस्टम एनवायरनमेंट बनाएँ या सक्रिय करें (
env.upsertServer,env.selectServer)। इससे दस्तावेज़ नहीं बदलता। - कॉन्ट्रैक्ट के सर्वर बदलने के लिए स्पेसिफ़िकेशन पैच प्रस्तावित करें।
इससे निजी डिबगिंग बेस URL कॉन्ट्रैक्ट से अलग रहता है, जबकि दस्तावेज़ में घोषित सर्वर से अनुरोध भी भेजे जा सकते हैं।
वेरिएबल
वेरिएबल चार स्कोप में प्रबंधित होते हैं:
- globals — सभी कलेक्शन में उपलब्ध;
- collection — एक कलेक्शन तक सीमित;
- environment — सक्रिय एनवायरनमेंट से जुड़े; कोई विशेष सर्वर न दिया हो तो सभी सर्वर पर लागू;
- local — स्थानीय सत्र तक निजी।
सहायक वेरिएबल की सूची दे सकता है (env.listVariables, वैकल्पिक स्कोप फ़िल्टर के साथ) और उन्हें बना या अपडेट कर सकता है (env.setVariable, नाम और स्कोप के आधार पर)। वेरिएबल किसी विशेष सर्वर से जुड़ सकता है और हर वेरिएबल की सक्रिय स्थिति होती है। वेरिएबल सेट करना ऐप की कार्रवाई है, API दस्तावेज़ में बदलाव नहीं।
आम तौर पर वेरिएबल में एक्सेस टोकन, कई कॉल में दोबारा इस्तेमाल होने वाले ID और फ़ीचर फ़्लैग रखे जाते हैं।
बेस URL न होने पर
अनुरोध के लिए पूरा URL चाहिए। यदि दस्तावेज़ के servers और सक्रिय एनवायरनमेंट, दोनों में बेस URL नहीं है, तो ऐप अनुमान नहीं लगाता। वह चलाने से पहले आपसे URL माँगता है, ताकि चुपचाप गलत होस्ट को कॉल न किया जाए।
एक अनुरोध से पूरे प्रवाह तक
एक कॉल सही चलने लगे तो कई कॉल जोड़ सकते हैं, ताकि एक प्रतिक्रिया का मान अगले अनुरोध में जाए। इसे परिदृश्य परीक्षण कहते हैं।
सं बंधित: सहायक के साथ डिज़ाइन, परिदृश्य परीक्षण, सेटिंग।
A2A एजेंट
x-protocol: a2a से संस्करण-आधारित एजेंट संदेश, टास्क ऑपरेशन और SSE अपडेट डिज़ाइन तथा डिबग करें। एक्सटेंशन फ़ील्ड और JSON-RPC, REST तथा डेस्कटॉप gRPC बाइंडिंग के लिए A2A एजेंट देखें।