העבר להסגר סוכנים שאינם תואמים ל-API של Power Platform

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

הסגרה של סוכנים היא חלק ממסגרת האבטחה הרחבה יותר של Copilot Studio , ועובדת בשיתוף פעולה עם הגישה הכוללת שלך לאבטחה ב-Copilot Studio.

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

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

חשוב

מרחב powervirtualgents השמות יצא משימוש. השתמש במרחב השמות copilotstudio בשיחות ה-API שלך.

‏‫דרישות מוקדמות‬

  • יש לך את מזהה הבוט ואת מזהה הסביבה של סוכן היעד.
  • עליך להשיג אסימון גישת משתמש שהונפק על-ידי Microsoft Entra ID OAuth2. כדי להשיג אסימון, ראה אימות.
    • המשתמש המשויך לאסימון חייב לכלול אחד מתפקידי הניהול הבאים:
      • מנהל דיירים כללי
      • מנהל בינה מלאכותית
      • מנהל Power Platform
    • עליך להשיג את אסימון הגישה באמצעות מזהה הלקוח של רישום יישום הכולל את טווח CopilotStudio.AdminActions.Invoke שהוענק במסגרת ה- API של Power Platform.

פעולות API עבור ניהול הסגר של סוכן

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

הערה

ממשקי ה- API SetAsQuarantined ו- SetAsUnquarantined אינם תומכים בצ'אטבוטים קלאסיים. ה-API חוזר 405 Method Not Allowed כאשר מנסים להעביר להסגר או לבטל את ההסגר של צ'אטבוט קלאסי.

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

קבל מצב הסגר של סוכן

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

למד עוד בתיעוד ההתייחסות של API לבדיקת מצב הסגר של בוט.

הגדר סוכן כהסגר

  • נקודת קצה: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • מטרה: סימון סוכן כהסגר, הגבלת הזמינות והאינטראקציות שלו
  • תגובה: אישור עדכון מצב הסגר

קבל מידע נוסף בתיעוד העיון בנושא הגדרת בוט כ- API בהסגר.

הגדרת סוכן כסוכן שאינו בהסגר

  • נקודת קצה: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • מטרה: הסר סוכן מהסגר לאחר הערכת סיכונים ותיקון
  • תגובה: אישור עדכון מצב הסגר

עיין במידע נוסף בתיעוד חומר עזר בנושא Set Bot As Unquarantined API.

  • Last updated on