नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
महत्वपूर्ण
Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।
कॉन्फ़िगर किए गए Azure App Service के लिए एजेंट 365 अनुप्रयोग बायनेरिज़ परिनियोजित करें और एजेंट 365 उपकरण अनुमतियाँ अद्यतन करें
न्यूनतम भूमिका आवश्यक: Azure योगदानकर्ता + वैश्विक प्रशासक
इस आदेश का उपयोग करने के बारे में जानकारी के लिए, Deploy एजेंट को Azure पर देखें।
सिंटैक्स
a365 deploy [command] [options]
विकल्प
| विकल्प | वर्णन |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल के लिए पथ (डिफ़ॉल्ट: a365.config.json) |
| , | वर्बोज़ लॉगिंग सक्षम करें |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा |
--inspect |
प्रकाशित फ़ोल्डर और ज़िप सामग्री का निरीक्षण करने के लिए परिनियोजन से पहले रोकें |
--restart |
बिल्ड छोड़ें और मौजूदा प्रकाशन फ़ोल्डर को संपीड़ित करने से शुरू करें (मैन्युअल परिवर्तनों के बाद त्वरित पुनरावृत्ति के लिए) |
| , , | मदद और उपयोग की जानकारी दिखाएं |
टिप्पणी
सबकमांड के बिना चलने से दो-चरण परिनियोजन चलता है:
- चरण 1 — अनुप्रयोग बायनेरिज़: आपके एप्लिकेशन को Azure App Service में बनाता है और परिनियोजित करता है।
- चरण 2 - एमसीपी अनुमतियाँ: आवश्यक स्कोप पढ़ता है और आवश्यक अनुमतियों के साथ एजेंट ब्लूप्रिंट को अपडेट करता है।
दोनों चरण यहां तक कि साथ भी चलते हैं। ड्राई-रन आउटपुट को दो लेबल वाले वर्गों में विभाजित किया गया है ताकि आप समीक्षा कर सकें कि प्रत्येक चरण क्या करेगा।
प्रीफ्लाइट चेक
तैनात करने से पहले, सीएलआई मान्य करता है:
- Azure प्रमाणीकरण और सदस्यता: आपका Azure CLI सत्र और सदस्यता मान्य होनी चाहिए। यदि नहीं, तो परिनियोजन एक त्रुटि के साथ बंद हो जाता है। और के साथ ठीक करें।
- Azure App Service existence: परिनियोजन आगे बढ़ने से पहले लक्ष्य वेब ऐप मौजूद होना चाहिए। यदि ऐप नहीं मिला है, तो चलाएं या सही करें और में।
कॉन्फ़िगरेशन
सीएलआई दो कॉन्फ़िगरेशन फ़ाइलों से पढ़ता है:
- - आपका प्रोजेक्ट कॉन्फ़िगरेशन (उपयोगकर्ता द्वारा बनाए रखा गया)।
- - सेटअप कमांड द्वारा उत्पन्न गतिशील स्थिति।
MCP उपकरण क्षेत्र अपने परिनियोजन प्रोजेक्ट निर्देशिका में से पढ़े जाते हैं।
सीएलआई कॉन्फ़िगरेशन और स्थिति की एक वैश्विक प्रति भी संग्रहीत करता है:
-
Windows:
%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli - लिनक्स/मैकओएस:
ध्वज व्यवहार
: बिल्ड चरण को छोड़ देता है और मौजूदा फ़ोल्डर को संपीड़ित करने से सीधे शुरू होता है। यदि मौजूद नहीं है, तो परिनियोजन विफल हो जाता है। फ़ोल्डर बनाने के लिए पहले एक पूर्ण परिनियोजन (बिना) चलाएँ।
: अपलोड चरण से पहले रुक जाता है ताकि आप फ़ोल्डर और जेनरेट की गई ज़िप फ़ाइल का निरीक्षण कर सकें। केवल ऐप चरण के लिए उपलब्ध है।
: बिना कोई बदलाव किए जो कुछ भी होगा उसे प्रिंट करता है। चलते समय (दो-चरण), आउटपुट में विभाजित होता है:
- भाग 1 - एप्लिकेशन बायनेरिज़ परिनियोजित करें
- भाग 2 - एजेंट 365 टूल अनुमतियों को तैनात/अद्यतन करें
deploy app
सेटअप के दौरान बनाए गए Azure Web App पर आपके एजेंट कोड को परिनियोजित करता है.
a365 deploy app [options]
Microsoft Agent 365 अनुप्रयोग बायनेरिज़ को कॉन्फ़िगर किए गए Azure App Service पर परिनियोजित करें। यह आदेश Azure में आपकी कॉन्फ़िगर की गई Azure ऐप सेवा पर एप्लिकेशन बायनेरिज़ को परिनियोजित करता है.
विकल्प
| विकल्प | वर्णन |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल के लिए पथ (डिफ़ॉल्ट: a365.config.json) |
| , | वर्बोज़ लॉगिंग सक्षम करें |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा |
--inspect |
प्रकाशित फ़ोल्डर और ज़िप सामग्री का निरीक्षण करने के लिए परिनियोजन से पहले रोकें |
--restart |
बिल्ड छोड़ें और मौजूदा प्रकाशन फ़ोल्डर को संपीड़ित करने से शुरू करें (मैन्युअल परिवर्तनों के बाद त्वरित पुनरावृत्ति के लिए) |
| , , | मदद और उपयोग की जानकारी दिखाएं |
deploy mcp
आपके एजेंट ब्लूप्रिंट पर MCP सर्वर अनुमतियाँ अद्यतन करता है।
a365 deploy mcp [options]
विकल्प
| विकल्प | वर्णन |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ (डिफ़ॉल्ट: a365.config.json) |
| , | वर्बोज़ लॉगिंग सक्षम करें |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा |
| , , | मदद और उपयोग की जानकारी दिखाएं |
उपयोग नोट्स
MCP सर्वर, कार्यक्षेत्र और अनुमतियाँ मौजूदा एजेंट ब्लूप्रिंट पर अद्यतन करें। यह आदेश एजेंट ब्लूप्रिंट के लिए एजेंट 365 उपकरण के लिए अनुमतियाँ जोड़ता है।
यदि आप अपने एजेंट कोड में MCP सर्वर जोड़ते हैं या संशोधित करते हैं, तो अपने एजेंट ब्लूप्रिंट पर अनुमतियों को अद्यतन करने के लिए इस आदेश का उपयोग करें।
यह आदेश:
- आपके कोड से आपके MCP सर्वर कॉन्फ़िगरेशन को पढ़ता है।
- आवश्यक अनुमतियों के साथ एजेंट ब्लूप्रिंट को अपडेट करता है।
- MCP सर्वर के लिए आवश्यक API अनुमतियाँ प्रदान करता है।
अनुमति अद्यतन निम्न क्रम में लागू होता है:
- OAuth2 अनुमति अनुदान (MCP प्लेटफ़ॉर्म → ब्लूप्रिंट सेवा प्रिंसिपल)
- इनहेरिट करने योग्य अनुमतियाँ (एजेंट ब्लूप्रिंट → MCP संसाधन)
- व्यवस्थापक सहमति (एजेंट पहचान → MCP प्लेटफ़ॉर्म)
कब उपयोग करें :
- अपने एजेंट के लिए नए MCP सर्वर जोड़ने के बाद।
- MCP सर्वर कॉन्फ़िगरेशन बदलने के बाद।
- जब MCP टूल आपके एजेंट के लिए एक्सेस नहीं किए जाते हैं.
आपको दौड़ने की जरूरत नहीं है:
- प्रारंभिक तैनाती पर। यह सेटअप के दौरान स्वचालित रूप से संभाला जाता है।
- जब केवल MCP परिवर्तन के बिना एजेंट तर्क बदल रहा है।
- रूटीन कोड अपडेट के बाद जो टूलिंग को प्रभावित नहीं करते हैं।
नोट
केवल अनुमतियों को अपडेट करता है - यह आपके कोड को तैनात नहीं करता है। यदि आपके पास कोड परिवर्तन हैं तो पहले चलाएं ।
समस्या निवारण
आदेश के साथ संभावित समस्याओं को हल करने के लिए निम्न अनुभागों का उपयोग करें।
- Azure या गलत सदस्यता में लॉग इन नहीं किया गया है
- वेब अनुप्रयोग नहीं मिला
- अनुमतियाँ अद्यतन विफल रहता है
- विफल रहता है
Azure में लॉग इन नहीं किया गया है या गलत सदस्यता
दौड़ो और .
वेब अनुप्रयोग नहीं मिला
सुनिश्चित करें कि चलाया गया है, या सत्यापित करें कि और में सही हैं।
अनुमतियाँ अद्यतन विफल रहता है
- पुष्टि करें , और पर्यावरण में सेट हैं।
- सुनिश्चित करें कि आपके खाते में सेवा प्रिंसिपल और अनुदान प्रबंधित करने का अधिकार है।
- सत्यापित करें कि आपकी परिनियोजन प्रोजेक्ट निर्देशिका में मौजूद है और मान्य क्षेत्र हैं।
विफल रहता है
फ़ोल्डर का उत्पादन करने के लिए एक पूर्ण परिनियोजन चलाएँ, फिर बाद के पुनरावृत्तियों के लिए उपयोग करें।
लॉग्स
सीएलआई लॉग फ़ाइलें यहां संग्रहीत की जाती हैं:
-
Windows:
%LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\ - लिनक्स/मैकओएस:
नवीनतम परिनियोजन लॉग फ़ाइल की अंतिम 80 पंक्तियों को देखने के लिए, Windows पर Get-Content या Linux/macOS पर tail का उपयोग करें:
# Windows
Get-Content $env:LOCALAPPDATA\Microsoft.Agents.A365.DevTools.Cli\logs\a365.deploy.log -Tail 80
# Linux/macOS
tail -80 ~/.config/a365/logs/a365.deploy.log
रनटाइम एप्लिकेशन लॉग के लिए, अपनी ऐप सेवा से stdout/stderr के लिए Azure पोर्टल में Log Stream का उपयोग करें।