Dev Tunnel का उपयोग करके एजेंटों का परीक्षण करें

Dev Tunnels का उपयोग करके, आप अपने Agent 365 एजेंट को Microsoft 365 एप्लिकेशन (जैसे Teams, Outlook, या Word) के साथ तब भी परीक्षण कर सकते हैं जब आपका एजेंट आपकी डेवलपमेंट मशीन पर स्थानीय रूप से चल रहा हो। यह दृष्टिकोण स्थानीय विकास और वास्तविक दुनिया के परीक्षण के बीच सेतु का कार्य करता है, जिससे आप क्लाउड पर परिनियोजन से पहले वास्तविक Microsoft 365 वातावरण में एजेंट के व्यवहार को मान्य कर सकते हैं।

आवश्यकताएँ

Dev Tunnels का उपयोग करने से पहले, सुनिश्चित करें कि आपने Dev Tunnels command-line tool इंस्टॉल किया है।

• Windows: winget install Microsoft.devtunnel
• macOS/Linux: aka.ms/devtunnels/download से डाउनलोड करें

Dev Tunnel सेट अप करें

Microsoft 365 सेवाओं के लिए अपने स्थानीय एजेंट एंडपॉइंट को एक्सपोज़ करने के लिए एक Dev Tunnel कॉन्फ़िगर करें।

Dev Tunnel बनाएं और शुरू करें

1. देव टनल में साइन इन करें:

   devtunnel user login
   

2. एक लगातार सुरंग बनाएं:

   devtunnel create --allow-anonymous
   

   यह आदेश एक टनल आईडी देता है। इस पहचानकर्ता को भविष्य में उपयोग के लिए सहेजें।

3. टनल पोर्ट कॉन्फ़िगर करें:

   वह पोर्ट निर्धारित करें जिसका उपयोग आपका एजेंट सर्वर करता है (आमतौर पर 3978):

   devtunnel port create <tunnel-id> -p <port-number>
   

4. टनल शुरू करें:

   devtunnel host <tunnel-id>
   

   कमांड आपका टनल URL प्रदर्शित करता है (उदाहरण के लिए, https://abc123xyz.devtunnels.ms:3978)। अगले चरण के लिए इस URL को कॉपी करें।

टिप

सभी टनल देखने के लिए devtunnel list और जिन टनल की अब आवश्यकता नहीं है उन्हें हटाने के लिए devtunnel delete <tunnel-id> का उपयोग करें।

एजेंट मैसेजिंग एंडपॉइंट कॉन्फ़िगर करें

अपने Dev Tunnel URL (उदाहरण के लिए, https://abc123xyz.devtunnels.ms:3978/api/messages) को एजेंट मैसेजिंग एंडपॉइंट के रूप में पंजीकृत करें ताकि Microsoft 365 यह जान सके कि संदेशों को कहां रूट करना है। एंडपॉइंट में /api/messages सफिक्स जोड़ना न भूलें।

कृपया एजेंट मैसेजिंग एंडपॉइंट सेट करें देखें

Microsoft 365 के साथ परीक्षण करें

जब आपका Dev Tunnel सक्रिय हो और एंडपॉइंट पंजीकृत हो जाए, तब Microsoft 365 एप्लिकेशन में अपने एजेंट का परीक्षण करें।

Microsoft Teams में परीक्षण

1. अपने स्थानीय एजेंट को प्रारंभ करें के निर्देशों का पालन करके निर्भरताएँ स्थापित करें और एजेंट एप्लिकेशन सर्वर प्रारंभ करें.

2. टनल कनेक्टिविटी को सत्यापित करें:

   devtunnel list
   

   जांचें कि आपकी टनल सक्रिय होस्ट कनेक्शन दिखा रही है। "Host Connections" स्तंभ में 0 से अधिक संख्या दिखाई देनी चाहिए।

3. Microsoft Teams में अपने एजेंट के साथ इंटरैक्ट करें:

   • Microsoft Teams (वेब या डेस्कटॉप) खोलें
   • Teams सर्च बार में अपने एजेंट को नाम या ईमेल से खोजें
   • एजेंट के साथ बातचीत शुरू करें
   • एक संदेश भेजें और प्रत्युत्तर देखें
   • इनकमिंग अनुरोधों और एजेंट गतिविधि के लिए अपने स्थानीय कंसोल की जाँच करें

ईमेल सूचनाएँ टेस्ट करें

यदि आपका एजेंट ईमेल सूचनाओं के लिए कॉन्फ़िगर किया गया है:

1. अपने एजेंट के ईमेल पते पर ईमेल भेजें
2. अपने एजेंट को ईमेल थ्रेड में CC करें
3. अपने स्थानीय कंसोल में अधिसूचना वेबहुक की निगरानी करें
4. सुनिश्चित करें कि आपका एजेंट ईमेल को प्रोसेस करता है और उसका जवाब देता है

Word एकीकरण का परीक्षण करें

Word टिप्पणियों का उत्तर देने वाले एजेंटों के लिए:

1. एक Word दस्तावेज़ खोलें जिसमें आपके एजेंट की पहुँच है।
2. अपने एजेंट का उल्लेख करते हुए एक टिप्पणी जोड़ें।
3. सूचना के लिए अपने स्थानीय कंसोल की जाँच करें।
4. सत्यापित करें कि आपके एजेंट का प्रत्युत्तर Word में दिखाई देता है।

सुरंग गतिविधि की निगरानी करें

Dev Tunnels कनेक्शन समस्याओं को डीबग करने और अनुरोध प्रवाह को समझने में मदद के लिए ट्रैफ़िक निरीक्षण प्रदान करता है:

devtunnel show <tunnel-id>

यह कमांड प्रदर्शित करता है:

• सक्रिय कनेक्शन और सत्र विवरण।
• अनुरोध और प्रतिक्रिया जानकारी।
• ट्रैफिक वॉल्यूम के आँकड़े।
• जड़ान संबंधी त्रुटियाँ और चेतावनियाँ।

आप devtunnel host कमांड के आउटपुट को देखकर टनल की गतिविधि को वास्तविक समय में भी मॉनिटर कर सकते हैं।

टनल कनेक्शन बनाए रखें

Dev Tunnels को चालू रखने के लिए devtunnel host प्रक्रिया को लगातार चलना जरूरी है। यदि निष्क्रियता, नेटवर्क समस्याएँ, या आपका कंप्यूटर सोने की स्थिति में जाने से कनेक्शन टूट जाता है, तो आपको इसे पुनः आरंभ करना आवश्यक है।

सुरंग की स्थिति की जाँच करें

सत्यापित करें कि आपकी सुरंग सक्रिय है या नहीं:

devtunnel list

आउटपुट में निम्नलिखित दिखाई देता है:

• टनल आईडी: आपका टनल आइडेंटिफ़ायर
• होस्ट कनेक्शन: सक्रिय कनेक्शन की संख्या (जब devtunnel host चल रहा हो तो कम से कम एक होना चाहिए)
• पोर्ट्स: कॉन्फ़िगर किए गए पोर्ट्स
• समाप्ति: सुरंग समाप्ति समय

यदि होस्ट कनेक्शन 0 दिखाता है, तो सुरंग मौजूद है लेकिन वर्तमान में होस्ट नहीं की गई है।

डिस्कनेक्ट की गई सुरंग को पुनरारंभ करें

यदि आपका टनल कनेक्शन टूट जाता है, तो उसे उसी टनल आईडी का उपयोग करके पुनरारंभ करें:

devtunnel host <tunnel-id>

टनल यूआरएल वही रहता है, इसलिए आपको अपनी एजेंट मैसेजिंग एंडपॉइंट कॉन्फ़िगरेशन को अपडेट करने की आवश्यकता नहीं है।

विकास के दौरान सुरंगों को सक्रिय रखें

स्थिर कनेक्शन बनाए रखने के लिए:

• टर्मिनल विंडो खुली रखें - उस टर्मिनल को बंद न करें जिसमें devtunnel host चल रहा है।
• सिस्टम को स्लीप मोड में जाने से रोकें - परीक्षण सत्रों के दौरान सिस्टम को जागृत रखने के लिए कॉन्फ़िगर करें।
• कनेक्शन त्रुटियों पर ध्यान दें - डिस्कनेक्शन संदेशों के लिए devtunnel hostटर्मिनल आउटपुट की निगरानी करें।
• नेटवर्क परिवर्तन के बाद पुनरारंभ करें - यदि आप नेटवर्क स्विच करते हैं या वीपीएन से पुनः कनेक्ट करते हैं, तो सुरंग को पुनरारंभ करें।

टिप

यदि आपकी सुरंग बार-बार डिस्कनेक्ट हो जाती है, तो यह सुनिश्चित करने के लिए अपनी नेटवर्क सेटिंग्स और फ़ायरवॉल नियमों की जाँच करें कि वे कनेक्शन को अवरुद्ध नहीं कर रहे हैं।

साफ़ करें

जब आप Dev Tunnels के साथ परीक्षण समाप्त कर लें:

टनल बंद करें

उस टर्मिनल में Ctrl+C दबाएं जिसमें devtunnel host चल रहा है, ताकि टनल बंद हो जाए।

यह कमांड आपके एजेंट के मैसेजिंग एंडपॉइंट से Dev Tunnel URL को हटा देता है। जब आप प्रोडक्शन में डिप्लॉय करते हैं, तब क्लाउड-होस्टेड एंडपॉइंट URL सेट करें।

नोट

सुरंग भविष्य में उपयोग के लिए तब तक उपलब्ध रहती है जब तक कि आप इसका उपयोग करके devtunnel delete <tunnel-id>इसे स्पष्ट रूप से हटा नहीं देते।

सीमाएँ

देव टनल के साथ परीक्षण करते समय इन सीमाओं पर विचार करें:

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

अगले चरण

सफल Dev Tunnel परीक्षण के बाद:

• अपने एजेंट को क्लाउड पर तैनात करें: Azure में परिनियोजित करें, AWS में एजेंट मैसेजिंग एंडपॉइंट सेट करें, या GCP में एजेंट मैसेजिंग एंडपॉइंट सेट करें.
• एजेंट मैसेजिंग एंडपॉइंट कॉन्फ़िगर करें: एजेंट मैसेजिंग एंडपॉइंट.
• संपूर्ण विकास जीवनचक्र का पालन करें: Agent 365 विकास जीवनचक्र.

समस्‍या निवारण

यदि आप Dev Tunnel के माध्यम से परीक्षण करते समय समस्याओं का सामना कर रहे हैं, तो सामान्य टनल, कनेक्टिविटी और एंडपॉइंट समाधान के लिए यहां से शुरू करें। व्यापक Agent 365 समस्या निवारण (सेटअप, प्रमाणीकरण, और संदेश) के लिए, समस्या निवारण देखें।

टनल कनेक्शन विफल

लक्षण: Dev Tunnel शुरू नहीं होती है या तुरंत डिस्कनेक्ट हो जाती है।

समाधान:

• सत्यापित करें कि आपने लॉग इन किया है: devtunnel user login
• जांचें कि क्या कोई अन्य प्रक्रिया उसी पोर्ट का उपयोग कर रही है
• सुनिश्चित करें कि आपका फ़ायरवॉल देव टनल कनेक्शनों की अनुमति देता है
• सुरंग हटाएं और फिर से बनाएं: devtunnel delete <tunnel-id> फिर एक नया बनाएं

संदेश स्थानीय एजेंट तक नहीं पहुंचते हैं

लक्षण: Microsoft 365 इंगित करता है कि संदेश भेजा गया था, लेकिन आपके स्थानीय एजेंट को यह प्राप्त नहीं होता है।

समाधान:

• पुष्टि करें कि आपका एजेंट स्थानीय रूप से चल रहा है
• सत्यापित करें कि सुरंग सक्रिय है: devtunnel list "कनेक्टेड" दिखाना चाहिए
• a365.config.json में एंडपॉइंट कॉन्फ़िगरेशन की जांच करें और सुनिश्चित करें कि आपका Dev Tunnel URL मैसेजिंग एंडपॉइंट के रूप में सेट है
• कनेक्शन त्रुटियों के लिए चल रहे devtunnel host टर्मिनल में Dev Tunnel लॉग की समीक्षा करें
• सुनिश्चित करें कि आपका स्थानीय पोर्ट टनल पोर्ट से मेल खाता है (दोनों डिफ़ॉल्ट रूप से 3978 होने चाहिए)

Dev Tunnel के दौरान प्रमाणीकरण त्रुटियां

लक्षण: Dev Tunnel के ज़रिए परीक्षण के दौरान 401 या 403 त्रुटियां।

समाधान:

• सत्यापित करें कि एजेंट प्रमाणीकरण कॉन्फ़िगर किया गया है (bearer टोकन प्रमाणीकरण Microsoft 365 एकीकरण के लिए Dev Tunnels के साथ काम नहीं करता है)।
• एजेंट ब्लूप्रिंट के क्रेडेंशियल्स a365.generated.config.json में जाँचें।
• पुष्टि करें कि आपके एजेंट के पास आपके द्वारा परीक्षण किए जा रहे कार्यों के लिए आवश्यक अनुमतियाँ हैं।
• सुनिश्चित करें कि आपके प्रमाणीकरण टोकन समाप्त नहीं हुए हैं।

Tunnel URL बदल गया है या समाप्त हो गया है

लक्षण: पूर्व में कार्य कर रहा टनल URL अब आपके एजेंट तक नहीं पहुँचता।

समाधान:

• devtunnel list का उपयोग करके सुरंग की स्थिति की जाँच करें।
• devtunnel host <tunnel-id> का उपयोग करके सुरंग को पुनरारंभ करें।
• यदि URL बदल गया है, तो a365 setup blueprint --endpoint-only का उपयोग करके मैसेजिंग एंडपॉइंट को अपडेट करें।