एजेंट 365 सीएलआई deploy कमांड संदर्भ

महत्वपूर्ण

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

कॉन्फ़िगर किए गए Azure App Service के लिए एजेंट 365 अनुप्रयोग बायनेरिज़ परिनियोजित करें और एजेंट 365 उपकरण अनुमतियाँ अद्यतन करें आदेश एजेंट 365 परिनियोजन बनाने के लिए विकल्प प्रदान करता है। अपने Azure संरचना के लिए अनुप्रयोग बायनेरिज़ परिनियोजित करने के लिए और एजेंट 365 उपकरण अनुमतियाँ प्रदान करने के लिए इस आदेश का उपयोग करें।

न्यूनतम भूमिका आवश्यक: Azure योगदानकर्ता + वैश्विक प्रशासक

इस आदेश का उपयोग करने के बारे में जानकारी के लिए, Deploy एजेंट को Azure पर देखें।

सिंटैक्स

a365 deploy [command] [options]

विकल्प

विकल्प	वर्णन
-c, --config <config>	कॉन्फ़िगरेशन फ़ाइल के लिए पथ (डिफ़ॉल्ट: a365.config.json)
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
--inspect	प्रकाशित फ़ोल्डर और ज़िप सामग्री का निरीक्षण करने के लिए परिनियोजन से पहले रोकें
--restart	बिल्ड छोड़ें और मौजूदा प्रकाशन फ़ोल्डर को संपीड़ित करने से शुरू करें (मैन्युअल परिवर्तनों के बाद त्वरित पुनरावृत्ति के लिए)
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

टिप्पणी

सबकमांड के बिना चलने से a365 deployदो-चरण परिनियोजन चलता है:

• चरण 1 — अनुप्रयोग बायनेरिज़: आपके एप्लिकेशन को Azure App Service में बनाता है और परिनियोजित करता है।
• चरण 2 - एमसीपी अनुमतियाँ: आवश्यक स्कोप toolingManifest.json पढ़ता है और आवश्यक अनुमतियों के साथ एजेंट ब्लूप्रिंट को अपडेट करता है।

दोनों चरण यहां तक कि साथ भी --dry-runचलते हैं। ड्राई-रन आउटपुट को दो लेबल वाले वर्गों में विभाजित किया गया है ताकि आप समीक्षा कर सकें कि प्रत्येक चरण क्या करेगा।

प्रीफ्लाइट चेक

तैनात करने से पहले, सीएलआई मान्य करता है:

• Azure प्रमाणीकरण और सदस्यता: आपका Azure CLI सत्र और सदस्यता मान्य होनी चाहिए। यदि नहीं, तो परिनियोजन एक त्रुटि के साथ बंद हो जाता है। और के az login --tenant <TENANT_ID>साथ az account set --subscription <SUBSCRIPTION_ID> ठीक करें।
• Azure App Service existence: परिनियोजन आगे बढ़ने से पहले लक्ष्य वेब ऐप मौजूद होना चाहिए। यदि ऐप नहीं मिला है, तो चलाएं या सही a365 setup करें और मेंwebAppNameresourceGroup।a365.config.json

कॉन्फ़िगरेशन

सीएलआई दो कॉन्फ़िगरेशन फ़ाइलों से पढ़ता है:

• a365.config.json - आपका प्रोजेक्ट कॉन्फ़िगरेशन (उपयोगकर्ता द्वारा बनाए रखा गया)।
• a365.generated.config.json - सेटअप कमांड द्वारा उत्पन्न गतिशील स्थिति।

MCP उपकरण क्षेत्र अपने परिनियोजन प्रोजेक्ट निर्देशिका में से पढ़े toolingManifest.json जाते हैं।

सीएलआई कॉन्फ़िगरेशन और स्थिति की एक वैश्विक प्रति भी संग्रहीत करता है:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli
• लिनक्स/मैकओएस: ~/.config/a365

ध्वज व्यवहार

--restart: बिल्ड चरण को छोड़ देता है और मौजूदा publish/ फ़ोल्डर को संपीड़ित करने से सीधे शुरू होता है। यदि मौजूद नहीं है, तो publish/ परिनियोजन विफल हो जाता है। फ़ोल्डर बनाने --restart के लिए पहले एक पूर्ण परिनियोजन (बिनाpublish/) चलाएँ।

--inspect: अपलोड चरण से पहले रुक जाता है ताकि आप फ़ोल्डर और जेनरेट की गई ज़िप फ़ाइल का publish/ निरीक्षण कर सकें। केवल ऐप चरण के लिए उपलब्ध है।

--dry-run: बिना कोई बदलाव किए जो कुछ भी होगा उसे प्रिंट करता है। चलते समय a365 deploy (दो-चरण), आउटपुट में विभाजित होता है:

• भाग 1 - एप्लिकेशन बायनेरिज़ परिनियोजित करें
• भाग 2 - एजेंट 365 टूल अनुमतियों को तैनात/अद्यतन करें

deploy app

सेटअप के दौरान बनाए गए Azure Web App पर आपके एजेंट कोड को परिनियोजित करता है.

a365 deploy app [options]

Microsoft Agent 365 अनुप्रयोग बायनेरिज़ को कॉन्फ़िगर किए गए Azure App Service पर परिनियोजित करें। यह आदेश Azure में आपकी कॉन्फ़िगर की गई Azure ऐप सेवा पर एप्लिकेशन बायनेरिज़ को परिनियोजित करता है.

app विकल्प

विकल्प	वर्णन
-c, --config <config>	कॉन्फ़िगरेशन फ़ाइल के लिए पथ (डिफ़ॉल्ट: a365.config.json)
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
--inspect	प्रकाशित फ़ोल्डर और ज़िप सामग्री का निरीक्षण करने के लिए परिनियोजन से पहले रोकें
--restart	बिल्ड छोड़ें और मौजूदा प्रकाशन फ़ोल्डर को संपीड़ित करने से शुरू करें (मैन्युअल परिवर्तनों के बाद त्वरित पुनरावृत्ति के लिए)
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

deploy mcp

आपके एजेंट ब्लूप्रिंट पर MCP सर्वर अनुमतियाँ अद्यतन करता है।

a365 deploy mcp [options]

mcp विकल्प

विकल्प	वर्णन
-c, --config <config>	कॉन्फ़िगरेशन फ़ाइल पथ (डिफ़ॉल्ट: a365.config.json)
-v, --verbose	वर्बोज़ लॉगिंग सक्षम करें
--dry-run	दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं

उपयोग नोट्स

MCP सर्वर, कार्यक्षेत्र और अनुमतियाँ मौजूदा एजेंट ब्लूप्रिंट पर अद्यतन करें। यह आदेश एजेंट ब्लूप्रिंट के लिए एजेंट 365 उपकरण के लिए अनुमतियाँ जोड़ता है।

यदि आप अपने एजेंट कोड में MCP सर्वर जोड़ते हैं या संशोधित करते हैं, तो अपने एजेंट ब्लूप्रिंट पर अनुमतियों को अद्यतन करने के लिए इस आदेश का उपयोग करें।

यह आदेश:

• आपके कोड से आपके MCP सर्वर कॉन्फ़िगरेशन को पढ़ता है।
• आवश्यक अनुमतियों के साथ एजेंट ब्लूप्रिंट को अपडेट करता है।
• MCP सर्वर के लिए आवश्यक API अनुमतियाँ प्रदान करता है।

अनुमति अद्यतन निम्न क्रम में लागू होता है:

1. OAuth2 अनुमति अनुदान (MCP प्लेटफ़ॉर्म → ब्लूप्रिंट सेवा प्रिंसिपल)
2. इनहेरिट करने योग्य अनुमतियाँ (एजेंट ब्लूप्रिंट → MCP संसाधन)
3. व्यवस्थापक सहमति (एजेंट पहचान → MCP प्लेटफ़ॉर्म)

कब उपयोग करें deploy mcp:

• अपने एजेंट के लिए नए MCP सर्वर जोड़ने के बाद।
• MCP सर्वर कॉन्फ़िगरेशन बदलने के बाद।
• जब MCP टूल आपके एजेंट के लिए एक्सेस नहीं किए जाते हैं.

आपको दौड़ने deploy mcpकी जरूरत नहीं है:

• प्रारंभिक तैनाती पर। यह सेटअप के दौरान स्वचालित रूप से संभाला जाता है।
• जब केवल MCP परिवर्तन के बिना एजेंट तर्क बदल रहा है।
• रूटीन कोड अपडेट के बाद जो टूलिंग को प्रभावित नहीं करते हैं।

नोट

a365 deploy mcp केवल अनुमतियों को अपडेट करता है - यह आपके कोड को तैनात नहीं करता है। यदि आपके पास कोड परिवर्तन हैं तो पहले चलाएं a365 deploy app ।

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

आदेश के साथ deploy संभावित समस्याओं को हल करने के लिए निम्न अनुभागों का उपयोग करें।

• Azure या गलत सदस्यता में लॉग इन नहीं किया गया है
• वेब अनुप्रयोग नहीं मिला
• अनुमतियाँ अद्यतन विफल रहता है
• --restart विफल रहता है

Azure में लॉग इन नहीं किया गया है या गलत सदस्यता

दौड़ो az login --tenant <TENANT_ID> और .az account set --subscription <SUBSCRIPTION_ID>

वेब अनुप्रयोग नहीं मिला

सुनिश्चित करें a365 setup कि चलाया गया है, या सत्यापित करें कि और webAppNameresourceGroup में सही a365.config.jsonहैं।

अनुमतियाँ अद्यतन विफल रहता है

• पुष्टि करें AgentBlueprintId, AgenticAppIdऔर पर्यावरण में a365.config.jsonसेट हैं।
• सुनिश्चित करें कि आपके खाते में सेवा प्रिंसिपल और अनुदान प्रबंधित करने का अधिकार है।
• सत्यापित करें कि toolingManifest.json आपकी परिनियोजन प्रोजेक्ट निर्देशिका में मौजूद है और मान्य क्षेत्र हैं।

--restart विफल रहता है

फ़ोल्डर का उत्पादन करने के लिए --restart एक पूर्ण परिनियोजन चलाएँ, फिर बाद के पुनरावृत्तियों के लिए उपयोग करेंpublish/।--restart

लॉग्स

सीएलआई लॉग फ़ाइलें यहां संग्रहीत की जाती हैं:

• Windows: %LocalAppData%\Microsoft.Agents.A365.DevTools.Cli\logs\
• लिनक्स/मैकओएस: ~/.config/a365/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 का उपयोग करें।