مخزون العامل في Microsoft Copilot Studio

يوفر مخزون عوامل Copilot Studio لمسؤولي تكنولوجيا المعلومات والأمن عرضًا مركزيًا لجميع العوامل التي تم إنشاؤها باستخدام Copilot Studio أو Agent Builder ضمن المستأجر. يشمل المخزون كلا من العاملين غير المنشورين (المسودة) والمنشورين. يعرض المخزون لكل عامل البيانات الوصفية الرئيسية، مثل من أنشأ العامل، ومتى تم نشره آخر مرة، والقنوات التي تم نشر العامل فيها، وكيفية مصادقة المستخدمين، وقدراته، وغير ذلك. يتم تحديث بيانات الجرد تلقائيًا، وعادةً ما تظهر التغييرات على عامل خلال 20 دقيقة.

يمكن للمسؤولين استهلاك بيانات الجرد من خلال عدة طرق، بما في ذلك مركز إدارة Power Platform، وواجهة برمجة تطبيقات Power Platform، وAzure Resource Graph. للاطلاع على القائمة الكاملة لطرق الوصول والأدوار المطلوبة، راجع مخزون Power Platform.

تصف هذه المقالة الحقول الخاصة بعاملون Copilot Studio (microsoft.copilotstudio/agents) في مخزون Power Platform. للحقول المشتركة المتاحة على جميع أنواع الموارد، راجع مرجع مخطط مخزون Power Platform.

إشعار

لا يتضمن الجرد العاملون الذين تم إنشاؤهم باستخدام الإصدار الأول من Copilot Studio، والمعروفين أيضًا باسم الروبوتات الكلاسيكية أو Power Virtual Agents. ومع ذلك، لا يزال بإمكانك الانتقال إلى مركز إدارة Power Platform واختيار: إدارة> Copilot Studio>بوتات المحادثة الكلاسيكية لعرض العاملون.

مهم

تحتوي هذه المقالة على وثائق إصدار أولي Microsoft Copilot Studio وهي عرضة للتغيير.

ولا تُستخدم ميزات الإصدار الأولي في بيئة التشغيل وقد يتم تقيد بعض الوظائف بها. تتوفر هذه الميزات قبل الإصدار الرسمي حتى تتمكن من الحصول على وصول مبكر وتقديم التعليقات.

إذا كنت تقوم بإنشاء عامل جاهز للإنتاج، فشاهد نظرة عامة على Microsoft Copilot Studio.

خصائص العامل

يوفر المخزون الخصائص التالية لكل عامل.

إشعار

  • يعكس الجرد هيكل النسخة المنشورة لكل عامل. إذا كان لدى عامل تغييرات غير منشورة (مسودة أحدث)، فلن يظهر المخزون تلك التغييرات حتى يتم نشر عامل.

  • يؤثر تكوين العامل على الحقول التي يتم تعبئتها. قد تكون بعض الخصائص null حسب كيفية إعداد عامل. على سبيل المثال، isManaged هو null للعاملون الذين تم إنشاؤهم في Agent Builder.

الخصائص الأساسية

مسار حقل واجهة برمجة اَلْتطبيقات نوع البيانات الوصف مثال ‏الحالة‬
properties.displayName سلسلة الاسم المعروض للعامل. Customer support agent متوفرة بشكل عام
properties.name GUID معرّف الوكيل في بيئة Dataverse المحددة (معرّف روبوت CDS). aaaa0000-bb11-2222-33cc-444444dddddd متوفرة بشكل عام
properties.createdAt datetime تاريخ ووقت إنشاء العامل. 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 datetime تاريخ ووقت آخر نشر للعامل. فارغ/خالٍ إذا كان العامل لا يزال في المسودة. 2026-01-15T10:30:00Z متوفرة بشكل عام
properties.createdIn سلسلة أداة التأليف التي تم من خلالها إنشاء العامل: Copilot Studio أو Microsoft 365 Copilot Agent Builder. Copilot Studio متوفرة بشكل عام
properties.schemaName سلسلة اسم مخطط Dataverse. متاح لوكلاء Copilot Studio ووكلاء Microsoft 365 Copilot Agent Builder. cr5e3_agentName متوفرة بشكل عام
properties.isQuarantined boolean هل العامل معزول حالياً. false إصدار أولي
properties.quarantinedAt datetime تاريخ ووقت آخر عزل للعامل. 2026-02-01T08:00:00Z إصدار أولي
properties.isManaged boolean هل العامل جزءًا من حل Dataverse مُدار؟ قيمة فارغة للعاملون الذين تم إنشاؤهم في Agent Builder. false إصدار أولي

خصائص هوية Entra

مسار حقل واجهة برمجة اَلْتطبيقات نوع البيانات الوصف مثال ‏الحالة‬
properties.botId سلسلة معرف روبوت CDS في البيئة. aaaa0000-bb11-2222-33cc-444444dddddd متوفرة بشكل عام
properties.entraAppId سلسلة معرف تسجيل تطبيق Entra المرتبط بعامل، إذا كان موجوداً. aaaa0000-bb11-2222-33cc-444444dddddd متوفرة بشكل عام
properties.entraAgentId سلسلة معرف عامل Entra، إن وُجد. aaaa0000-bb11-2222-33cc-444444dddddd متوفرة بشكل عام
properties.entraAgentBlueprintId سلسلة معرف مخطط عامل Entra، إن وُجد. aaaa0000-bb11-2222-33cc-444444dddddd متوفرة بشكل عام

إشعار

ليست كل خصائص الهوية متاحة لجميع أنواع العوامل: entraAppId هو معرف قديم، بينما يستخدم العوامل الجدد entraAgentId و entraAgentBlueprintId. يتم تعبئة هذه الحقول فقط إذا كانت تنطبق على العامل المحدد. لا تنطبق أي من خصائص الهوية هذه على عاملون Microsoft 365 Copilot Agent Builder.

للمزيد من المعلومات حول مفاهيم هوية Entra، راجع تسجيل التطبيقات، هويات العاملون، والمصادقة الخاصة بـ 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 القيم التالية:

القيمة‬ الوصف
None غير مطلوب إجراء مصادقة
Microsoft Entra مصادقة عبر مُعرف Microsoft Entra ID.
OAuth 2.0 العام المصادقة عبر مزود OAuth 2.0 عام.

إمكَانَات العَامل

يسرد هذا القسم إمكانيات العامل (الأدوات والمعرفة) التي يستخدمها. حاليًا، يعرض فقط بيانات مفصلة عن الموصلات المستخدمة من قبل عامل وتكوين المعرفة كما هو موضح في الأقسام التالية.

يوجد حد أقصى قدره 200 مورد من كل نوع لكل عامل في المخزون. لمزيد من المعلومات، راجع القيود المعروفة.

يقوم المخزون تلقائيًا بإزالة الموارد المكررة، مثل موصل Power Platform الذي قمت بتهيئته مرتين في عامل بنفس الإعدادات.

خصائص الموصل

يتضمن المخزون مصفوفة تسمى powerPlatformConnectors، والتي تحتوي على موصلات Power Platform المُعدَّة في عامل. يتم تحديد كل موصل بواسطة connectorId (سلسلة تحتوي على معرف مورد الموصل؛ على سبيل المثال، shared_excelonlinebusiness). لكل موصل مكون، هناك قائمة من operations المكونة. تشمل القائمة الخصائص التالية:

الخاصية نوع البيانات الوصف الحالة
OperationId سلسلة معرف العملية المحددة داخل الموصل؛ على سبيل المثال، AddRowV2 إصدار أولي
createdBy GUID المستخدم الذي قام بتكوين العملية إصدار أولي
isEnabled boolean ما إذا كانت عملية الموصل مفعلة حالياً إصدار أولي
usedAs سلسلة كيفية استخدام العملية:
  • Tool إذا تم التكوين كأداة عامة
  • Topic Tool إذا تم تكوينها كأداة في موضوع محدد
  • Knowledge إذا تم تكوين الموصل كمصدر معرفي
 إصدار أولي
requiresEndUserConsent boolean ما إذا كان يجب على المستخدمين النهائيين الموافقة قبل أن يتمكن عامل من استخدام العملية إصدار أولي
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 boolean صحيح إذا كان بإمكان عامل استخدام البحث على الويب كمصدر معرفي إصدار أولي

القيود المعروفة

  • العاملون من الإصدار V1 غير متتبعين - المخزون لا يشمل العاملين الذين تم إنشاؤهم باستخدام بيئة تشغيل Power Virtual Agents V1 الأصلية. يتتبع فقط عملاء V2 (Copilot Studio).
  • قد لا تكون خصائص الهوية متاحة لجميع العاملون - يتم تعبئة حقلي entraAgentId وentraAgentBlueprintId فقط للعاملون الذين تم توفيرهم باستخدام نموذج هوية عامل Entra الأحدث. قد يكون لدى العاملون القدامى فقط entraAppId، بينما عامل Microsoft 365 Copilot Agent Builder لا تتوفر لديهم أي من هذه الخصائص المتعلقة بالهوية.
  • عدد الإمكانيات - يحتوي المخزون على حد أقصى يبلغ 200 مورد من كل نوع لكل عامل. إذا كان لدى العامل أكثر من 200 مورد مُكوَّن من نوع محدد (على سبيل المثال، موصلات Power Platform)، فإن المخزون يعرض 200 مورد عشوائيًا فقط. يمكن للمسؤولين استخدام الحقل capabilitiesCounts لمعرفة عدد الموارد المكونة في عامل حسب النوع.

المحتوى ذو الصلة

  • Last updated on