नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
महत्वपूर्ण
Microsoft Agent 365 तक शीघ्र पहुँच प्राप्त करने के लिए आपको Frontier पूर्वावलोकन प्रोग्राम का भाग बनने की आवश्यकता है. फ्रंटियर आपको सीधे Microsoft के नवीनतम AI नवाचारों से जोड़ता है। फ्रंटियर पूर्वावलोकन आपके ग्राहक समझौतों की मौजूदा पूर्वावलोकन शर्तों के अधीन हैं। चूंकि ये सुविधाएँ अभी भी विकास में हैं, इसलिए उनकी उपलब्धता और क्षमताएं समय के साथ बदल सकती हैं।
प्रत्येक चरण पर बारीक नियंत्रण के साथ अपना एजेंट 365 वातावरण सेट करें। यह आदेश एजेंट 365 ब्लूप्रिंट के लिए प्रारंभिक सेटअप वर्कफ़्लो का प्रबंधन करता है।
न्यूनतम भूमिका आवश्यक: Azure योगदानकर्ता + वैश्विक प्रशासक
सिंटैक्स
a365 setup [command] [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , , | मदद और उपयोग की जानकारी दिखाता है। |
अनुशंसित निष्पादन आदेश
# 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
setup requirements
एजेंट 365 सेटअप के लिए पूर्वापेक्षाएँ मान्य करें। मॉड्यूलर आवश्यकता जांच चलाता है और किसी भी समस्या के लिए मार्गदर्शन प्रदान करता है।
a365 setup requirements [options]
यह आदेश निम्न चरणों को चलाता है:
- एजेंट 365 सेटअप के लिए आवश्यक सभी पूर्वापेक्षाओं की जाँच करता है।
- विस्तृत समाधान मार्गदर्शन के साथ किसी भी समस्या की रिपोर्ट करता है।
- कुछ चेक विफल होने पर भी सभी आवश्यकताओं की जाँच करना जारी रखता है।
- अंत में सभी चेकों का सारांश प्रदान करता है।
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | सभी जांचों के लिए विस्तृत आउटपुट दिखाता है। |
--category <category> |
केवल किसी विशिष्ट श्रेणी के लिए चेक चलाता है, जैसे कि 'Azure', 'प्रमाणीकरण', या 'कॉन्फ़िगरेशन'. |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
setup infrastructure
Azure संरचना बनाएँ.
न्यूनतम आवश्यक अनुमतियाँ: Azure सदस्यता योगदानकर्ता या स्वामी
a365 setup infrastructure [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
setup blueprint
एजेंट ब्लूप्रिंट बनाएं (एंट्रा आईडी आवेदन पंजीकरण)।
कम से कम ज़रूरी अनुमतियां: एजेंट आईडी डेवलपर की भूमिका
a365 setup blueprint [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
--no-endpoint |
मैसेजिंग एंडपॉइंट को पंजीकृत न करें (केवल ब्लूप्रिंट) |
--endpoint-only |
केवल मैसेजिंग एंडपॉइंट पंजीकृत करें। मौजूदा ब्लूप्रिंट की आवश्यकता है |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
setup permissions
OAuth2 अनुमति अनुदान और इनहेरिटेबल अनुमतियाँ कॉन्फ़िगर करें.
न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक
a365 setup permissions [command] [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , , | मदद और उपयोग की जानकारी दिखाता है। |
उपआदेश
| उपआदेश | विवरण |
|---|---|
mcp |
MCP सर्वर OAuth2 अनुदान और इनहेरिटेबल अनुमतियों को कॉन्फ़िगर करें। |
bot |
मैसेजिंग बॉट एपीआई OAuth2 अनुदान और विरासत में मिलने योग्य अनुमतियों को कॉन्फ़िगर करें। |
custom |
आपके एजेंट ब्लूप्रिंट पर कस्टम एपीआई अनुमतियां लागू करता है जो एजेंट संचालन के लिए आवश्यक मानक अनुमतियों से परे जाती हैं। |
copilotstudio |
OAuth2 अनुमति अनुदान और एजेंट ब्लूप्रिंट के लिए विरासत योग्य अनुमतियों को कॉन्फ़िगर करता है ताकि Power Platform API के माध्यम से Copilot Studio सह-पायलटों को लागू किया जा सके। |
setup permissions mcp
MCP सर्वर OAuth2 अनुदान और इनहेरिटेबल अनुमतियों को कॉन्फ़िगर करें।
न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक
a365 setup permissions mcp [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
setup permissions bot
मैसेजिंग बॉट एपीआई OAuth2 अनुदान और विरासत में मिलने योग्य अनुमतियों को कॉन्फ़िगर करें।
न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक
पूर्वापेक्षाएँ: ब्लूप्रिंट और MCP अनुमतियाँ (पहले चलाएँ )
अगला चरण: अपने एजेंट को तैनात करें (यदि Azure पर होस्ट कर रहे हैं तो a365 deploy चलाएँ)
a365 setup permissions bot [options]
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
setup permissions custom
आपके एजेंट ब्लूप्रिंट पर कस्टम एपीआई अनुमतियां लागू करता है जो एजेंट संचालन के लिए आवश्यक मानक अनुमतियों से परे जाती हैं। यह आपके एजेंट को आपके संगठन के Entra ID टैनेंट में पंजीकृत अतिरिक्त Microsoft Graph स्कोप (जैसे उपस्थिति, फ़ाइलें, चैट) या कस्टम API तक पहुँचने की अनुमति देता है.
न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक
पूर्वापेक्षाएँ: पहले चलाएँ । इस आदेश को चलाने से पहले उपयोग करने के लिए कस्टम अनुमतियाँ जोड़ें.
a365 setup permissions custom [options]
यह आदेश:
- प्रत्येक कॉन्फ़िगर किए गए संसाधन के लिए व्यवस्थापक की सहमति के साथ OAuth2 प्रत्यायोजित अनुमति अनुदान को कॉन्फ़िगर करता है।
- इनहेरिटेबल अनुमतियाँ सेट करता है ताकि एजेंट उपयोगकर्ता ब्लूप्रिंट से एक्सेस इनहेरिट कर सकें.
- Microsoft Entra को वर्तमान कॉन्फ़िगरेशन के साथ समेटता है — नई अनुमतियाँ जोड़ना और कॉन्फ़िगरेशन से हटाए गए किसी भी को हटाना।
- कई बार चलाने के लिए idempotent और सुरक्षित है।
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
कस्टम अनुमतियाँ कॉन्फ़िगर करें
इस कमांड को चलाने से पहले अपने कॉन्फ़िगरेशन में कस्टम अनुमतियाँ जोड़ने के लिए उपयोग करें :
# 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 permissions copilotstudio
OAuth2 अनुमति अनुदान और एजेंट ब्लूप्रिंट के लिए विरासत योग्य अनुमतियों को कॉन्फ़िगर करता है ताकि Power Platform API के माध्यम से Copilot Studio सह-पायलटों को लागू किया जा सके।
न्यूनतम आवश्यक अनुमतियाँ: वैश्विक व्यवस्थापक
पूर्वापेक्षाएँ: पहले चलाएँ ।
a365 setup permissions copilotstudio [options]
यह आदेश:
- यह सुनिश्चित करता है कि आपके टैनेंट में Power Platform API सेवा प्रिंसिपल मौजूद है.
- दायरे के साथ ब्लूप्रिंट से Power Platform API के लिए OAuth2 अनुमति अनुदान बनाता है .
- विरासत में मिलने योग्य अनुमतियाँ सेट करता है ताकि एजेंट इंस्टेंस Copilot Studio copilots को लागू कर सकें।
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
| , , | मदद और उपयोग की जानकारी दिखाता है। |
इस कमांड का उपयोग तब करें जब आपके एजेंट को रनटाइम पर Copilot Studio के सह-पायलटों को लागू करने की आवश्यकता हो या Power Platform API को कॉल करने की आवश्यकता हो जिसके लिए CopilotStudio अनुमतियों की आवश्यकता होती है।
setup all
अपने एजेंट 365 वातावरण को सेट करने के लिए सभी सेटअप चरणों का पालन करें
a365 setup all [options]
संपूर्ण एजेंट 365 सेटअप चलाता है, सभी चरण क्रम में।
इसमें शामिल हैं: बुनियादी ढांचा, ब्लूप्रिंट, अनुमतियाँ और समापन बिंदु।
न्यूनतम आवश्यक अनुमतियाँ (वैश्विक व्यवस्थापक के पास ये सभी अनुमतियाँ हैं):
- Azure सदस्यता योगदानकर्ता (बुनियादी ढांचे और समापन बिंदु के लिए)
- एजेंट आईडी डेवलपर भूमिका (ब्लूप्रिंट निर्माण के लिए)
- वैश्विक प्रशासक (अनुमति अनुदान और व्यवस्थापक सहमति के लिए)
विकल्प
| विकल्प | विवरण |
|---|---|
| , | कॉन्फ़िगरेशन फ़ाइल पथ। डिफ़ॉल्ट a365.config.jsonहै। |
| , | विस्तृत आउटपुट दिखाएं। |
--dry-run |
दिखाएँ कि निष्पादित किए बिना क्या किया जाएगा। |
--skip-infrastructure |
Azure संरचना निर्माण छोड़ें (यदि बुनियादी ढांचा पहले से मौजूद है तो उपयोग करें)। यह विकल्प अभी भी बनाता है: ब्लूप्रिंट, अनुमतियाँ और समापन बिंदु. |
--skip-requirements |
आवश्यकताओं की पुष्टि की जांच छोड़ें। सावधानी के साथ उपयोग करें: यदि पूर्वापेक्षाएँ पूरी नहीं की जाती हैं, तो सेटअप विफल हो सकता है. |
| , , | मदद और उपयोग की जानकारी दिखाता है। |