הפיכת הערכות סוכן לאוטומטיות באמצעות API של Power Platform

הערה

המאפיינים במאמר זה מופעלים על ידי הרתמה הסטנדרטית, המשתמשת באפשרויות החיוב המתוארות ברישוי לסוכנים המופעלים על ידי הרתמה הסטנדרטית. למד כיצד לגשת ליכולות סטנדרטיות ב-גישה לסוכנים סטנדרטיים ולתזרימי סוכן.

Copilot Studio מספק לי יצרנים כלים להערכה רציפה של ביצועי סוכן על-ידי הפעלת בדיקות אוטומטיות מול ערכות בדיקה מוגדרות מראש באמצעות ממשק ה- REST API של Power Platform REST API. על-ידי שימוש ב- REST API, באפשרותך להפעיל באופן תיכנותי הערכות סוכן כחלק מזרימות העבודה של הפיתוח שלך, כגון במהלך עדכוני סוכן, אימות הפצה או בדיקת רגרסיה.

הערכות אוטומטיות עוזרות לך:

• ודא את איכות הסוכן לאחר ביצוע שינויים.
• הפעל בדיקת ביצועים חוזרת מול נציגי ייצור או נציגי אחסון זמני.
• שלב בדיקת סוכן בצינורות CI/CD.
• לזהות רגרסיות בהתנהגות הסוכן בשלבים מוקדמים של מחזור הפיתוח.

דרישות מוקדמות

• יש לך מזהה רובוט ומזהה סביבה עבור סוכן היעד.
• ערכת בדיקה נוצרה ב-Copilot Studio עבור סוכן היעד שלך.
• אסימון גישת משתמש שהונפק על-ידי Microsoft Entra ID (OAuth 2.0). כדי לקבל את האסימון, ראה אימות.
  • רכוש את אסימון הגישה באמצעות מזהה הלקוח של רישום יישום בעל הטווח המתאים שהוענק במסגרת ה- API של Power Platform.

מבט כולל על הפעלת הערכות באמצעות REST API

כדי להפעיל הערכה באמצעות ה- API של Power Platform, בצע שלבים כלליים אלה:

1. השלם את הדרישות המוקדמות.
2. חפש ואחזר את מזהה ערכת הבדיקה של ערכת הבדיקה שבה ברצונך להשתמש.
3. הפעל את ההערכה.
4. אחזר את התוצאות באמצעות מזהה הפעלת ההערכה.

כאשר הבקשה מצליחה, ההערכה פועלת באופן אסינכרוני ומפיקה תוצאות שבאפשרותך לסקור Copilot Studio.

פעולות API להפיכת הערכות לאוטומטיות

Copilot Studio תומכת בפעולות REST API שניתן להשתמש בהן כדי להפעיל הערכות באופן תיכנותי מול הסוכן שלך באמצעות ערכת בדיקה קיימת.

לקבלת מידע נוסף על האופן וה מתי להשתמש ב- API של Power Platform, ראה:

• API ו- SDK של Power Platform: מ- UX-תחילה ל- API-first (בלוג למפתחים של Power Platform)
• מבט כולל על אפשרויות תיכנות והרחבה
• תחילת העבודה עם ה- API של Power Platform
• פעולות API של Power Platform עבור סוכני Copilot Studio

קבל ערכות בדיקת סוכן

• נקודת קצה: 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.

קבל פרטים של מערך בדיקת סוכן

• נקודת קצה: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets/{TestSetId}?api-version=2024-10-01
• מטרה: אחזר פרטים עבור ערכת בדיקה ספציפית, באמצעות מזהה ערכת הבדיקה.
• תגובה: מחזיר את המידע על פריט אחד במערך התגובה של Get agent test sets.

למידע נוסף, ראו ערכות הבדיקה להערכת List Maker.

התחל הערכת סוכן

• נקודת קצה: 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: סך כל מקרי הבדיקה שהוערכים נכון לעדכון האחרון.

קבל מידע נוסף בערכת הבדיקה Run Maker Evaluation.

קבל הפעלת בדיקת סוכן

• נקודת קצה: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testruns?api-version=2024-10-01
• מטרה: אחזור מערך של כל ההפעלות הקודמות.
• תגובה: כל פריט במערך כולל את אותם ערכים כמו שנמצאו בפרטי הפעלת בדיקת סוכן.

למידע נוסף, ראו הרצות בדיקה של List Maker Evaluation.

קבל פרטי הרצת בדיקת סוכן

• נקודת קצה: 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: פרטי התוצאה. הערכים המדויקים תלויים בשיטת הבדיקה. קבל מידע נוסף במסמכי ה- API של Power Platform. לבדיקת איכות כללית , התגובה כוללת את הפריטים הבאים:
          • abstention: אם הסוכן ענה על השאילתה.
          • relevance: אם התשובה היתה רלוונטית.
          • completeness: אם התשובה הושלמה.
      • status: המצב של מקרה הבדיקה.
      • errorReason: אם אירעה שגיאה, הגורם לשגיאה.
      • aiResultReason: ההסבר לגבי בינה מלאכותית לגבי תוצאת מקרה הבדיקה.

קבל מידע נוסף ב - Get Maker Evaluation Test Run.

השתמש במזהה Microsoft Studio Connector להערכה

עבור התחל הערכת סוכן, באפשרותך להוסיף לשיחה מזהה המחבר של Microsoft Studio כפרופיל משתמש לצורך ההערכה. כדי למצוא את mcsConnectionId:

1. עבור אל Power Automate.
2. פתח את הדף חיבורים .
3. בחר את Microsoft Copilot Studio לחיבור.
4. העתק את כתובת mcsConnectionId ה- URL מכתובת ה- URL: .../connections/shared_microsoftcopilotstudio/{mcsConnectionId}/details

מאמרים קשורים

• אודות הערכת סוכן
• הפעלת הערכות סוכן באמצעות מחברים