Microsoft Copilot Studio מלאי של סוכן

רשימת Copilot Studio מספקת למנהלי IT ואבטחה תצוגה מרוכזת של כל הסוכנים שנוצרו באמצעות Copilot Studio או בונה הסוכנים בדייר. המלאי מכסה הן סוכנים שלא פורסמו (טיוטה) והן סוכנים שפורסמו. עבור כל סוכן, המלאי מציג מטה-נתונים של מפתח, כגון מי יצר את הסוכן, מתי הוא פורסם לאחרונה, באילו ערוצים הוא נפרס, כיצד הוא מאמת משתמשים, את היכולות שלו ועוד. נתוני מלאי מתרעננים באופן אוטומטי, והשינויים בסוכן מופיעים בדרך כלל בתוך 20 דקות.

מנהלי מערכת יכולים לצרוך את נתוני המלאי בשיטות מרובות, כולל מרכז הניהול של Power Platform, ה- API של Power Platform ו- Azure Resource Graph. לקבלת הרשימה המלאה של שיטות הגישה ותפקידים נדרשים, ראה מלאי של Power Platform.

מאמר זה מתאר את השדות הספציפיים לנציגי Copilot Studio (microsoft.copilotstudio/agents) במלאי של Power Platform. עבור שדות משותפים הזמינים בכל סוגי המשאבים, ראה חומר עזר עבור סכימת מלאי של Power Platform.

הערה

המלאי אינו כולל סוכנים שנוצרו עם גירסה 1 של Copilot Studio (נקראים גם בוטים קלאסיים או Power Virtual Agents). עם זאת, עדיין תוכל לעבור אל מרכז הניהול של Power Platform ולבחור ניהול>Copilot Studio> צ'אטבוטים Classic כדי לראות נציגים אלה.

חשוב

מאמר זה מכיל תיעוד תצוגה מקדימה עבור Microsoft Copilot Studio והוא כפוף לשינויים.

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

אם אתה בונה סוכן המוכן לייצור, ראה Microsoft Copilot Studio Overview.

מאפייני סוכן

המלאי מספק את המאפיינים הבאים עבור כל סוכן.

הערה

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

  • תצורת סוכן משפיעה על השדות המאוכלסים. מאפיינים מסוימים עשויים null להיות תלויים באופן ההגדרה של הסוכן. לדוגמה, isManaged מיועד לסוכנים null שנוצרו ב- Agent Builder.

מאפייני ליבה

נתיב שדה API סוג נתונים תיאור לדוגמה סטטוס
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 תאריך ושעה התאריך והשעה שבהם הסוכן פורסם לאחרונה. ריק/Null אם הסוכן עדיין נמצא בטיוטה. 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 בוליאני אם הסוכן נמצא כעת בהסגר. false ‏‫תצוגה מקדימה‬
properties.quarantinedAt תאריך ושעה התאריך והשעה האחרונים שהסוכן היה בהסגר. 2026-02-01T08:00:00Z ‏‫תצוגה מקדימה‬
properties.isManaged בוליאני אם הסוכן הוא חלק מפתרון Dataverse מנוהל. Null עבור סוכנים שנוצרו ב- Agent Builder. false ‏‫תצוגה מקדימה‬

מאפייני הזהות של Entra

נתיב שדה API סוג נתונים תיאור לדוגמה סטטוס
properties.botId מחרוזת הסביבה מזהה הבוט של CDS. aaaa0000-bb11-2222-33cc-444444dddddd זמין לכלל המשתמשים
properties.entraAppId מחרוזת מזהה רישום יישום Entra המשויך לסוכן, כאשר קיים. aaaa0000-bb11-2222-33cc-444444dddddd זמין לכלל המשתמשים
properties.entraAgentId מחרוזת Entra Agent Identity ID, אם קיים. aaaa0000-bb11-2222-33cc-444444dddddd זמין לכלל המשתמשים
properties.entraAgentBlueprintId מחרוזת מזהה Entra Agent Blueprint, אם קיים. aaaa0000-bb11-2222-33cc-444444dddddd זמין לכלל המשתמשים

הערה

לא כל מאפייני הזהות זמינים עבור כל סוגי הסוכן: entraAppId הוא מזהה מדור קודם, סוכנים חדשים יותר משתמשים ב entraAgentId - ו- entraAgentBlueprintId. שדות אלה מאוכלסים רק כאשר הדבר ישים עבור הסוכן הספציפי. אף אחד ממאפיינים אלה של זהות אינו חל על סוכני Microsoft 365 Copilot Agent Builder.

לקבלת מידע נוסף על מושגי זהות מוגבלת, ראה רישום ליישומים, זהויות סוכן ואימות עבור Copilot Studio.

מאפייני תצורה

נתיב שדה API סוג נתונים תיאור לדוגמה סטטוס
properties.orchestration מחרוזת מצב התזמור של הסוכן (קבל מידע נוסף במצבי תזמור). Generative ‏‫תצוגה מקדימה‬
properties.model מחרוזת מודל הבינה המלאכותית המשמש את הסוכן. gpt-4o ‏‫תצוגה מקדימה‬
properties.authentication מחרוזת מצב האימות שתצורתו נקבעה עבור הסוכן (קבל מידע נוסף במצבי אימות). Microsoft Entra ‏‫תצוגה מקדימה‬
properties.channels מערך ** שמות התצוגה של הערוצים אליהם הסוכן מפורסם. ["Teams","SharePoint"] ‏‫תצוגה מקדימה‬
properties.sharedWithViewers אובייקט ספירת משתמשים בודדים של מציג (userCount) וקבוצות מציג (groupCount) שהסוכן משותף איתם. אם יוצר שיתף את הסוכן עם הדייר כולו, entireTenanttrueמוגדר ל- , גם אם מנהל מערכת לא אישר את השיתוף. "groupCount": 0, "userCount": 0, "entireTenant": false ‏‫תצוגה מקדימה‬
properties.sharedWithEditors אובייקט ספירת משתמשים בודדים של עורך (userCount) וקבוצות עורך (groupCount) שהסוכן משותף איתם. "groupCount": 0, "userCount": 0 ‏‫תצוגה מקדימה‬
properties.capabilitiesCounts אובייקט ספירה ייחודית כוללת של כל סוג של יכולות שתצורתן נקבעה "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 ‏‫תצוגה מקדימה‬

מצבי תזמור

השדה properties.orchestration מקבל את הערכים הבאים:

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

מצבי אימות

השדה properties.authentication מקבל את הערכים הבאים:

ערך: תיאור
ללא לא נדרש אימות.
Microsoft Entra אימות באמצעות מזהה Entra של Microsoft.
OAuth 2.0 גנרי אימות באמצעות ספק כללי של OAuth 2.0.

יכולות סוכן

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

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

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

מאפייני מחבר

המלאי כולל מערך בשם powerPlatformConnectors, המכיל את המחברים של Power Platform המוגדרים בסוכן. כל מחבר מזוהה על-ידי connectorId (מחרוזת המכילה את מזהה המשאב של המחבר; לדוגמה, shared_excelonlinebusiness). עבור כל מחבר שתצורתו נקבעה, קיימת רשימה של מחברים שתצורתם נקבעה operations. הרשימה כוללת את המאפיינים הבאים:

מאפיין‬ סוג נתונים תיאור סטטוס
OperationId מחרוזת המזהה של הפעולה הספציפית בתוך המחבר; לדוגמה AddRowV2 ‏‫תצוגה מקדימה‬
createdBy GUID המשתמש שהגדיר את הפעולה ‏‫תצוגה מקדימה‬
isEnabled בוליאני אם פעולת המחבר זמינה כעת ‏‫תצוגה מקדימה‬
usedAs מחרוזת אופן השימוש בפעולה:
  • Tool אם הוגדר ככלי כללי
  • Topic Tool אם הוגדר ככלי בנושא ספציפי
  • Knowledge אם המחבר מוגדר כמקור ידע
 ‏‫תצוגה מקדימה‬
requiresEndUserConsent בוליאני אם משתמשי קצה חייבים להסכים לפני שהסוכן יוכל להשתמש בפעולה ‏‫תצוגה מקדימה‬
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
    }
  }
}

מאפייני ידע

המלאי כולל את הנכס הבא לידע:

מאפיין‬ סוג נתונים תיאור סטטוס
IsWebSearchEnabledForKnowledge בוליאני נכון אם הסוכן יכול להשתמש בחיפוש באינטרנט כמקור ידע ‏‫תצוגה מקדימה‬

מגבלות ידועות

  • סוכני V1 אינם מסומנים - המלאי אינו כולל סוכנים שנוצרו עם זמן הריצה המקורי של Power Virtual Agents V1. הוא עוקב רק אחר סוכני V2 (Copilot Studio).
  • ייתכן שמציגי זהות לא יהיו זמינים עבור כל הסוכנים - entraAgentIdentraAgentBlueprintId השדות ו מאוכלסים רק עבור נציגים שהוקצו עבור מודל הזהות החדש יותר של Entra agent. ייתכן שלסוכנים ישנים יותר יש רק entraAppId, ולסוכנים של מחולל הסוכנים Microsoft 365 Copilot אין אף אחד ממאפייני הזהות האלה.
  • ספירת יכולות - המלאי כולל מגבלה של 200 משאבים לכל היותר מכל סוג לסוכן. אם לסוכן יש יותר מ- 200 משאבים שתצורתם נקבעה מסוג מסוים (לדוגמה, מחברי Power Platform), המלאי מציג 200 אקראיים. מנהלי מערכת יכולים להשתמש capabilitiesCounts בשדה כדי להבין כמה משאבים מוגדרים לסוכן לכל סוג.

תוכן קשור

  • Last updated on