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

एजेंट ब्लूप्रिंट आपके एजेंट की पहचान, अनुमतियाँ और अवसंरचना आवश्यकताओं को परिभाषित करता है। इस एजेंट ब्लूप्रिंट से प्रत्येक एजेंट इंस्टेंस बनाएं।

नोट

रजिस्टर, Work IQ और एआई टीममेट क्षमताओं को सक्षम करने के लिए एजेंट ब्लूप्रिंट स्थापित करना आवश्यक है। यह समझने के लिए कि आपके एजेंट पर कौन सी क्षमताएँ लागू होती हैं, Agent 365 विकास के साथ आरंभ करें देखें।

Agent 365 पहचान के बारे में अधिक जानकारी के लिए Agent 365 पहचान देखें।

आवश्यकताएँ

शुरू करने से पहले, पक्का कर लें कि आपके पास ये ज़रूरी चीज़ें हैं:

  1. Agent 365 CLI - Agent 365 CLI इंस्टॉलेशन देखें.

  2. आवश्यक अनुमतियाँ:

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

    टिप

    एजेंट (एआई टीममेट नहीं) को कॉन्फ़िगरेशन फ़ाइल की आवश्यकता नहीं है। a365 setup all --agent-name <name> का उपयोग करें और CLI आपके टैनेंट और क्लाइंट ऐप को स्वचालित रूप से पहचानता है। एआई टीममेट सेटअप के लिए मैन्युअल रूप से बनाए गए a365.config.json की आवश्यकता है।

एजेंट ब्लूप्रिंट बनाएं

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

सेटअप चलाएँ

सेटअप कमांड चलाएँ:

a365 setup -h

कमांड में विभिन्न विकल्प हैं। आप संपूर्ण सेटअप को a365 setup all द्वारा एक ही कमांड में पूरा कर सकते हैं या अधिक विस्तृत विकल्प चुन सकते हैं।

नोट

a365 setup all डिफ़ॉल्ट रूप से ब्लूप्रिंट एजेंट मोड में होता है। इसके बजाय एआई टीममेट एजेंट सेट करने के लिए --aiteammate प्रविष्ट करें। M365 एजेंटों (Teams, Copilot) के लिए, मैसेजिंग एंडपॉइंट को स्वचालित रूप से पंजीकृत करने के लिए --m365 भी प्रविष्ट करें।

एजेंट सेटअप (डिफ़ॉल्ट):

# With a config file
a365 setup all

# Config-free — no a365.config.json needed
a365 setup all --agent-name <your-agent-name>

M365 एजेंट सेटअप (Teams/Copilot):

# Registers the messaging endpoint via MCP Platform
a365 setup all --m365

AI टीममेट सेटअप:

a365 setup all --aiteammate

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

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

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

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

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

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

    प्लेटफ़ॉर्म द्वारा स्वीकार किए जाने के लिए ब्लूप्रिंट में managerApplications सेट होना चाहिए। सीएलआई इसे स्वचालित रूप से सेट करता है। यदि आपके पास कोई मौजूदा ब्लूप्रिंट है जो इस आवश्यकता के लागू होने से पहले बनाया गया था, तो उसे हटा दें और a365 setup all को फिर से चलाएं, या उसे Graph API के माध्यम से मैन्युअली पैच करें।

  3. API अनुमतियाँ कॉन्फ़िगर करता है:

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

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

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

नोट

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

एजेंट आईडी डेवलपर द्वारा सेटअप

यदि आप एजेंट ID Developer (Global Administrator नहीं) के रूप में चलाते हैं, तो a365 setup all अधिकांश चरणों को स्वचालित रूप से पूरा करता है, लेकिन OAuth2 अनुमति अनुदान के लिए एक अलग Global Administrator चरण की आवश्यकता होती है।

कौन से चरण स्वचालित रूप से पूरे किए जाते हैं:

  • Azure इन्फ्रास्ट्रक्चर (रिसोर्स ग्रुप, ऐप सर्विस प्लान, वेब ऐप)
  • एजेंट ब्लूप्रिंट पंजीकरण
  • एजेंट इंस्टेंस के लिए इनहेरिटेबल अनुमतियाँ

कौन से चरणों के लिए वैश्विक व्यवस्थापक की आवश्यकता होती है:

  • OAuth2 डेलीगेटेड परमिशन ग्रांट (AllPrincipals सहमति) Microsoft Graph, Agent 365 Tools, Messaging बॉट API, Observability API, और Power Platform API के लिए

गैर-व्यवस्थापक खाते का उपयोग करके सेटअप कैसे पूरा करें:

चरण कौन कार्यवाही
1 डेवलपर a365 setup all चलाएँ. CLI जितने चरण पूरे कर सकता है, उन्हें पूरा करता है और अगले चरण दिखाता है, जिसमें एक सहमति URL भी शामिल है जिसे वैश्विक व्यवस्थापक को खोलना है।
2 डेवलपर CLI आउटपुट में दिए गए सहमति URL को अपने वैश्विक व्यवस्थापक के साथ साझा करें।
3 ग्लोबल व्यवस्थापक वैश्विक व्यवस्थापक के रूप में साइन इन किए गए ब्राउज़र में सहमति URL खोलें और अनुरोधित अनुमतियाँ प्रदान करें।

कमांड चलाना:

# Developer runs:
a365 setup all
# Setup completes all steps it can. The CLI prints the next steps
# for a Global Administrator directly in the output, including a
# direct link or consent URL they can open to complete the grants.

सीएलआई द्वारा प्रदर्शित अगले चरणों को अपने वैश्विक व्यवस्थापक के साथ साझा करें। वे OAuth2 अनुमतियाँ पूरा करने के लिए दिए गए लिंक या सहमति URL को खोल सकते हैं।

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

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

  1. जेनरेट किए गए कॉन्फ़िगरेशन की जाँच करें:

    अपने कार्यशील निर्देशिका में a365.generated.config.json को खोलें। या PowerShell का उपयोग करें:

    Get-Content a365.generated.config.json | ConvertFrom-Json

    अपेक्षित आउटपुट में ये महत्वपूर्ण मान शामिल हैं:

    {
"managedIdentityPrincipalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintObjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintServicePrincipalObjectId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"agentBlueprintClientSecret": "xxx~xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"agentBlueprintClientSecretProtected": true,
"botId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"botMsaAppId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"messagingEndpoint": "https://your-app.azurewebsites.net/api/messages",
"resourceConsents": [],
"completed": true,
"completedAt": "xxxx-xx-xxTxx:xx:xxZ",
"cliVersion": "x.x.xx"
}

    सत्यापित करने के लिए मुख्य फ़ील्ड:

    क्षेत्र उद्देश्य क्या सत्यापित करें
    managedIdentityPrincipalId Azure प्रबंधित पहचान प्रमाणीकरण एक मान्य GUID होना चाहिए
    agentBlueprintId आपके एजेंट का विशिष्ट पहचानकर्ता डेवलपर पोर्टल और व्यवस्थापक केंद्र में उपयोग किया जाता है
    agentBlueprintObjectId ब्लूप्रिंट की Microsoft Entra ID
    messagingEndpoint संदेश रूटिंग वह स्थान जहाँ Teams/Outlook आपके एजेंट को संदेश भेजते हैं
    agentBlueprintClientSecret प्रमाणीकरण सीक्रेट मौजूद होना चाहिए (मान छुपा हुआ है)
    resourceConsents API अनुमतियाँ इसमें Microsoft Graph, Agent 365 Tools, Messaging बॉट API, Observability API जैसे संसाधन शामिल होने चाहिए
    completed सेटअप की स्थिति होना चाहिए true

    नोट

    यदि आपने सेटअप को एजेंट आईडी व्यवस्थापक या एजेंट आईडी डेवलपर के रूप में चलाया है, तो resourceConsents खाली रह सकता है और completedfalse प्रदर्शित कर सकता है, जब तक कि कोई ग्लोबल एडमिनिस्ट्रेटर CLI द्वारा प्रदर्शित अगले चरणों का उपयोग करके OAuth2 अनुमति अनुदान पूर्ण नहीं कर देता।

  2. Azure संसाधनों को Azure Portal में सत्यापित करें:

    या az resource list PowerShell कमांड का उपयोग करें।

    # List all resources in your resource group
az resource list --resource-group <your-resource-group> --output table

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

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

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

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

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

    • वेब ऐप्स:

      • ऐप सेवाएँ>वेब ऐप्स में जाएँ
      • अपना वेब ऐप खोजें, फिर सेटिंग्स>पहचान>सिस्टम असाइन किया गया में जाएँ
      • सत्यापित करें कि स्थिति चालू है
      • ध्यान दें कि Object (principal) ID managedIdentityPrincipalId से मेल खाता है

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

    Azure Active Directory>ऐप पंजीकरण>सभी अनुप्रयोग पर जाएँ:

    • अपने एजेंट ब्लूप्रिंट के लिए खोजें agentBlueprintId

    • एप्लिकेशन खोलें और API अनुमतियाँ चुनें

    • सत्यापित करें कि अनुमतियाँ हरे चेकमार्क के साथ स्वीकृत हैं:

      • Microsoft Graph (प्रत्यायोजित और अनुप्रयोग अनुमतियाँ)
      • मैसेजिंग बॉट एपीआई अनुमतियाँ

    • सभी अनुमतियाँ "अनुमतियाँ [आपके टैनेंट] के लिए दी गई" दिखाती हैं

  4. जनरेट की गई कॉन्फ़िगरेशन फ़ाइल को सत्यापित करें:

    आपके पास एक फाइल होनी चाहिए जिसका नाम a365.generated.config.json है और जिसमें सभी कॉन्फ़िगरेशन डेटा मौजूद है।

    Test-Path PowerShell आदेश का उपयोग करके जांचें कि वह मौजूद है।

    # Check file exists
Test-Path a365.generated.config.json
# Should return: True

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

    दोनों a365.config.json और a365.generated.config.json फ़ाइलों को सहेजें। परिनियोजन और समस्या निवारण के लिए आपको इन मानों की आवश्यकता है।

  5. सत्यापित करें कि वेब अनुप्रयोग में प्रबंधित पहचान सक्षम है:

    यह जांचने के लिए az webapp identity show कमांड का उपयोग करें कि प्रबंधित पहचान सक्षम है या नहीं।

    az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

    अपेक्षित:

    {
"principalId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tenantId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"type": "SystemAssigned"
}

  6. Microsoft Entra में रजिस्टर्ड एजेंट ब्लूप्रिंट को वेरिफ़ाई करें:

    Microsoft Entra व्यवस्थापन केंद्र में, अपना agentBlueprintId खोजें या नाम से खोजें।

    सुनिश्चित करें कि:

    ✅ ऐप पंजीकरण और एंटरप्राइज़ एप्लिकेशन दिखते हैं
    ✅ ऐप पंजीकरण ब्लूप्रिंट में, API अनुमतियां टैब में सभी अनुमतियां दिखाई देती हैं
    ✅ स्थिति में दिखता है "अनुमतियाँ [आपके टैनेंट] के लिए दी गई"

ज़्यादा मदद के लिए, देखें:

एजेंट अनुमतियाँ

ऐप्स और एजेंट Microsoft 365 डेटा (उपयोगकर्ता, मेल, फ़ाइलें, Teams, एजेंट आदि) पढ़ या लिख सकें, उससे पहले आपको उन्हें विशेष रूप से Microsoft Graph अनुमतियाँ प्रदान करनी होंगी। Microsoft Graph अनुमतियाँ वह प्राधिकरण मॉडल हैं जो नियंत्रित करती हैं कि Microsoft 365 और Microsoft Entra ID में Microsoft Graph API के माध्यम से कोई ऐप या सेवा किस डेटा और किन क्रियाओं तक पहुँच सकती है।

अधिक जानें: Microsoft Graph अनुमतियों का ओवरव्यू

Agent 365 एजेंट इंस्टेंस के लिए Graph अनुमतियों का उपयोग करने के लिए, डेवलपर को उन्हें एजेंट ब्लूप्रिंट में घोषित करना होगा। जब कोई व्यवस्थापक Microsoft 365 व्यवस्थापन केंद्र में ब्लूप्रिंट को सक्रिय करता है, तो पोर्टल ब्लूप्रिंट की ग्राफ़ अनुमतियों की समीक्षा करता है और व्यवस्थापक को उनके लिए सहमति देने के लिए प्रॉम्प्ट देता है।

यह समझने और सत्यापित करने के लिए कि ग्राफ़ अनुमतियाँ आपके एजेंट को कैसे सक्षम करती हैं, आप यह कर सकते हैं:

अपने ब्लूप्रिंट पर अनुमतियाँ लागू करें

उपयोग करें a365 setup permissions custom Microsoft Entra में अपने Blueprint पर कस्टम API अनुमतियाँ इनलाइन लागू करने के लिए।

a365 setup permissions custom `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Mail.Read,Mail.Send,Chat.Read,Chat.ReadWrite,Chat.Create,User.Read

कस्टम अनुमतियों को कॉन्फ़िगर करने और हटाने के बारे में पूरी जानकारी के लिए, देखें setup permissions custom।

अगले चरण

अपने एजेंट कोड को क्लाउड पर परिनियोजित करें:

Azure

Amazon Web Services (AWS)

Google Cloud Platform (GCP)

एजेंट को Microsoft व्यवस्थापन केंद्र पर प्रकाशित करें

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

इस अनुभाग में एजेंट ब्लूप्रिंट सेट करते समय सामान्य समस्याओं का विवरण प्रस्तुत किया गया है।

टिप

Agent 365 समस्या निवारण मार्गदर्शिका में उच्च-स्तरीय समस्या निवारण अनुशंसाएँ, सर्वोत्तम प्रथाएँ, और Agent 365 विकास जीवनचक्र के प्रत्येक भाग के लिए समस्या निवारण सामग्री के लिंक शामिल हैं.

ये समस्याएँ कभी-कभी पंजीकरण के दौरान होती हैं:

अपर्याप्त अनुमतियाँ त्रुटि

लक्षण:a365 setup कमांड निष्पादन के दौरान अपर्याप्त अनुमतियाँ त्रुटि.

आपको अपने Microsoft Entra टेनेंट में निम्न भूमिकाओं में से एक की आवश्यकता है:

  • ग्लोबल व्यवस्थापक
  • एजेंट आईडी डेवलपर

और Azure सदस्यता में योगदानकर्ता या स्वामी की पहुँच।

समाधान: सत्यापित करें कि आपके पास Microsoft Entra में आवश्यक अनुमतियाँ हैं।

नोट

यदि आपके पास एजेंट ID Administrator या Agent ID Developer की भूमिका है (Global Administrator नहीं), a365 setup all फिर भी सफल होता है लेकिन OAuth2 अनुमति अनुदान को छोड़ देता है। सेटअप पूरा होने के बाद, CLI शेष अनुदानों को पूरा करने के लिए वैश्विक व्यवस्थापक के लिए अगले चरण दिखाता है। यह वर्कफ़्लो उन संगठनों के लिए अपेक्षित है जहाँ एजेंट डेवलपर और ग्लोबल एडमिनिस्ट्रेटर अलग-अलग व्यक्ति होते हैं।

अनुपस्थित Azure CLI प्रमाणीकरण

लक्षण: सेटअप प्रमाणीकरण त्रुटियों के कारण विफल हो जाता है।

समाधान: सुनिश्चित करें कि आप Azure से जुड़े हैं और अपना खाता और सदस्यता सत्यापित करें।

# Authenticate with Azure
az login

# Verify correct account and subscription
az account show

संसाधन पहले से मौजूद है

लक्षण: संसाधन समूह, अनुप्रयोग सेवा योजना या वेब अनुप्रयोग के लिए त्रुटि के साथ Resource already exists सेटअप विफल हो जाता है.

समाधान: निम्नलिखित में से कोई एक समाधान चुनें।

  • मौजूदा संसाधनों का उपयोग करें

    यदि संसाधन पहले से मौजूद हैं और आप उनका उपयोग करना चाहते हैं, तो सुनिश्चित करें कि वे आपके कॉन्फ़िगरेशन के अनुरूप हैं। az resource list PowerShell कमांड का उपयोग करें।

    az resource list --resource-group <your-resource-group>

  • परस्पर विरोधी संसाधनों को हटाएँ

    संसाधन समूह हटाएं या a365.config.json में अपने संसाधनों का नाम बदलें और सेटअप को पुनः चलाएं।

    संसाधन समूह को हटाने के लिए az group delete PowerShell कमांड का उपयोग करें।

    # WARNING: This command deletes all resources in it
az group delete --name <your-resource-group>

  • नए सिरे से शुरू करने के लिए क्लीनअप कमांड का उपयोग करें

    सभी Agent 365 संसाधनों को हटाने के लिए cleanup कमांड का उपयोग करें, फिर सेटअप को पुनः चलाने के लिए a365 setup all कमांड का उपयोग करें।

    चेतावनी

    a365 cleanup को चलाना विनाशकारी है।

    a365 cleanup
a365 setup all

लक्षण: आपने सेटअप के दौरान ब्राउज़र विंडो खोलीं लेकिन सहमति पूरी किए बिना बंद कर दीं, या सेटअप पूरा हो गया लेकिन OAuth2 अनुमतियाँ अभी भी लंबित हैं।

समाधान: अपनी भूमिका के आधार पर चुनें:

  • वैश्विक प्रशासक: चलाएँ a365 setup all फिर से. CLI व्यवस्थापक की सहमति के लिए अनुरोध करता है। जो ब्राउज़र विंडो दिखाई देती है उसमें सहमति प्रक्रिया को पूरा करें।

  • एजेंट आईडी एडमिन या डेवलपर: आप सीधे OAuth2 अनुदान पूरा नहीं कर सकते। a365 setup all चलाएँ — सेटअप सारांश वैश्विक व्यवस्थापक के लिए अगले चरणों को दिखाता है, जिसमें अनुदान को पूरा करने के लिए एक सीधा लिंक या सहमति URL शामिल है। उन विवरणों को अपने वैश्विक व्यवस्थापक के साथ साझा करें।

कॉन्फ़िगरेशन फ़ाइलें गायब या अमान्य हैं

लक्षण: सेटअप "कॉन्फ़िगरेशन नहीं मिला" या सत्यापन त्रुटियों के साथ विफल रहता है।

समाधान:

  1. सत्यापित करें कि a365.config.json फ़ाइल मौजूद है।
  2. यदि गुम या अमान्य है, तो इसे मैन्युअल रूप से बनाएं या a365 setup all --agent-name <name> का उपयोग करें (सिर्फ एजेंट के लिए)।
# Verify a365.config.json exists
Test-Path a365.config.json

सेटअप पूरा हो जाता है लेकिन संसाधन नहीं बनाए जाते हैं

लक्षण: सेटअप कमांड सफल होता है लेकिन Azure संसाधन नहीं बने हैं।

समाधान:

  1. अपनी कार्यशील निर्देशिका में a365.generated.config.json खोलें और बनाए गए संसाधनों की जाँच करें।
  2. Azure संसाधनों का अस्तित्व az resource list कमांड का उपयोग करके जांचें।
  3. यदि संसाधन गायब हैं, तो सेटअप आउटपुट में त्रुटियों की जाँच करें और a365 setup all कमांड का उपयोग करके सेटअप को पुनः चलाएँ।
# Check created resources
Get-Content a365.generated.config.json | ConvertFrom-Json

# Verify Azure resources exist
az resource list --resource-group <your-resource-group> --output table

# If resources missing, check for errors in setup output and re-run
a365 setup all

एजेंट ब्लूप्रिंट को Microsoft Entra में पंजीकृत नहीं किया गया है

लक्षण: सेटअप पूरा हो जाता है, लेकिन Microsoft Entra व्यवस्थापन केंद्र में एजेंट ब्लूप्रिंट उपलब्ध नहीं है।

समाधान:

  1. a365.generated.config.json से ब्लूप्रिंट ID पाएं।

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Microsoft Entra व्यवस्थापन केंद्र में खोजें:

    1. Microsoft Entra व्यवस्थापन केंद्र पर जाएँ.
    2. ऐप पंजीकरण>सभी एप्लिकेशन पर जाएँ।
    3. अपने agentBlueprintId की खोज करें।

  3. यदि नहीं मिला, तो a365 setup all कमांड का उपयोग करके सेटअप को फिर से चलाएँ।

    a365 setup all

एपीआई अनुमतियां नहीं दी गईं

लक्षण: सेटअप पूरा हो जाता है, लेकिन अनुमतियाँ Microsoft Entra में "प्रदान नहीं की गई" के रूप में दिखाई देती हैं।

समाधान:

  1. Microsoft Entra व्यवस्थापन केंद्र खोलें।

  2. अपना एजेंट ब्लूप्रिंट ऐप पंजीकरण ढूंढें।

  3. API अनुमतियाँ पर जाएँ.

  4. अनुदान व्यवस्थापक सहमति:

    1. व्यवस्थापक सहमति प्रदान करें [आपके टैनेंट] के लिए का चयन करें.
    2. कार्रवाई की पुष्टि करें.

  5. सत्यापित करें कि सभी अनुमतियाँ हरे रंग के चेकमार्क दिखाती हैं।

मैनेज्ड आइडेंटिटी इनेबल नहीं है

लक्षण: वेब अनुप्रयोग मौजूद है, लेकिन प्रबंधित पहचान सक्षम नहीं है.

समाधान:

  1. az webapp identity show कमांड का उपयोग करके प्रबंधित पहचान की स्थिति जांचें।
  2. यदि सक्षम नहीं है, तो az webapp identity assign कमांड का उपयोग करके इसे मैन्युअल रूप से सक्षम करें।
  3. सत्यापित करें कि यह az webapp identity show कमांड का उपयोग करके सक्षम है।
# Check managed identity status
az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

# If not enabled, enable it manually
az webapp identity assign --name <your-web-app> --resource-group <your-resource-group>

# Verify it's enabled
az webapp identity show --name <your-web-app> --resource-group <your-resource-group>

सेटअप में बहुत अधिक समय लगता है या प्रत्युत्तर देना बंद हो जाता है

लक्षण: सेटअप कमांड 10 मिनट से अधिक समय तक चलता है और पूरा नहीं होता।

समाधान:

  1. अगर आप ग्लोबल एडमिनिस्ट्रेटर के रूप में काम कर रहे हैं, तो जांचें कि ब्राउज़र विंडो व्यवस्थापक की सहमति की प्रतीक्षा कर रही है या नहीं। सेटअप को अनब्लॉक करने के लिए सहमति प्रवाह को पूरा करें।

  2. यदि सेटअप वास्तव में प्रतिक्रिया देना बंद कर देता है, तो इसे रद्द करें (Ctrl+C) और जांचें कि क्या बनाया गया था।

    # Check generated config
Get-Content a365.generated.config.json | ConvertFrom-Json

# Check Azure resources
az resource list --resource-group <your-resource-group>

  3. साफ़ करें और पुनः प्रयास करें।

    a365 cleanup
a365 setup all

एक कॉन्फ़िगरेशन-मुक्त एजेंट को साफ़ करें

लक्षण: आपने a365 setup all --agent-name <name> का उपयोग करके एक एजेंट स्थापित किया है और अब उसे हटाना चाहते हैं, लेकिन आपके पास a365.config.json फ़ाइल नहीं है।

समाधान: कॉन्फ़िगरेशन फ़ाइल के बिना एजेंट को हटाने के लिए a365 cleanup --agent-name का उपयोग करें। CLI बूटस्ट्रैप सेटअप के दौरान लिखा गया था जो वैश्विक जनरेट किए गए कॉन्फ़िगरेशन से संसाधन IDs पढ़ता है।

a365 cleanup --agent-name <your-agent-name>

टिप

यदि कमांड प्रमाणीकरण पर रुक जाता है, तो यह स्वचालित रूप से डिवाइस कोड प्रवाह पर वापस आ जाता है। साइन-इन पूरा करने के लिए टर्मिनल में मुद्रित निर्देशों का पालन करें।

अगर आपके पास अब ग्लोबल जेनरेटेड कॉन्फ़िगरेशन नहीं है (जैसे, CLI को फिर से इंस्टॉल करने के बाद), तो a365 cleanup का इस्तेमाल मैन्युअली बनाए गए मिनिमल a365.config.json के साथ करें, या Azure Portal और Microsoft Entra व्यवस्थापन केंद्र के ज़रिए सीधे रिसोर्स हटा दें।

Teams में पहला संदेश भेजने में असमर्थ

लक्षण: एजेंट इंस्टेंस का प्रावधान करने के बाद: वह एजेंट मैनेजर को स्वागत संदेश नहीं भेज सकता है।

समाधान: एक नया चैट ऑब्जेक्ट बनाने के लिए [Chat.Create][perm-chatcreate] अनुमति आवश्यक है। यदि एक-पर-एक चैट पहले से मौजूद है, तो यह ऑपरेशन मौजूदा चैट को लौटाता है और कोई नई चैट नहीं बनाता।

  • कार्यान्वयन के लिए, अपने ब्लूप्रिंट की इनहेरिटेबल अनुमतियों में Chat.Create स्कोप शामिल करने के लिए कॉन्फ़िगर करें।
  • एजेंट इंस्टेंस का प्रावधान होने के बाद भेजने के लिए Teams चैट संदेश कॉन्फ़िगर करें।
  • ब्लूप्रिंट से एक नया एजेंट इंस्टेंस बनाएं और प्रथम रन संदेश का परीक्षण करें।
  • पिछली बार को अपडेट किया गया