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

अपने एजेंट को पैकेज करने के लिए a365 publish कमांड का इस्तेमाल करें, और फिर पैकेज को Microsoft 365 व्यवस्थापक सेंटर पर अपलोड करें। प्रकाशन के बाद, आप अपने संगठन में एजेंट इंस्टेंस बना सकते हैं और एजेंट का प्रबंधन कर सकते हैं।

आवश्यकताएँ

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

ज़रूरी अकाउंट और अनुमतियाँ

• Microsoft 365 टैनेंट निम्नलिखित भूमिकाओं में से किसी एक के साथ (एडमिन सेंटर अपलोड चरण के लिए आवश्यक):

  • ग्लोबल व्यवस्थापक

आवश्यक उपकरण

• A365 CLI स्थापित (Agent 365 CLI)

आवश्यक सेटअप चरण

प्रकाशित करने से पहले, इन चरणों को पूरा करें:

1. एजेंट ब्लूप्रिंट बनाएं - अपना एजेंट ब्लूप्रिंट बनाने के लिए सेटअप चरण का पालन करें।
2. एजेंट का स्थानीय परीक्षण - सत्यापित करें कि आपका एजेंट Agents Playground टूल का उपयोग करके ठीक से काम करता है (एजेंट का स्थानीय परीक्षण देखें).
3. कॉन्फ़िगरेशन फ़ाइलें तैयार करें - सुनिश्चित करें कि a365.config.json और a365.generated.config.json अद्यतित हैं।

प्रकाशित करें आदेश

a365 publish कमांड चलाएँ:

a365 publish

नोट

a365 publish -h को चलाने पर यह कमांड जिन सभी विकल्पों का समर्थन करता है, वे दिखाए जाते हैं।

यह कमांड क्या करती है:

1. मैनिफ़ेस्ट अपडेट करें - manifest.json को आपके एजेंट ब्लूप्रिंट आईडी के साथ अपडेट किया जाता है।
2. पैकेज बनाएं - पैकेज manifest.json और आइकन manifest.zip में।
3. निर्देश प्रिंट करें - Microsoft 365 व्यवस्थापन केंद्र के माध्यम से अपलोड करने के लिए चरण-दर-चरण निर्देश प्रदर्शित करता है।

नोट

a365 publish कमांड एजेंटों और एआई टीमेट्स दोनों के लिए काम करता है। --agent-name (कॉन्फ़िग-फ्री) का उपयोग करके प्रावधान किए गए एजेंटों के लिए, सुनिश्चित करें कि a365.generated.config.json आपकी कार्यशील निर्देशिका में मौजूद हो, इससे पहले कि आप a365 publish चलाएँ, क्योंकि यह कमांड ब्लूप्रिंट आईडी इस फ़ाइल से पढ़ता है।

व्यवस्थापक सेंटर पर अपलोड करें

जब a365 publish पूरा हो जाए, अपने एजेंट को अपलोड करने के लिए मुद्रित निर्देशों का पालन करें:

1. Microsoft 365 व्यवस्थापन केंद्र पर जाएँ.
2. एजेंट>सभी एजेंट पर जाएं।
3. कस्टम एजेंट अपलोड करें चुनें.
4. अपने प्रोजेक्ट में manifest फ़ोल्डर से manifest.zip फ़ाइल अपलोड करें।

अधिक जानकारी के लिए, देखें Microsoft 365 व्यवस्थापक सेंटर में एजेंट अपलोड करें.

सफल प्रकाशन की पुष्टि करें

अपने एजेंट के सफलतापूर्वक प्रकाशित होने की पुष्टि के लिए निम्न चेकलिस्ट का उपयोग करें:

✅ CLI प्रकाशित सफल रहा
✅ manifest manifest.json और manifest.zip के साथ बनाया गया फ़ोल्डर
✅ एजेंट Microsoft व्यवस्थापक सेंटर में दिखाई देता है

CLI आउटपुट

पब्लिश कमांड सफल होने पर आप ये आउटपुट संदेश देखते हैं:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ चरण-दर-चरण अपलोड निर्देश प्रदर्शित

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

संभावित त्रुटियाँ:

त्रुटि	हल करने के लिए कदम
Agent blueprint ID not found	ब्लूप्रिंट सेटअप पूरा करने के लिए a365 setup चलाएँ।
Permissions missing	सेटअप को a365 setup permissions कमांड के साथ फिर से चलाएं।

प्रकाशन विफल होने पर इन चरणों का पालन करें।

मैनिफेस्ट फाइलें

आप परीक्षण-पथ PowerShell कमांड का इस्तेमाल करके manifest फ़ोल्डर में नीचे दी गई फ़ाइलों को टेस्ट कर सकते हैं।

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

नोट

अगर आपको ये फ़ाइलें नहीं दिखती हैं, तो a365 publish कमांड को फिर से चलाने की कोशिश करें।

एजेंट व्यवस्थापक केंद्र में दिखाई देता है

नोट

अपलोड करने के बाद, आपके एजेंट को व्यवस्थापक केंद्र और Teams में दिखाई देने में 5-10 मिनट लग सकते हैं। यह देरी सामान्य है।

इन चरणों का उपयोग करके पुष्टि करें कि एजेंट मौजूद है:

1. Microsoft 365 व्यवस्थापन केंद्र पर जाएँ.
2. एजेंट>सभी एजेंट पर जाएं।
3. आपका एजेंट सूची में दिखाई देता है।

निम्न तालिका दिखाती है कि आप कौन से विवरण पा सकते हैं:

क्षेत्र	क्या सत्यापित करें
नाम	एजेंट का नाम (manifest.json से लिया गया)
संस्करण	संस्करण संख्या (उदाहरण के लिए, 1.0.0)
प्रकाशक	आपके संगठन का नाम
उपलब्धता	उपलब्ध/सभी उपयोगकर्ता

ये भी देखें

• सेटअप एजेंट ब्लूप्रिंट
• एजेंट Teams में दिखाई नहीं देता है

अगले चरण

अपने एजेंट को प्रकाशित करने के बाद, एक इंस्टेंस बनाएँ ताकि आप इसे कॉन्फ़िगर कर सकें और अपने टैनेंट में उपयोग कर सकें।

एजेंट इंस्टेंस बनाएँ

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

Microsoft 365 व्यवस्थापन केंद्र में एजेंट प्रकाशित करने के दौरान आने वाली सामान्य समस्याएँ।

टिप

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

पब्लिश कमांड असफल हो जाता है

लक्षण:

• a365 publish के दौरान त्रुटि
• manifest.zip निर्मित नहीं हुआ है

मूल कारण:

• सेटअप पूरा नहीं हुआ है
• मेनिफ़ेस्ट सत्यापन त्रुटियाँ
• अपर्याप्त अनुमतियाँ

समाधान:

1. चेक करें कि सेटअप पूरा हो गया है।

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

2. प्रकाशित आदेश चलाएँ और प्रॉम्प्ट्स का पालन करें।

व्यवस्थापक केंद्र में अपलोड विफल हो जाता है

लक्षण:

• Microsoft 365 व्यवस्थापन केंद्र में manifest.zip अपलोड करते समय त्रुटि
• अपलोड के बाद एजेंट दिखाई नहीं देता है

मूल कारण:

• व्यवस्थापन केंद्र में आवश्यक अनुमतियाँ उपलब्ध नहीं हैं
• अमान्य या पुराना manifest.zip

समाधान:

1. सुनिश्चित करें कि आपके पास वैश्विक प्रशासक की भूमिका है।
2. a365 publish को फिर से चलाएँ ताकि एक नया manifest.zip उत्पन्न हो सके।
3. अपलोड चरणों को फ़ॉलो करके फिर से अपलोड करने की कोशिश करें।

अधिक सहायता के लिए, Microsoft 365 व्यवस्थापन केंद्र में एजेंट अपलोड करने के निर्देश देखें।