قائمة وكلاء Microsoft Copilot Studio

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

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

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

ملحوظة

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

مهم

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

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

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

خصائص العامل

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

ملحوظة

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

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

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

مسار حقل واجهة برمجة التطبيقات نوع البيانات الوصف مثال Status
properties.harness سلسلة نصية نوع الحزام الخاص بالوكيل. تعرف على المزيد في Harnesses in Copilot Studio. Standard متوفرة بشكل عام
properties.displayName سلسلة نصية الاسم المعروض للعامل. Customer support agent متوفرة بشكل عام
properties.name GUID معرف العامل في بيئة Dataverse المحددة (معرف روبوت CDS). 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 365 Copilot Agent Builder. Copilot Studio متوفرة بشكل عام
properties.schemaName سلسلة نصية اسم مخطط Dataverse. متوفر لوكلاء Copilot Studio ووكلاء Microsoft 365 Copilot Agent Builder. cr5e3_agentName متوفرة بشكل عام
properties.isQuarantined boolean ما إذا كان الوكيل قيد الحجر الصحي حاليًا. false المعاينة
properties.quarantinedAt التاريخ والوقت تاريخ ووقت آخر عزل للعميل. 2026-02-01T08:00:00Z المعاينة
properties.isManaged boolean ما إذا كان الوكيل جزءًا من حل Dataverse مُدار. فارغ للوكلاء الذين تم إنشاؤهم في Agent Builder. false المعاينة

خصائص هوية Entra

مسار حقل واجهة برمجة التطبيقات نوع البيانات الوصف مثال Status
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.

تعرّف على المزيد في هويات الوكلاء والمصادقة في Copilot Studio.

خصائص التكوين

مسار حقل واجهة برمجة التطبيقات نوع البيانات الوصف مثال Status
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 يقبل الحقل القيم التالية:

قيمة الوصف
Classic يستخدم العامل التنسيق الكلاسيكي المستند إلى الموضوع مع أشجار الحوار التي تم تأليفها.
توليدي يستخدم هذا النظام التنسيق التوليدي، حيث يقوم نموذج الذكاء الاصطناعي باختيار المواضيع والأدوات بشكل ديناميكي.

أوضاع المصادقة

properties.authentication يقبل الحقل القيم التالية:

قيمة الوصف
‏‫لا شيء‬ لا يلزم المصادقة.
Microsoft Entra المصادقة عبر معرف Microsoft Entra.
OAuth 2.0 العام المصادقة عبر موفر OAuth 2.0 عمومي.

قدرات الوكيل

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

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

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

خصائص الموصل

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

الملكية نوع البيانات الوصف Status
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
    }
  }
}

خصائص المعرفة

يتضمن المخزون الخاصية التالية للمعرفة:

الملكية نوع البيانات الوصف Status
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 الحقل لفهم عدد الموارد التي تم تكوينها في عامل لكل نوع.

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

  • تاريخ آخر تحديث في