एजेंट ब्लूप्रिंट और इंस्टेंस सेटअप

महत्त्वपूर्ण

Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।

नोट

एजेंट पहचान प्रमाणीकरण दो प्रमाणीकरण प्रवाहों में से एक है जिसका आप उपयोग कर सकते हैं। दूसरा ऑन-बेरिफ-ऑफ (ओबीओ) प्रवाह है।

एजेंटिक प्रमाणीकरण प्रवाह एक एजेंट को अपनी पहचान के साथ कार्य करने में सक्षम बनाता है। इस प्रवाह में:

• एजेंट अपने स्वयं के क्रेडेंशियल्स (एजेंट ब्लूप्रिंट क्रेडेंशियल्स) का उपयोग करके प्रमाणित करता है
• एजेंट अपनी स्वयं की असाइन की गई अनुमतियों के साथ स्वतंत्र रूप से काम करता है
• एजेंट की अपनी पहचान होती है, जो किसी भी उपयोगकर्ता से अलग होती है
• यह प्रवाह स्वायत्त एजेंट संचालन के लिए आदर्श है जिसके लिए उपयोगकर्ता संदर्भ की आवश्यकता नहीं होती है

बक्सों का इस्तेमाल करें:

• स्वायत्त एजेंट संचालन (अनुसूचित कार्य, निगरानी)
• एजेंट के मेलबॉक्स से ईमेल भेजना या मीटिंग बनाना
• एजेंट के स्वामित्व वाले संसाधनों का निर्माण और प्रबंधन
• उपयोगकर्ता इंटरैक्शन के बिना पृष्ठभूमि प्रसंस्करण

अपनी एजेंट पहचान बनाएं

एजेंट प्रमाणीकरण के साथ अपने एजेंट को विकसित और परीक्षण करने के लिए, आपको एजेंट पहचान बनाने और इसे Microsoft 365 के साथ पंजीकृत करने की आवश्यकता है। यह पहचान आपको अपने एजेंट की क्षमताओं जैसे टूलींग, अवलोकन क्षमता और सूचनाओं का परीक्षण करने की अनुमति देती है क्योंकि आप उन्हें बनाते हैं।

एजेंट निर्माण प्रक्रिया में तीन प्रमुख चरण शामिल हैं:

1. कॉन्फ़िगर करें - एजेंट 365 CLI कॉन्फ़िगरेशन प्रारंभ करें
2. सेटअप - Azure संसाधन और एजेंट ब्लूप्रिंट बनाएं
3. उदाहरण बनाएं - एजेंट ऐप आईडी और उपयोगकर्ता बनाएं

पूर्वावश्यकताएँ

इससे पहले कि आप प्रारंभ करें, यह सुनिश्चित करें कि आपके पास निम्न सेट अप मौजूद हैं:

• एजेंट 365 सीएलआई - एजेंट 365 सीएलआई स्थापना देखें

अनुमतियाँ आवश्यक हैं

• निम्न भूमिकाओं में से एक के साथ मान्य टैनेंट उपयोगकर्ता:
  • ग्लोबल व्यवस्थापक
  • एजेंट आईडी प्रशासक
  • एजेंट आईडी डेवलपर
• संसाधन बनाने की अनुमतियों के साथ Azure सदस्यता तक पहुँच

चरण 1: एजेंट 365 सीएलआई को कॉन्फ़िगर करें

a365 config init कमांड बनाता हैa365.config.json, सभी एजेंट 365 सीएलआई कमांड द्वारा उपयोग की जाने वाली केंद्रीय कॉन्फ़िगरेशन फ़ाइल। CLI मैन्युअल इनपुट को कम करने के लिए Azure CLI एकीकरण और स्मार्ट डिफ़ॉल्ट के साथ एक इंटरैक्टिव विज़ार्ड प्रदान करता है।

Git के साथ प्रमाणित करें

कॉन्फ़िगरेशन प्रारंभ करने से पहले, कमांड का उपयोग करके az login Azure के साथ प्रमाणित करें:

az login

संकेत मिलने पर उपयुक्त सदस्यता का चयन करें। कॉन्फ़िगरेशन विज़ार्ड उपलब्ध सदस्यताओं, संसाधन समूहों और अनुप्रयोग सेवा योजनाओं को क्वेरी करने के लिए Azure CLI का उपयोग करता है.

प्रारंभ करें; आधार; कॉन्फ़िगरेशन

सहभागी कॉन्फ़िगरेशन विज़ार्ड को प्रारंभ करने के लिए निम्न आदेश चलाएँ:

a365 config init

विज़ार्ड मैन्युअल इनपुट को कम करने के लिए Azure CLI एकीकरण और स्मार्ट डिफ़ॉल्ट का उपयोग करता है। आपको इसके लिए संकेत दिया जाएगा:

क्षेत्र	विवरण	उदाहरण
एजेंट का नाम	एक अद्वितीय पहचानकर्ता (केवल अल्फ़ान्यूमेरिक)	myagent
परिनियोजन परियोजना पथ	आपके एजेंट प्रोजेक्ट निर्देशिका का पथ	C:\MyAgent\sample-agent
प्रबंधक ईमेल	इस एजेंट की देखरेख करने वाले प्रबंधक का ईमेल	manager@yourtenant.onmicrosoft.com
Azure संसाधन	मौजूदा संसाधन समूहों और अनुप्रयोग सेवा योजनाओं में से चयन करें	(इंटरएक्टिव चयन)

विज़ार्ड स्वचालित रूप से संबंधित संसाधन नाम, पहचान जनरेट करता है और आपके प्रोजेक्ट प्रकार को सत्यापित करता है.

उपलब्धता सीमा

इस समय केवल समर्थित Azure क्षेत्र हैं:

• centralindia
• westeurope
• westus

यदि आप किसी भिन्न क्षेत्र का चयन करते हैं, या यदि आप फ़ाइल में a365.config.json गुण को location मैन्युअल रूप से संपादित करते हैं, तो आप एक एजेंट ब्लूप्रिंट बनाने का प्रयास करते समय आपको निम्न त्रुटि दिखाई देगी।

The selected region ('{location}') is not supported by the Agent 365 CLI. Choose a supported region and ensure your web app name ('{webAppName}') is globally unique

कॉन्फ़िगरेशन फ़ाइल संरचना के बारे में अधिक जानें

कॉन्फ़िगरेशन सत्यापित करें

सभी मान सही हैं यह सत्यापित करने के लिए अपना कॉन्फ़िगरेशन प्रदर्शित करने के लिए आदेश का a365 config display उपयोग करें:

a365 config display

चरण 2: एजेंट ब्लूप्रिंट बनाएं

a365 setup कमांड Azure संसाधन बनाता है और आपके एजेंट ब्लूप्रिंट को पंजीकृत करता है। ब्लूप्रिंट आपके एजेंट की पहचान, अनुमतियों और बुनियादी ढांचे की आवश्यकताओं को परिभाषित करता है। यह चरण Azure में आपके एजेंट को तैनात करने और चलाने के लिए आधार स्थापित करता है।

सेटअप चलाएँ

सेटअप कमांड निष्पादित करें:

a365 setup

सेटअप प्रक्रिया इन कार्रवाइयों को करती है:

1. Azure इन्फ्रास्ट्रक्चर बनाता है (यदि यह पहले से मौजूद नहीं है):

   • संसाधन समूह
   • निर्दिष्ट SKU के साथ ऐप सेवा योजना
   • प्रबंधित पहचान सक्षम के साथ Azure Web App

2. रजिस्टर एजेंट ब्लूप्रिंट:

   • आपके Microsoft Entra टेनेंट में एजेंट ब्लूप्रिंट बनाता है
   • Microsoft Entra अनुप्रयोग पंजीकरण बनाता है
   • आवश्यक अनुमतियों के साथ एजेंट पहचान कॉन्फ़िगर करता है

3. API अनुमतियों को कॉन्फ़िगर करें

   • Microsoft ग्राफ़ API क्षेत्र सेट करता है
   • मैसेजिंग बॉट एपीआई अनुमतियों को कॉन्फ़िगर करता है
   • एजेंट आवृत्तियों के लिए इनहेरिट करने योग्य अनुमतियाँ लागू करता है

4. कॉन्फ़िगरेशन फ़ाइलों को अपडेट करें:

   • जेनरेट की गई आईडी और एंडपॉइंट को सहेजता है a365.generated.config.json
   • रिकॉर्ड प्रबंधित पहचान और संसाधन जानकारी

नोट

सेटअप के दौरान, व्यवस्थापक की सहमति के लिए ब्राउज़र विंडो खुलेंगी। आगे बढ़ने के लिए इन सहमति प्रवाहों को पूरा करें। सेटअप में आमतौर पर 3-5 मिनट लगते हैं और कॉन्फ़िगरेशन को ऑटो-सेव करता है a365.generated.config.json।

सेटअप सत्यापित करें

सेटअप सफलतापूर्वक पूरा होने के बाद, आपको सभी पूर्ण चरणों को दिखाने वाला एक सारांश देखना चाहिए। बनाए गए संसाधनों की जाँच करें:

1. जेनरेट किए गए कॉन्फ़िगरेशन देखें:

   a365 config display -g
   

   पुष्टि करें कि ये मान मौजूद हैं:

   • agentBlueprintId - आपके एजेंट ब्लूप्रिंट की एप्लिकेशन आईडी
   • agentBlueprintObjectId - ब्लूप्रिंट की Microsoft Entra ID
   • managedIdentityPrincipalId - सिस्टम-असाइन की गई प्रबंधित पहचान प्रिंसिपल आईडी

2. Azure पोर्टल में Azure संसाधनों की समीक्षा करें:

   सत्यापित करें कि निम्न संसाधन बनाए गए थे:

   • संसाधन समूह:

     • संसाधन समूह पर जाएँ → अपने संसाधन समूह का चयन करें
     • सत्यापित करें कि इसमें आपकी ऐप सेवा योजना और वेब ऐप शामिल हैं

   • ऐप सेवा योजना:

     • ऐप सेवाएँ>ऐप सेवा योजनाएँ पर जाएँ
     • अपनी योजना ढूंढें और सत्यापित करें कि मूल्य निर्धारण स्तर आपके कॉन्फ़िगरेशन SKU से मेल खाता है

   • वेब ऐप

     • अनुप्रयोग सेवाएँ>वेब अनुप्रयोग पर जाएँ
     • अपना वेब ऐप ढूंढें, फिर असाइन की गई सेटिंग>पहचान>प्रणाली पर जाएं
     • सत्यापित करें कि स्थिति चालू है
     • नोट ऑब्जेक्ट (प्रिंसिपल) ID से मेल खाता है managedIdentityPrincipalId

3. Azure पोर्टल में Microsoft Entra अनुप्रयोगों की जाँच करें:

   Azure Active Directory ऐप पंजीकरण पर जाएं।

   • अपने एजेंट ब्लूप्रिंट के लिए खोजें agentBlueprintId
   • एप्लिकेशन खोलें और API अनुमतियाँ चुनें
   • सत्यापित करें कि अनुमतियाँ हरे चेकमार्क के साथ दी गई हैं:
     • Microsoft ग्राफ़ (प्रत्यायोजित और अनुप्रयोग अनुमतियाँ)
     • मैसेजिंग बॉट एपीआई अनुमतियां
   • सभी अनुमतियाँ "[आपके किरायेदार] के लिए दी गई" दिखानी चाहिए

चरण 3: एजेंट इंस्टेंस बनाएं

a365 create-instance कमांड आपके एजेंट ब्लूप्रिंट के लिए एजेंटिक ऐप आईडी और एजेंट उपयोगकर्ता बनाता है, जो प्रमाणीकरण और अनुमतियों को सक्षम करता है। यह आपके एजेंट का अपनी पहचान और क्रेडेंशियल्स के साथ एक विशिष्ट उदाहरण बनाता है, जिससे यह आपके Microsoft 365 वातावरण में प्रमाणित और संचालित हो सकता है।

उदाहरण बनाएँ

निम्न आदेश चलाएँ:

a365 create-instance

यह क्या करता है:

1. इस एजेंट आवृत्ति के लिए agentic अनुप्रयोग ID - Microsoft Entra ID बनाता है
2. एजेंट उपयोगकर्ता बनाता है - एजेंट आवृत्ति के लिए सेवा प्रिंसिपल
3. एजेंट ब्लूप्रिंट आईडी का उपयोग करता है - जेनरेट किए गए कॉन्फ़िगरेशन से ()a365.generated.config.json
4. व्यवस्थापक सहमति प्रदान करता है - ब्लूप्रिंट से विरासत में मिली अनुमतियाँ स्वचालित रूप से लागू करता है
5. अद्यतन कॉन्फ़िगरेशन - स्थानीय वातावरण के लिए नए एजेंट क्रेडेंशियल्स सहेजता है

अपेक्षित आउटपुट:

आपको प्रत्येक चरण के लिए प्रगति संदेश दिखाई देंगे:

• चरण 1: एजेंट पहचान और एजेंट उपयोगकर्ता बनाना
• व्यवस्थापक सहमति अनुरोध (ब्राउज़र विंडो खुलेंगी)
• चरण 2: लाइसेंस असाइनमेंट
• कॉन्फ़िगरेशन अपडेट

इंस्टेंस सत्यापित करें

1. जेनरेट किए गए कॉन्फ़िगरेशन देखें:

   a365 config display -g
   

   सत्यापित करें कि निम्न मान मौजूद हैं:

   • AgenticAppId - आपका एजेंट इंस्टेंस एप्लिकेशन आईडी
   • AgenticUserId - आपका एजेंट उपयोगकर्ता आईडी

2. Azure पोर्टल में मान्य करें:

   • Azure Active Directory > ऐप पंजीकरण पर जाएं।
   • अपना एजेंट ऐप आईडी ढूंढें (आईडी के लिए जेनरेट किए गए कॉन्फ़िगरेशन की जांच करें)
   • सत्यापित करें कि एपीआई अनुमतियां दी गई हैं और सहमति दी गई हैं

अगले चरण

आपकी एजेंट पहचान अब पंजीकृत और तैयार है। अगला:

1. टूलींग क्षमताएं जोड़ें - Microsoft 365 उपकरण सक्षम करें (प्रमाणीकरण के परीक्षण के लिए अनुशंसित)
2. अपने एजेंट का परीक्षण करें - एजेंट प्लेग्राउंड के साथ मान्य करें