इसके माध्यम से साझा किया गया

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

महत्वपूर्ण

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

प्रत्येक चरण पर बारीक नियंत्रण के साथ अपना एजेंट 365 वातावरण सेट करें। यह आदेश एजेंट 365 ब्लूप्रिंट के लिए प्रारंभिक सेटअप वर्कफ़्लो का प्रबंधन करता है।

कम से कम भूमिका ज़रूरी:Azure योगदानकर्ता + एजेंट आईडी डेवलपर

नोट

आपके द्वारा धारण की गई भूमिका यह निर्धारित करती है कि एक बार में कितना सेटअप पूरा होता है। वैश्विक व्यवस्थापक एक ही बार में सभी चरणों को पूरा कर सकता है। एजेंट आईडी व्यवस्थापक और एजेंट आईडी डेवलपर OAuth2 अनुमति अनुदान (व्यवस्थापक सहमति) को छोड़कर सभी चरणों को पूरा कर सकते हैं, जिसके लिए वैश्विक व्यवस्थापक द्वारा एक अलग चरण की आवश्यकता होती है। हैंडऑफ़ वर्कफ़्लो के बारे में अधिक जानने के लिए, देखें setup admin.

सिंटैक्स

a365 setup [command] [options]

विकल्प

विकल्प विवरण
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं. 
# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

# 5. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 6. Configure custom permissions (if needed)
a365 setup permissions custom

या एक साथ सभी चरणों को चलाएं:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

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

# Non-admin path: run setup, then hand off to Global Administrator
a365 setup all

# Global Administrator completes OAuth2 grants
a365 setup admin --config-dir "<path-to-config-folder>"

setup requirements

एजेंट 365 सेटअप के लिए पूर्वापेक्षाएँ मान्य करें। मॉड्यूलर आवश्यकता जांच चलाता है और किसी भी समस्या के लिए मार्गदर्शन प्रदान करता है।

a365 setup requirements [options]

यह आदेश निम्न चरणों को चलाता है:

  • एजेंट 365 सेटअप के लिए आवश्यक सभी पूर्वापेक्षाओं की जाँच करता है।
  • विस्तृत समाधान मार्गदर्शन के साथ किसी भी समस्या की रिपोर्ट करता है।
  • कुछ चेक विफल होने पर भी सभी आवश्यकताओं की जाँच करना जारी रखता है।
  • अंत में सभी चेकों का सारांश प्रदान करता है।

requirements विकल्प

विकल्प विवरण
-c, --config <config> कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै।
-v, --verbose सभी जांचों के लिए विस्तृत आउटपुट दिखाता है।
--category <category> केवल किसी विशिष्ट श्रेणी के लिए चेक चलाता है, जैसे कि Azure, Authentication, या Configuration।
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

setup infrastructure

Azure संरचना बनाएँ.

न्यूनतम आवश्यक अनुमतियाँ: Azure सदस्यता योगदानकर्ता या स्वामी

a365 setup infrastructure [options]

infrastructure विकल्प

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

setup blueprint

एजेंट ब्लूप्रिंट बनाएं (एंट्रा आईडी आवेदन पंजीकरण)।

कम से कम ज़रूरी अनुमतियां: एजेंट आईडी डेवलपर की भूमिका

a365 setup blueprint [options]

blueprint विकल्प

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

setup permissions

OAuth2 अनुमति अनुदान और इनहेरिटेबल अनुमतियाँ कॉन्फ़िगर करें.

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

a365 setup permissions [command] [options]

विकल्प

विकल्प विवरण
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

उपआदेश

उपआदेश विवरण
mcp MCP सर्वर OAuth2 अनुदान और इनहेरिटेबल अनुमतियों को कॉन्फ़िगर करें।
bot मैसेजिंग बॉट एपीआई OAuth2 अनुदान और विरासत में मिलने योग्य अनुमतियों को कॉन्फ़िगर करें।
custom आपके एजेंट ब्लूप्रिंट पर कस्टम एपीआई अनुमतियां लागू करता है जो एजेंट संचालन के लिए आवश्यक मानक अनुमतियों से परे जाती हैं।
copilotstudio OAuth2 अनुमति अनुदान और एजेंट ब्लूप्रिंट के लिए विरासत योग्य अनुमतियों को कॉन्फ़िगर करता है ताकि Power Platform API के माध्यम से Copilot Studio सह-पायलटों को लागू किया जा सके।

setup permissions mcp

MCP सर्वर OAuth2 अनुदान और इनहेरिटेबल अनुमतियों को कॉन्फ़िगर करें।

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

a365 setup permissions mcp [options]

यह आदेश:

  • में निर्दिष्ट ToolingManifest.jsonसे deploymentProjectPath पढ़ता हैa365.config.json।
  • OAuth2 एजेंट ब्लूप्रिंट के लिए प्रत्येक MCP सर्वर क्षेत्र के लिए प्रत्यायोजित अनुमति अनुदान प्रदान करता है।
  • इनहेरिटेबल अनुमतियों को कॉन्फ़िगर करता है ताकि एजेंट इंस्टेंस MCP टूल तक पहुंच सकें।
  • कई बार चलाने के लिए idempotent और सुरक्षित है।

महत्वपूर्ण

  • इस आदेश को चलाने से पहले, यह सत्यापित करने के लिए चलाएँ a365 config display कि अद्यतन deploymentProjectPath किए ToolingManifest.jsonगए प्रोजेक्ट फ़ोल्डर को इंगित करता है। डेवलपर किसी भिन्न मशीन पर MCP सर्वर जोड़ता है, तो पहले वैश्विक व्यवस्थापक के साथ अद्यतन साझा ToolingManifest.json करें। सही ToolingManifest.json के बिना चलने से नए MCP सर्वर अनुमतियों को ब्लूप्रिंट में नहीं जोड़ा जाता है।
  • डेवलपर के चलने a365 develop add-mcp-servers इस कमांड को चलाएं। मैनिफेस्ट में MCP सर्वर जोड़ना और ब्लूप्रिंट को अनुमतियाँ देना दो अलग-अलग चरण हैं। इस आदेश के पूर्ण होने के बाद, MCP सर्वर अनुमतियाँ एजेंट ब्लूप्रिंट में दिखाई दे रहे हैं।

permissions mcp विकल्प

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

setup permissions bot

मैसेजिंग बॉट एपीआई OAuth2 अनुदान और विरासत में मिलने योग्य अनुमतियों को कॉन्फ़िगर करें।

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

पूर्वापेक्षाएँ: ब्लूप्रिंट और MCP अनुमतियाँ (पहले चलाएँ a365 setup permissions mcp )

अगला चरण: अपने एजेंट को तैनात करें (यदि Azure पर होस्ट कर रहे हैं तो a365 deploy चलाएँ)

a365 setup permissions bot [options]

permissions bot विकल्प

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

setup permissions custom

आपके एजेंट ब्लूप्रिंट पर कस्टम एपीआई अनुमतियां लागू करता है जो एजेंट संचालन के लिए आवश्यक मानक अनुमतियों से परे जाती हैं। इस आदेश का उपयोग करके, आप अपने एजेंट को अतिरिक्त Microsoft ग्राफ़ क्षेत्रों, जैसे उपस्थिति, फ़ाइलें और चैट या अपने संगठन के Microsoft Entra ID टेनेंट में पंजीकृत कस्टम API तक पहुँच प्रदान करते हैं.

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

पूर्वापेक्षाएँ: पहले चलाएँ a365 setup blueprint । इस आदेश को चलाने से पहले उपयोग करके a365.config.json कस्टम अनुमतियाँ a365 config permissions जोड़ें।

a365 setup permissions custom [options]

यह आदेश:

  • प्रत्येक कॉन्फ़िगर किए गए संसाधन के लिए व्यवस्थापक की सहमति के साथ OAuth2 प्रत्यायोजित अनुमति अनुदान को कॉन्फ़िगर करता है।
  • इनहेरिटेबल अनुमतियाँ सेट करता है ताकि एजेंट उपयोगकर्ता ब्लूप्रिंट से एक्सेस इनहेरिट कर सकें.
  • नई अनुमतियाँ जोड़कर और कॉन्फ़िगरेशन से आपके द्वारा हटाई गई किसी भी अनुमतियों को हटाकर Microsoft Entra को वर्तमान कॉन्फ़िगरेशन के साथ समेटता है.
  • कई बार चलाने के लिए idempotent और सुरक्षित है।

permissions custom विकल्प

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

कस्टम अनुमतियाँ कॉन्फ़िगर करें

इस कमांड को चलाने से पहले अपने कॉन्फ़िगरेशन में कस्टम अनुमतियाँ जोड़ने के लिए उपयोग करें a365 config permissions :

# Add Microsoft Graph extended permissions
a365 config permissions `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 config permissions `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

# Apply all configured custom permissions
a365 setup permissions custom

सेटअप के दौरान, संसाधन का नाम Azure से स्वत: हल हो गया है। आपको इसे कॉन्फ़िगरेशन में निर्दिष्ट करने की आवश्यकता नहीं है।

कस्टम अनुमतियाँ निकालें

कॉन्फ़िगरेशन और Microsoft Entra दोनों से कस्टम अनुमतियाँ निकालने के लिए:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

के साथ एकीकरण setup all

जब आपके कॉन्फ़िगरेशन में कस्टम अनुमतियाँ शामिल होती हैं, तो चलने से a365 setup all उन्हें स्वचालित रूप से एकल बैच अनुमति चरण के भाग के रूप में कॉन्फ़िगर किया जाता है. पूर्ण सेटअप आदेश है:

  1. अवसरंचना
  2. नकल
  3. अनुमतियाँ बैच (MCP, बॉट API, कस्टम ब्लूप्रिंट अनुमतियाँ — सभी एक साथ कॉन्फ़िगर की गई हैं)

setup permissions copilotstudio

OAuth2 अनुमति अनुदान और एजेंट ब्लूप्रिंट के लिए विरासत योग्य अनुमतियों को कॉन्फ़िगर करता है ताकि Power Platform API के माध्यम से Copilot Studio सह-पायलटों को लागू किया जा सके।

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

पूर्वापेक्षाएँ: पहले चलाएँ a365 setup blueprint ।

a365 setup permissions copilotstudio [options]

यह आदेश:

  • यह सुनिश्चित करता है कि आपके टैनेंट में Power Platform API सेवा प्रिंसिपल मौजूद है.
  • दायरे के साथ ब्लूप्रिंट से Power Platform API के लिए OAuth2 अनुमति अनुदान बनाता है CopilotStudio.Copilots.Invoke .
  • विरासत में मिलने योग्य अनुमतियाँ सेट करता है ताकि एजेंट इंस्टेंस Copilot Studio copilots को लागू कर सकें।

permissions copilotstudio विकल्प

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

इस कमांड का उपयोग तब करें जब आपके एजेंट को रनटाइम पर Copilot Studio के सह-पायलटों को लागू करने की आवश्यकता हो या Power Platform API को कॉल करने की आवश्यकता हो जिसके लिए CopilotStudio अनुमतियों की आवश्यकता होती है।

setup all

अपने एजेंट 365 वातावरण को सेट करने के लिए सभी सेटअप चरणों का पालन करें

a365 setup all [options]

संपूर्ण एजेंट 365 सेटअप चलाता है, सभी चरण क्रम में।

इसमें शामिल हैं: बुनियादी ढांचा, ब्लूप्रिंट और अनुमतियाँ।

पूर्ण चरण आपकी भूमिका पर निर्भर करते हैं:

चरण वैश्विक प्रशासक एजेंट आईडी प्रशासक एजेंट आईडी डेवलपर
पूर्वापेक्षाएँ जाँच हां हां हां
Azure बुनियादी ढांचा हां हां हां
एजेंट ब्लूप्रिंट निर्माण हां हां हां
विरासत में मिलने योग्य अनुमतियाँ हां हां हां
OAuth2 अनुमति अनुदान (व्यवस्थापक सहमति) हां GA चरण की आवश्यकता है GA चरण की आवश्यकता है

जब आप वैश्विक व्यवस्थापक के बिना चलाते a365 setup all हैं, तो CLI:

  1. सभी चरणों को पूरा करता है (बुनियादी ढांचा, खाका निर्माण, और विरासत में मिलने योग्य अनुमतियाँ)।
  2. प्रति-संसाधन व्यवस्थापक सहमति URL उत्पन्न करता है और उन्हें सहेजता है a365.generated.config.json।
  3. अगले चरण दिखाता है कि कैसे एक वैश्विक व्यवस्थापक या जनरेट किए गए सहमति URL का उपयोग करके a365 setup admin OAuth2 अनुदान को पूरा कर सकता है।

सुझाव

यदि आप एक वैश्विक व्यवस्थापक हैं, a365 setup all तो बिना किसी हैंडऑफ़ की आवश्यकता के एक ही रन में सब कुछ पूरा करता है।

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

  • Azure सदस्यता योगदानकर्ता या स्वामी (बुनियादी ढांचे के लिए)
  • एजेंट आईडी डेवलपर भूमिका (ब्लूप्रिंट निर्माण के लिए)
  • वैश्विक व्यवस्थापक (OAuth2 अनुमति अनुदान के लिए — यदि उपलब्ध नहीं है, तो हैंडऑफ़ का उपयोग करें setup admin )

setup all विकल्प

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

setup admin

OAuth2 अनुमति अनुदान (व्यवस्थापक सहमति) को पूरा करता है जिसके लिए वैश्विक व्यवस्थापक की आवश्यकता होती है. किसी एजेंट ID व्यवस्थापक या एजेंट ID डेवलपर के चलने a365 setup allके बाद इस आदेश को चलाएँ।

न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक

a365 setup admin [options]

कब उपयोग करें setup admin

इस आदेश का उपयोग तब करें जब:

  • एजेंट आईडी व्यवस्थापक या एजेंट आईडी डेवलपर चलाने के a365 setup allबाद।
  • सेटअप सारांश से पता चलता है कि OAuth2 अनुदान लंबित हैं और इस आदेश को चलाने के लिए वैश्विक व्यवस्थापक निर्देश देता है।
  • आप कॉन्फ़िगरेशन में अनुमतियाँ बदलने के बाद सहमति अनुदान को फिर से चलाना चाहते हैं।

विशिष्ट हैंडऑफ़ वर्कफ़्लो

# Step 1: Agent ID Admin or Developer runs setup
a365 setup all

# The CLI displays next steps, for example:
# "ACTION REQUIRED — Global Administrator must complete OAuth2 grants"
# "Option 1: a365 setup admin --config-dir '<path-to-config-folder>'"
# "Option 2: Share the consent URL displayed above with your Global Administrator"

# Step 2: Agent ID Admin shares config folder with Global Administrator
# (contains a365.config.json and a365.generated.config.json)

# Step 3: Global Administrator completes the grants
a365 setup admin --config-dir "<path-to-config-folder>"

यह आदेश:

  • एजेंट कॉन्फ़िगरेशन को निर्दिष्ट निर्देशिका या वर्तमान निर्देशिका से डिफ़ॉल्ट रूप से लोड करता है।
  • एजेंट ब्लूप्रिंट आईडी पढ़ता है और जनरेट किए गए कॉन्फ़िगरेशन से कॉन्फ़िगर की गई संसाधन अनुमतियाँ कॉन्फ़िगर करता है।
  • सभी कॉन्फ़िगर किए गए संसाधनों के लिए OAuth2 अनुमति अनुदान बनाता AllPrincipals है, जिनमें शामिल हैं:
    • Microsoft ग्राफ़ (प्रत्यायोजित क्षेत्र)
    • एजेंट 365 उपकरण (MCP सर्वर स्कोप)
    • मैसेजिंग बॉट एपीआई
    • अवलोकन एपीआई
    • Power Platform व्यवस्थापक
    • आपके कॉन्फ़िगरेशन में परिभाषित कोई भी कस्टम अनुमतियाँ
  • परिवर्तन करने से पहले एक पुष्टिकरण संकेत प्रदर्शित करता है। प्रॉम्प्ट को बायपास करने के लिए उपयोग करें --yes ।

चेतावनी

इस कमांड द्वारा बनाए गए OAuth2 अनुदान किरायेदार-व्यापी ()consentType=AllPrincipals हैं। इस कॉन्फ़िगरेशन का अर्थ है कि टैनेंट में सभी उपयोगकर्ता एजेंट की प्रत्यायोजित अनुमतियों का उपयोग कर सकते हैं। पुष्टि करने से पहले सूचीबद्ध क्षेत्रों की सावधानीपूर्वक समीक्षा करें।

setup admin विकल्प

विकल्प विवरण
-d, --config-dir <dir> निर्देशिका युक्त और a365.config.json .a365.generated.config.json वर्तमान निर्देशिका के लिए डिफ़ॉल्ट।
-v, --verbose विस्तृत आउटपुट दिखाएं।
--dry-run दिखाएँ कि कमांड इसे निष्पादित किए बिना क्या करेगा।
--skip-requirements आवश्यकताओं की पुष्टि की जांच छोड़ें। सावधानी से प्रयोग करें.
-y, --yes पुष्टिकरण संकेत छोड़ें और स्वचालित रूप से आगे बढ़ें।
-?, , -h--help मदद और उपयोग की जानकारी दिखाएं.

चलाने a365 setup adminके बजाय, वैश्विक व्यवस्थापक संयुक्त सहमति URL खोल सकता है जो a365 setup all सहेजता है a365.generated.config.json। यह URL एक ही ब्राउज़र विज़िट में सभी आवश्यक संसाधनों को कवर करता है।

# Display the generated config to find the consent URL
a365 config display -g
# Look for: combinedAdminConsentUrl
  • Last updated on