أتمتة تقييمات الوكيل باستخدام واجهة برمجة تطبيقات Power Platform

يوفر Copilot Studio للصانعين أدوات لتقييم أداء العامل باستمرار عن طريق تشغيل الاختبارات التلقائية مقابل مجموعات الاختبار المحددة مسبقا باستخدام Power Platform REST API. باستخدام واجهة برمجة تطبيقات REST، يمكنك تشغيل تقييمات العامل برمجيا كجزء من مهام سير عمل التطوير، مثل أثناء تحديثات العامل أو التحقق من صحة الإصدار أو اختبار التراجع.

يساعدك أتمتة التقييمات على:

  • التحقق من جودة العامل بعد إجراء التغييرات.
  • شغّل فحوصات أداء متكررة على وكلاء الإنتاج أو المرحلة التجريبية.
  • ادمج اختبار العاملين في مسارات CI/CD.
  • الكشف عن التراجعات في سلوك العامل في وقت مبكر من دورة حياة التطوير.

المتطلبات المسبقه

  • لديك معرف الروبوت ومعرف البيئة للعامل الهدف.
  • تم إنشاء مجموعة اختبار في Copilot Studio للوكيل المستهدف.
  • رمز مميز لوصول المستخدم صادر عن Microsoft Entra ID (OAuth 2.0). للحصول على الرمز المميز، راجع المصادقة.
    • احصل على الرمز المميز للوصول باستخدام معرف العميل لتسجيل تطبيق يحتوي على النطاق المناسب الممنوح ضمن واجهة برمجة تطبيقات Power Platform.

نظرة عامة على تشغيل التقييمات باستخدام واجهة برمجة تطبيقات REST

لتشغيل تقييم باستخدام واجهة برمجة تطبيقات Power Platform، اتبع الخطوات العامة التالية:

  1. أكمل المتطلبات الأساسية.
  2. ابحث عن معرف مجموعة الاختبار لمجموعة الاختبار التي تريد استخدامها واستردادها.
  3. قم بتشغيل التقييم.
  4. استرداد النتائج باستخدام معرف تشغيل التقييم.

عند نجاح الطلب، يتم تشغيل التقييم بشكل غير متزامن وينتج نتائج يمكنك مراجعتها في Copilot Studio.

عمليات واجهة برمجة التطبيقات لأتمتة التقييمات

يدعم Copilot Studio عمليات واجهة برمجة تطبيقات REST التي يمكنك استخدامها لتشغيل التقييمات برمجيا مقابل العامل باستخدام مجموعة اختبار موجودة.

لمزيد من المعلومات حول كيفية ووقت استخدام واجهة API في Power Platform، راجع:

الحصول على مجموعات اختبارات العاملين

  • نقطة النهاية: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets?api-version=2024-10-01
  • الغرض: استرداد صفيف من معرفات مجموعة الاختبار وتفاصيل أخرى لعامل معين.
  • الاستجابة: إرجاع قائمة تسمى value مجموعات الاختبار بالمعلومات التالية:
    • auditInfo: الطوابع الزمنية ومعرفات المستخدم لإنشاء وتعديل كل مجموعة من مجموعات الاختبار
    • displayName: اسم مجموعة الاختبار.
    • id: معرف مجموعة الاختبار. استخدم في بدء تقييم عامل لاختيار مجموعة الاختبار التي يجب استخدامها.
    • description: وصف مجموعة الاختبار.
    • state: حالة مجموعة الاختبار. تحتوي مجموعة الاختبار القابلة للاستخدام على الحالة Active.
    • totalTestCases: عدد حالات الاختبار داخل مجموعة الاختبار.

تعرف على المزيد في List Maker Evaluation Test Sets.

الحصول على تفاصيل مجموعات اختبارات العاملين

  • نقطة النهاية: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets/{TestSetId}?api-version=2024-10-01
  • الغرض: استرداد التفاصيل لمجموعة اختبار معينة، باستخدام معرف مجموعة الاختبار.
  • الاستجابة: إرجاع معلومات عنصر واحد في صفيف استجابة الحصول على مجموعات اختبارات العاملين .

تعرف على المزيد في List Maker Evaluation Test Sets.

بدء تقييم عامل

  • نقطة النهاية: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets/{TestSetId}/run?api-version=2024-10-01
  • الغرض: قم بتشغيل تقييم لمجموعة اختبار باستخدام مجموعة الاختبار.id يمكنك أيضا تضمين ملف تعريف مستخدملمصادقة الاتصالات أثناء تشغيل التقييم. استخدم mcsConnectionId لتحديد ملف تعريف المستخدم. إذا لم تقم بإضافة mcsConnectionId إلى مكالمتك، يتم تشغيل التقييم دون مصادقة.
  • الاستجابة: إرجاع المعلومات التالية:
    • runId: معرف تشغيل التقييم. استخدم هذا المعرف لاسترداد تفاصيل التقييم.
    • lastUpdatedAt: عند آخر تحديث لحالة عملية التشغيل.
    • executionState: حالة عملية التشغيل أثناء تنفيذ التقييم.
    • state: الحالة الحالية للتشغيل.
    • totalTestCases: إجمالي عدد حالات الاختبار في مجموعة الاختبار المستخدمة للتقييم.
    • testCasesProcessed: إجمالي حالات الاختبار التي تم تقييمها اعتبارا من التحديث الأخير.

تعرف على المزيد في تشغيل مجموعة اختبار تقييم Maker.

الحصول على عمليات تشغيل اختبارات العاملين

  • نقطة النهاية: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testruns?api-version=2024-10-01
  • الغرض: استرداد صفيف من كافة عمليات التشغيل السابقة.
  • الاستجابة: يتضمن كل عنصر في الصفيف نفس القيم الموجودة في الحصول على تفاصيل تشغيل اختبار العامل.

تعرف على المزيد في List Maker Evaluation Test Runs.

الحصول على تفاصيل تشغيل اختبارات العاملين

  • نقطة النهاية: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testruns/{TestRunId}?api-version=2024-10-01
  • الغرض: استرداد تفاصيل التقييم باستخدام runId لتشغيل التقييم الهدف الخاص بك.
  • الاستجابة: إرجاع المعلومات التالية:
    • id: معرف تشغيل التقييم. استخدم هذا المعرف لاسترداد تفاصيل التقييم.
    • environmentId: معرف بيئة العمل الخاصة بالوكيل.
    • cdsBotId: معرف العامل الهدف.
    • ownerId: معرف المستخدم الذي بدأ تشغيل التقييم.
    • testSetId: معرف مجموعة الاختبار المستخدمة للتقييم.
    • state: حالة تقدم التقييم.
    • startTime: عند بدء التقييم.
    • endTime: عند انتهاء التقييم، إذا انتهى.
    • name: اسم التقييم.
    • totalTestCases: إجمالي حالات الاختبار في مجموعة الاختبار.
    • mcsConnectionId: معرف الاتصال الخاص باتصال Copilot Studio لملف تعريف المستخدم المستخدم في عملية تشغيل التقييم. null إذا لم يكن هناك ملف تعريف مستخدم متصل.
    • testCasesResults: قائمة حالات الاختبار في تشغيل التقييم. يشمل:
      • testCaseId: معرف حالة الاختبار.
      • state: حالة إتمام الاختبار.
      • metricsResults: التفاصيل والنتائج لكل أسلوب اختبار مستخدم لحالة الاختبار. يتضمن ما يلي:
        • type: أسلوب الاختبار.
        • result: النتيجة النهائية لاختبار حالة الاختبار هذه. يتضمن ما يلي:
          • data: تفاصيل النتيجة. تعتمد القيم الدقيقة على أسلوب الاختبار. تعرف على المزيد في مستندات واجهة برمجة تطبيقات Power Platform. بالنسبة لاختبار الجودة العامة ، تتضمن الاستجابة ما يلي:
            • abstention: ما إذا كان العامل قد أجاب على الاستعلام.
            • relevance: ما إذا كانت الإجابة ذات صلة.
            • completeness: ما إذا كانت الإجابة كاملة.
        • status: حالة حالة الاختبار.
        • errorReason: إذا حدث خطأ، فسبب الخطأ.
        • aiResultReason: شرح الذكاء الاصطناعي لنتيجة حالة الاختبار.

تعرّف على المزيد في Get Maker Evaluation Test Run.

استخدام معرف Microsoft Studio Connector للتقييمات

بالنسبة إلى بدء تقييم عامل، يمكنك اختياريا إضافة معرف Microsoft Studio Connector إلى المكالمة كملف تعريف مستخدم للتقييم. للعثور على mcsConnectionId الخاص بك:

  1. انتقل إلى Power Automate.
  2. افتح صفحة الاتصالات .
  3. حدد اتصال Microsoft Copilot Studio.
  4. انسخ mcsConnectionId من عنوان URL: .../connections/shared_microsoftcopilotstudio/{mcsConnectionId}/details
  • Last updated on