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

महत्वपूर्ण

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

एजेंट 365 सीएलआई कॉन्फ़िगरेशन प्रबंधित करें। एजेंट 365 CLI कॉन्फ़िगरेशन सेटिंग्स को प्रबंधित करने के लिए विकल्प प्रदान करता है। आप नए कॉन्फ़िगरेशन अंतःक्रियात्मक रूप से प्रारंभ कर सकते हैं या वर्तमान कॉन्फ़िगरेशन सेटिंग्स प्रदर्शित कर सकते हैं।

न्यूनतम भूमिका आवश्यक: कोई नहीं (स्थानीय कॉन्फ़िगरेशन)

सिंटैक्स

a365 config [command] [options]

विकल्प

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

config init

एजेंट 365 CLI को अंतःक्रियात्मक रूप से कॉन्फ़िगर करें या किसी फ़ाइल से आयात करें।

a365 config init [options]

किसी सहभागी प्रक्रिया के माध्यम से या किसी मौजूदा कॉन्फ़िगरेशन फ़ाइल से सेटिंग्स आयात करके अपने एजेंट 365 CLI कॉन्फ़िगरेशन को सेट करने के लिए इस आदेश का उपयोग करें।

init विकल्प

विकल्प	विवरण
-c, --configfile <configfile>	आयात करने के लिए किसी मौजूदा कॉन्फ़िगरेशन फ़ाइल का पथ
-g, --global	वर्तमान निर्देशिका के बजाय वैश्विक निर्देशिका (AppData) में कॉन्फ़िगरेशन बनाएँ
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं.

टिप्पणी

कमांड एक config init इंटरैक्टिव विज़ार्ड लॉन्च करता है जो मैन्युअल इनपुट को कम करता है:

• Azure CLI एकीकरण: स्वचालित रूप से आपकी सदस्यता, टैनेंट, संसाधन समूहों, ऐप सेवा योजनाओं और क्षेत्रों का पता लगाता है।
• स्मार्ट डिफ़ॉल्ट: आपके एजेंट के नाम और टाइमस्टैम्प (उदाहरण के लिए, ) myagent-webapp-11140916से संसाधन नाम जनरेट करता है. आप सहेजने से पहले इन नामों को अनुकूलित कर सकते हैं।
• Platform का पता लगाने: परिनियोजन प्रोजेक्ट पथ से आपके प्रोजेक्ट प्रकार (.NET, Node.js, Python) का पता लगाता है और कोई समर्थित प्रकार नहीं मिलने पर चेतावनी देता है।
• क्लाइंट ऐप सत्यापन: आपके Entra टैनेंट के विरुद्ध आपके क्लाइंट ऐप आईडी को सत्यापित करता है, यह जांचता है कि आवश्यक अनुमतियाँ कॉन्फ़िगर की गई हैं और व्यवस्थापक की सहमति प्रदान की गई है। विज़ार्ड के बाहर निकलने से पहले आपके पास अधिकतम तीन प्रयास हैं।

कस्टम ब्लूप्रिंट अनुमतियाँ (वैकल्पिक): विज़ार्ड में अतिरिक्त बाहरी संसाधनों, जैसे कि Teams की उपस्थिति या OneDrive फ़ाइलों के लिए अनुमतियों को कॉन्फ़िगर करने के लिए एक वैकल्पिक चरण शामिल है। अधिकांश एजेंटों को इसकी आवश्यकता नहीं होती है। आप प्रारंभिक सेटअप के बाद अनुमतियों को भी कॉन्फ़िगर कर सकते हैं a365 config permissions।

मौजूदा कॉन्फ़िगरेशन को अपडेट करना: फिर से चलाने a365 config init से आपका करंट a365.config.json डिफ़ॉल्ट के रूप में लोड हो जाता है. वर्तमान मान को बनाए रखने के लिए प्रत्येक संकेत पर Enter दबाएँ, या इसे अद्यतन करने के लिए कोई नया मान लिखें.

config display

वर्तमान एजेंट 365 CLI कॉन्फ़िगरेशन दिखाएँ।

a365 config display [options]

यह आदेश एजेंट 365 CLI के लिए वर्तमान कॉन्फ़िगरेशन सेटिंग्स प्रदर्शित करता है, ताकि आप अपने वर्तमान सेटअप की समीक्षा कर सकें।

display विकल्प

विकल्प	विवरण
-g, --generated	उत्पन्न कॉन्फ़िगरेशन ()a365.generated.config.json प्रदर्शित करें।
-a, --all	स्थिर और उत्पन्न कॉन्फ़िगरेशन दोनों प्रदर्शित करें।
-f, --field <field>	एकल फ़ील्ड के मान को आउटपुट करें (उदाहरण के लिए:)। --field messagingEndpoint
-?, , -h--help	मदद और उपयोग की जानकारी दिखाएं.

टिप्पणी

स्क्रिप्ट या अन्य आदेशों में उपयोग के लिए अपने कॉन्फ़िगरेशन से एकल मान पुनर्प्राप्त करने के लिए उपयोग करें --field । जब आप या के -aसाथ -g इस विकल्प का उपयोग करते हैं, तो सीएलआई पहले जेनरेट किए गए कॉन्फ़िगरेशन को खोजता है।

# Get the messaging endpoint from generated config
a365 config display -g --field messagingEndpoint

# Get a value from static config
a365 config display --field webAppName

कॉन्फ़िगरेशन फ़ाइल संरचना

CLI निम्न प्रमुख गुणों के साथ JSON कॉन्फ़िगरेशन फ़ाइल ()a365.config.json का उपयोग करता है:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}