एजेंट 365 सीएलआई

महत्त्वपूर्ण

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

एजेंट 365 सीएलआई Azure पर एजेंट 365 अनुप्रयोगों को परिनियोजित और प्रबंधित करने के लिए एक क्रॉस-प्लेटफ़ॉर्म कमांड-लाइन टूल है।

एजेंट 365 सीएलआई स्थापित करें

अपने ऑपरेटिंग सिस्टम पर Agent 365 CLI को वैश्विक रूप से स्थापित करने के लिए निम्न चरणों का उपयोग करें।

पूर्वावश्यकताएँ

आपके पास .NET स्थापित होना आवश्यक है। (.NET 8.0 की अनुशंसा की जाती है।

विंडोज़

Windows पर .NET स्थापित करें

लिनक्स

लिनक्स पर .NET स्थापित करें

मैकओएस

macOS पर .NET इंस्टॉल करें

डॉटनेट टूल इंस्टॉल का उपयोग करें

निम्न आदेश का उपयोग करके एजेंट 365 CLI स्थापित करें:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

यदि आपको कोई microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json त्रुटि प्राप्त होती है, तो पैरामीटर का --prerelease उपयोग करें क्योंकि इस पैकेज को अभी भी प्रीरिलीज़ के रूप में टैग किया जा सकता है।

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

नवीनतम निर्देशों और उपलब्ध संस्करणों के लिए, आधिकारिक NuGet पृष्ठ पर जाएँ: Microsoft.Agents.A365.DevTools.Cli NuGet.org

स्थापना सत्यापित करें

एजेंट 365 CLI को स्थापित करने के बाद, सत्यापित करें कि यह ठीक से चला कर स्थापित किया गया है:

a365 -h

यह कमांड मदद जानकारी प्रदर्शित करता है और पुष्टि करता है कि सीएलआई उपयोग के लिए तैयार है।

Update

डॉटनेट उपकरण अद्यतन आदेश का उपयोग करके एजेंट 365 CLI का अद्यतन करें:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

नोट

एजेंट 365 CLI के लिए सभी अद्यतनों के लिए नवीनतम Nuget पैकेज तक पहुँचने के लिए इंटरनेट कनेक्शन की आवश्यकता होती है: Microsoft.Agents.A365.DevTools.Cli

अनइंस्टॉल करें

डॉटनेट उपकरण स्थापना रद्द करें आदेश का उपयोग करके एजेंट 365 CLI की स्थापना रद्द करें:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

फ़ाइल स्थान

किसी उपकरण की निष्पादन योग्य फ़ाइल के लिए डिफ़ॉल्ट स्थान ऑपरेटिंग सिस्टम पर निर्भर करता है:

OS	पथ
लिनक्स/मैकओएस	$HOME/.dotnet/tools
Windows	%USERPROFILE%\.dotnet\tools

यह स्थान उपयोगकर्ता के पथ में तब जोड़ा जाता है जब SDK को पहली बार चलाया जाता है। इसलिए टूल स्थान निर्दिष्ट किए बिना किसी भी निर्देशिका से वैश्विक टूल को लागू किया जा सकता है।

टूल एक्सेस उपयोगकर्ता-विशिष्ट है, मशीन वैश्विक नहीं। एक वैश्विक उपकरण केवल उस उपयोगकर्ता के लिए उपलब्ध है जिसने उपकरण स्थापित किया है।

उपलब्ध आदेश

उपलब्ध आदेशों की पूरी सूची के लिए, आदेश का --help उपयोग करें या एजेंट 365 CLI संदर्भ देखें

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

इस खंड में एजेंट 365 CLI के साथ त्रुटियों का निवारण कैसे करें के बारे में जानकारी है।

CLI की स्थापना, अद्यतन या स्थापना रद्द करें विफल Not found in NuGet feeds

यदि आपको कोई microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json त्रुटि प्राप्त होती है, तो कृपया पैरामीटर का --prerelease उपयोग करें क्योंकि इस पैकेज को अभी भी प्रीरिलीज़ के रूप में टैग किया जा सकता है।

नवीनतम निर्देशों और उपलब्ध संस्करणों के लिए, आधिकारिक NuGet पृष्ठ पर जाएँ: Microsoft.Agents.A365.DevTools.Cli NuGet.org

सेटअप त्रुटि के साथ Authorization_RequestDenied विफल रहता है

यदि आपको आदेश चलातेsetupसमय कोई Authorization_RequestDenied त्रुटि प्राप्त होती है, तो यह आपके Microsoft Entra वातावरण में एक अनुमति समस्या को इंगित करता है।

सामान्य कारण

यह त्रुटि आमतौर पर तब होती है जब:

• आपके खाते में आवश्यक अनुमतियों का अभाव है
• Microsoft ग्राफ़ आदेश पंक्ति उपकरण अनुप्रयोग व्यवस्थापक सहमति की आवश्यकता होती है
• परस्पर विरोधी या अत्यधिक विशेषाधिकार प्राप्त अनुमतियाँ आपके परिवेश में मौजूद हैं

रिज़ॉल्यूशन चरण

1. सत्यापित करें कि आपके खाते में आवश्यक भूमिका है

   सुनिश्चित करें कि आपने किसी ऐसे खाते से साइन इन किया हुआ है जिसमें इनमें से कोई एक भूमिका है:

   • एजेंट आईडी डेवलपर
   • एजेंट आईडी प्रशासक
   • ग्लोबल व्यवस्थापक

2. Microsoft ग्राफ़ आदेश पंक्ति उपकरण के लिए व्यवस्थापक सहमति की समीक्षा करें और प्रदान करें

   a365 सेटअप आदेश Microsoft ग्राफ़ आदेश पंक्ति उपकरण अनुप्रयोग, जो परस्पर विरोधी अनुमतियाँ हो सकता है का उपयोग करता है।

   समीक्षा करने और ठीक करने के लिए:

   1. Azure पोर्टल में साइन इन करें.

   2. Microsoft ग्राफ़ कमांड लाइन उपकरण खोजें या अनुप्रयोग ID खोजें:14d82eec-204b-4c2f-b7e8-296a70dab67e

   3. नेविगेशन क्षेत्र से सुरक्षा>अनुमतियाँ चुनें.

   4. अनुमति के लिए Directory.AccessAsUser.All देखें

      • यह अत्यधिक विशेषाधिकार प्राप्त अनुमति ब्लूप्रिंट निर्माण में हस्तक्षेप करती है
      • यदि मौजूद है, तो इसे हटाने या इसे कम से कम विशेषाधिकार वाले विकल्पों के साथ बदलने पर विचार करें जैसे कि Directory.Read.All

      चेतावनी

      इस अनुमति को केवल तभी निकालें जब आप सुनिश्चित हों कि आपके परिवेश में अन्य टूल या स्क्रिप्ट के लिए इसकी आवश्यकता नहीं है

   5. यदि व्यवस्थापक की सहमति पहले से प्रदान नहीं की गई है, तो [आपके टैनेंट के लिए] व्यवस्थापक सहमति प्रदान करें का चयन करें.

3. परिवर्तन करने के बाद, फिर से चलाएँ a365 setup

अतिरिक्त संसाधन

इस ज्ञात समस्या के बारे में अधिक जानकारी के लिए, Microsoft Entra एजेंट ID ज्ञात समस्याएँ - Directory.AccessAsUser.All अन्य अनुमतियों पर ध्यान नहीं दिया जा करने के कारण देखें।