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

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

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

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

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

חשוב

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

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

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

פעולות API לניהול בידוד סוכנים

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

הערה

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

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

קבל סטטוס הסגר של תוכנית Bot

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

למדו עוד בתיעוד העזר של Get Bot Quarantine Status API.

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

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

למדו עוד בתיעוד העזר של Set Bot As Quarantined 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