Microsoft Copilot Studio एजेंट इन्वेंट्री

Copilot Studio एजेंट इन्वेंट्री आईटी और सुरक्षा व्यवस्थापकों को किरायेदार में Copilot Studio या Agent Builder का उपयोग करके बनाए गए सभी एजेंटों का केंद्रीकृत दृश्य प्रदान करती है। इन्वेंट्री अप्रकाशित (ड्राफ्ट) और प्रकाशित एजेंटों दोनों को कवर करती है। प्रत्येक एजेंट के लिए, इन्वेंट्री प्रमुख मेटाडेटा प्रदर्शित करती है, जैसे कि एजेंट किसने बनाया, इसे आखिरी बार कब प्रकाशित किया गया था, इसे किन चैनलों पर तैनात किया गया है, यह उपयोगकर्ताओं को कैसे प्रमाणित करता है, इसकी क्षमताएं, और बहुत कुछ। इन्वेंटरी डेटा स्वचालित रूप से ताज़ा हो जाता है, और एजेंट में परिवर्तन आमतौर पर 20 मिनट के भीतर दिखाई देते हैं।

व्यवस्थापक कई तरीकों से इन्वेंट्री डेटा का उपभोग कर सकते हैं, जिसमें Power Platform व्यवस्थापन केंद्र, Power Platform API और Azure Resource Graph शामिल हैं. पहुँच विधियों और आवश्यक भूमिकाओं की पूरी सूची के लिए, Power Platform इन्वेंट्री देखें.

यह आलेख Power Platform इन्वेंट्री में Copilot Studio एजेंटों ()microsoft.copilotstudio/agents के लिए विशिष्ट फ़ील्ड का वर्णन करता है। सभी संसाधन प्रकारों पर उपलब्ध साझा फ़ील्ड के लिए, Power Platform इन्वेंट्री स्कीमा संदर्भ देखें.

नोट

इन्वेंट्री में Copilot Studio के V1 (जिसे क्लासिक बॉट या Power Virtual Agents के रूप में भी जाना जाता है) के साथ बनाए गए एजेंट शामिल नहीं हैं। हालाँकि, आप अभी भी Power Platform व्यवस्थापक केंद्र पर जा सकते हैं और उन एजेंटों को देखने के लिए Manage>Copilot Studio>Classic chatbots का चयन कर सकते हैं।

महत्वपूर्ण

इस आलेख में Microsoft Copilot Studio पूर्वावलोकन दस्तावेज़ शामिल हैं और यह परिवर्तन के अधीन है।

पूर्वावलोकन सुविधाएं उत्पादन में उपयोग के लिए नहीं होती हैं और इनकी कार्यक्षमता प्रतिबंधित हो सकती हैं. ये सुविधाएँ आधिकारिक रिलीज़ से पहले उपलब्ध हैं ताकि आप जल्दी पहुँच प्राप्त कर सकें और प्रतिक्रिया प्रदान कर सकें।

यदि आप उत्पादन के लिए तैयार एजेंट बना रहे हैं, तो Microsoft Copilot Studio का अवलोकन देखें.

एजेंट गुण

इन्वेंट्री प्रत्येक एजेंट के लिए निम्नलिखित गुण प्रदान करती है।

नोट

  • इन्वेंट्री प्रत्येक एजेंट के प्रकाशित संस्करण की संरचना को दर्शाती है। यदि किसी एजेंट के पास अप्रकाशित परिवर्तन (एक नया ड्राफ़्ट) है, तो एजेंट प्रकाशित होने तक इन्वेंट्री उन परिवर्तनों को नहीं दिखाती है।

  • किसी एजेंट का कॉन्फ़िगरेशन प्रभावित करता है कि कौन से फ़ील्ड पॉप्युलेट हैं। कुछ गुण इस बात पर निर्भर हो null सकते हैं कि एजेंट कैसे स्थापित किया गया है। उदाहरण के लिए, isManaged एजेंट बिल्डर में बनाए गए एजेंटों के लिए है null ।

मुख्य गुण

एपीआई फ़ील्ड पथ डेटा प्रकार विवरण उदाहरण स्थिति
properties.harness स्ट्रिंग एजेंट के लिए हार्नेस प्रकार। Copilot Studio में Harnesses के बारे में अधिक जानें। Standard आम तौर पर उपलब्ध
properties.displayName स्ट्रिंग एजेंट का प्रदर्शित नाम। Customer support agent आम तौर पर उपलब्ध
properties.name GUID विशिष्ट Dataverse वातावरण (CDS bot ID) में एजेंट की आईडी. aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.createdAt तिथिसमय एजेंट बनाए जाने की दिनांक और समय. 2024-12-13T04:00:00Z आम तौर पर उपलब्ध
properties.createdBy GUID एजेंट बनाने वाले उपयोगकर्ता की Entra ID। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.ownerId स्ट्रिंग एजेंट के वर्तमान स्वामी की ऑब्जेक्ट आईडी (Entra ID)। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.environmentId स्ट्रिंग Power Platform परिवेश का पहचानकर्ता जिसमें संसाधन शामिल है. aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.lastPublishedAt तिथिसमय एजेंट के अंतिम बार प्रकाशित होने की तारीख और समय। खाली/शून्य यदि एजेंट अभी भी ड्राफ्ट में है। 2026-01-15T10:30:00Z आम तौर पर उपलब्ध
properties.createdIn स्ट्रिंग संलेखन उपकरण जहां एजेंट बनाया गया था: Copilot Studio या Microsoft Copilot एजेंट बिल्डर। Copilot Studio आम तौर पर उपलब्ध
properties.schemaName स्ट्रिंग Dataverse स्कीमा का नाम। Copilot Studio एजेंटों और Microsoft Copilot एजेंट बिल्डर एजेंटों के लिए उपलब्ध है। cr5e3_agentName आम तौर पर उपलब्ध
properties.isQuarantined बूलियन क्या एजेंट वर्तमान में संगरोध में है। false पूर्वावलोकन
properties.quarantinedAt तिथिसमय एजेंट को आखिरी बार क्वारंटाइन करने की तारीख और समय। 2026-02-01T08:00:00Z पूर्वावलोकन
properties.isManaged बूलियन क्या एजेंट प्रबंधित Dataverse समाधान का हिस्सा है. एजेंट बिल्डर में बनाए गए एजेंटों के लिए शून्य। false पूर्वावलोकन

Entra पहचान गुण

एपीआई फ़ील्ड पथ डेटा प्रकार विवरण उदाहरण स्थिति
properties.botId स्ट्रिंग परिवेश में CDS बॉट की आईडी। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.entraAppId स्ट्रिंग एजेंट से जुड़ी Entra ऐप पंजीकरण आईडी, जब मौजूद हो। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.entraAgentId स्ट्रिंग Entra Agent ID, यदि उपलब्ध हो। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध
properties.entraAgentBlueprintId स्ट्रिंग Entra Agent Blueprint ID, यदि मौजूद हो। aaaa0000-bb11-2222-33cc-444444dddddd आम तौर पर उपलब्ध

नोट

सभी पहचान गुण सभी एजेंट प्रकारों के लिए उपलब्ध नहीं हैं: entraAppId एक विरासत पहचानकर्ता है, नए एजेंट उपयोग करते entraAgentId हैं और .entraAgentBlueprintId ये फ़ील्ड केवल तभी पॉप्युलेट होते हैं जब विशिष्ट एजेंट पर लागू होते हैं। इन पहचान गुणों में से कोई भी Microsoft Copilot Agent Builder एजेंटों के for लागू नहीं होता है।

इसके बारे में अधिक जानें: Copilot Studio में एजेंट पहचान और प्रमाणीकरण।

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

एपीआई फ़ील्ड पथ डेटा प्रकार विवरण उदाहरण स्थिति
properties.orchestration स्ट्रिंग एजेंट का ऑर्केस्ट्रेशन मोड ( ऑर्केस्ट्रेशन मोड में और जानें)। Generative पूर्वावलोकन
properties.model स्ट्रिंग एजेंट द्वारा उपयोग किया जाने वाला एआई मॉडल। gpt-4o पूर्वावलोकन
properties.authentication स्ट्रिंग एजेंट के लिए कॉन्फ़िगर किया गया प्रमाणीकरण मोड (प्रमाणीकरण मोड में अधिक जानें)। Microsoft Entra पूर्वावलोकन
properties.channels सरणी उन चैनलों के प्रदर्शित नाम, जिन पर एजेंट प्रकाशित किया गया है। ["Teams","SharePoint"] पूर्वावलोकन
properties.sharedWithViewers वस्तु व्यक्तिगत दर्शक उपयोगकर्ताओं ()userCount और दर्शक समूहों ()groupCount की संख्या जिनके साथ एजेंट साझा किया जाता है। यदि कोई निर्माता एजेंट को पूरे किरायेदार के साथ साझा करता है, entireTenant तो सेट किया trueजाता है, भले ही किसी व्यवस्थापक ने साझाकरण को मंजूरी न दी हो। "groupCount": 0, "userCount": 0, "entireTenant": false पूर्वावलोकन
properties.sharedWithEditors वस्तु व्यक्तिगत संपादक उपयोगकर्ताओं ()userCount और संपादक समूहों ()groupCount की गणना एजेंट के साथ साझा की जाती है। "groupCount": 0, "userCount": 0 पूर्वावलोकन
properties.capabilitiesCounts वस्तु कॉन्फ़िगर की गई क्षमताओं के प्रत्येक प्रकार की कुल अलग-अलग गणना "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 पूर्वावलोकन

ऑर्केस्ट्रेशन मोड

properties.orchestration फ़ील्ड निम्न मानों को स्वीकार करता है:

मूल्य विवरण
क्लासिक एजेंट लिखित संवाद पेड़ों के साथ क्लासिक विषय-आधारित ऑर्केस्ट्रेशन का उपयोग करता है।
जनरेटिव एजेंट जनरेटिव ऑर्केस्ट्रेशन का उपयोग करता है, जहां एक एआई मॉडल गतिशील रूप से विषयों और उपकरणों का चयन करता है।

प्रमाणीकरण मोड

properties.authentication फ़ील्ड निम्न मानों को स्वीकार करता है:

मूल्य विवरण
कोई नहीं किसी प्रमाणीकरण की आवश्यकता नहीं है।
Microsoft Entra Microsoft Entra ID के माध्यम से प्रमाणीकरण।
जेनेरिक OAuth 2.0 एक सामान्य OAuth 2.0 प्रदाता के माध्यम से प्रमाणीकरण।

एजेंट की क्षमताएं

यह खंड एजेंट की क्षमताओं (उपकरण और ज्ञान) को सूचीबद्ध करता है। वर्तमान में, यह केवल एजेंट द्वारा उपयोग किए जाने वाले कनेक्टर्स पर विस्तृत डेटा और निम्नलिखित अनुभागों में विस्तृत ज्ञान कॉन्फ़िगरेशन प्रदर्शित करता है।

इन्वेंट्री में प्रति एजेंट प्रत्येक प्रकार के अधिकतम 200 संसाधनों की सीमा होती है। ज्ञात सीमाओं में और जानें.

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

कनेक्टर गुण

इन्वेंट्री में एक सरणी शामिल होती है जिसे कहा जाता powerPlatformConnectorsहै, जिसमें एक एजेंट में कॉन्फ़िगर किए गए पावर प्लेटफ़ॉर्म कनेक्टर होते हैं। प्रत्येक कनेक्टर की पहचान इसके द्वारा connectorId की जाती है (कनेक्टर की संसाधन आईडी वाली एक स्ट्रिंग; उदाहरण के लिए, )। shared_excelonlinebusiness प्रत्येक कॉन्फ़िगर किए गए कनेक्टर के लिए, कॉन्फ़िगर किए गए operations की एक सूची होती है। सूची में निम्नलिखित गुण शामिल हैं:

प्रॉपर्टी डेटा प्रकार विवरण स्थिति
OperationId स्ट्रिंग कनेक्टर के भीतर विशिष्ट ऑपरेशन की आईडी; उदाहरण के लिए AddRowV2 पूर्वावलोकन
createdBy GUID वह उपयोगकर्ता जिसने कार्रवाई को कॉन्फ़िगर किया है पूर्वावलोकन
isEnabled बूलियन क्या कनेक्टर कार्रवाई वर्तमान में सक्षम है पूर्वावलोकन
usedAs स्ट्रिंग ऑपरेशन का उपयोग कैसे किया जाता है:
  • Tool यदि एक सामान्य उपकरण के रूप में कॉन्फ़िगर किया गया है
  • Topic Tool यदि किसी विशिष्ट विषय में एक उपकरण के रूप में कॉन्फ़िगर किया गया है
  • Knowledge यदि कनेक्टर को नॉलेज स्रोत के रूप में कॉन्फ़िगर किया गया है
 पूर्वावलोकन
requiresEndUserConsent बूलियन क्या एजेंट द्वारा ऑपरेशन का उपयोग करने से पहले अंतिम उपयोगकर्ताओं को सहमति देनी चाहिए पूर्वावलोकन
whenCanBeUsed स्ट्रिंग ऑपरेशन कब लागू किया जा सकता है:
  • Anytime यदि उपकरण एजेंट के लिए बिना किसी सीमा के उपलब्ध है
  • ViaDirectReferenceOnly यदि एजेंट टूल का उपयोग केवल तभी करता है जब निर्माता ने इसे विशिष्ट विषयों में स्पष्ट रूप से कॉन्फ़िगर किया हो
  • Conditional यदि एजेंट निर्माता द्वारा पूर्वनिर्धारित तर्क के अनुसार उपकरण का उपयोग कर सकता है
 पूर्वावलोकन
connectionProvider स्ट्रिंग ऑपरेशन के लिए कनेक्शन कौन प्रदान करता है:
  • User यदि अंतिम उपयोगकर्ता रनटाइम में क्रेडेंशियल्स प्रदान करता है
  • Maker यदि निर्माता लेखन समय पर कनेक्शन सेट करता है
 पूर्वावलोकन
connectionIdSharedByMaker GUID कनेक्शन आईडी, केवल तभी पॉप्युलेट किया जाता है जब connectionProvider = Maker पूर्वावलोकन
उदाहरण
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

ज्ञान गुण

इन्वेंट्री में ज्ञान के लिए निम्नलिखित गुण शामिल हैं:

प्रॉपर्टी डेटा प्रकार विवरण स्थिति
IsWebSearchEnabledForKnowledge बूलियन यह सच है यदि एजेंट वेब खोज को ज्ञान स्रोत के रूप में उपयोग कर सकता है पूर्वावलोकन

ज्ञात सीमाएँ

  • V1 एजेंट ट्रैक नहीं किए जाते हैं - इन्वेंट्री में मूल Power Virtual Agents V1 रनटाइम के साथ बनाए गए एजेंट शामिल नहीं हैं। यह केवल V2 (Copilot Studio) एजेंटों को ट्रैक करता है।
  • पहचान गुण सभी एजेंटों के लिए उपलब्ध नहीं हो सकता है - और entraAgentId फ़ील्ड entraAgentBlueprintId केवल नए Entra Agent ID मॉडल के साथ प्रोविज़न किए गए एजेंट्स के लिए पॉपुलेटेड हैं। पुराने एजेंटों के पास केवल entraAppId हो सकता है, और Microsoft Copilot एजेंट बिल्डर एजेंटों के पास इनमें से कोई भी पहचान गुण नहीं है।
  • क्षमताओं की गिनती - इन्वेंट्री में प्रति एजेंट प्रत्येक प्रकार के अधिकतम 200 संसाधनों की सीमा होती है। यदि किसी एजेंट के पास किसी विशिष्ट प्रकार (उदाहरण के लिए, Power Platform कनेक्टर) से 200 से अधिक कॉन्फ़िगर किए गए संसाधन हैं, तो इन्वेंट्री यादृच्छिक 200 प्रदर्शित करती है. व्यवस्थापक यह समझने के लिए फ़ील्ड का capabilitiesCounts उपयोग कर सकते हैं कि प्रति प्रकार एजेंट में कितने संसाधन कॉन्फ़िगर किए गए हैं।
  • पिछली बार को अपडेट किया गया