מלאי סוכנים של Microsoft Copilot Studio

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

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

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

הערה

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

חשוב

מאמר זה כולל תיעוד של גרסת Preview של Microsoft Copilot Studio ועשוי להשתנות.

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

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

מאפייני סוכן

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

הערה

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

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

מאפייני ליבה

נתיב שדה API	סוג נתונים	Description	דוגמה	סטטוס
properties.displayName	string	שם התצוגה של הסוכן.	Customer support agent	זמין לכלל המשתמשים
properties.name	GUID	מזהה הסוכן בסביבת Dataverse הספציפית (מזהה הבוט של CDS).	aaaa0000-bb11-2222-33cc-444444dddddd	זמין לכלל המשתמשים
properties.createdAt	datetime	התאריך והשעה שבהם הסוכן נוצר.	2024-12-13T04:00:00Z	זמין לכלל המשתמשים
properties.createdBy	GUID	מזהה Entra של המשתמש שיצר את הסוכן.	aaaa0000-bb11-2222-33cc-444444dddddd	זמין לכלל המשתמשים
properties.ownerId	string	מזהה האובייקט (מזהה Entra) של הבעלים הנוכחי של הסוכן.	aaaa0000-bb11-2222-33cc-444444dddddd	זמין לכלל המשתמשים
properties.environmentId	string	המזהה של סביבת Power Platform שמכילה את המשאב.	aaaa0000-bb11-2222-33cc-444444dddddd	זמין לכלל המשתמשים
properties.lastPublishedAt	datetime	התאריך והשעה שבהם הסוכן פורסם לאחרונה. המצב יהיה ריק/null אם הסוכן עדיין במצב טיוטה.	2026-01-15T10:30:00Z	זמין לכלל המשתמשים
properties.createdIn	string	כלי העריכה שבו הסוכן נוצר: Copilot Studio או Microsoft 365 Copilot Agent Builder.	Copilot Studio	זמין לכלל המשתמשים
properties.schemaName	string	שם הסכימה של Dataverse. זמין עבור סוכני Copilot Studio וסוכני Microsoft 365 Copilot Agent Builder.	cr5e3_agentName	זמין לכלל המשתמשים
properties.isQuarantined	boolean	האם הסוכן נמצא כעת בהסגר.	false	Preview
properties.quarantinedAt	datetime	התאריך והשעה שבהם הסוכן הועבר לאחרונה להסגר.	2026-02-01T08:00:00Z	Preview
properties.isManaged	boolean	האם הסוכן הוא חלק מפתרון Dataverse מנוהל. Null עבור סוכנים שנוצרו ב-Agent Builder.	false	Preview

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

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

הערה

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

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

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

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

מצבי תיאום

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

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

מצבי אימות

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

ערך	Description
ללא	לא נדרש אימות.
Microsoft Entra	אימות באמצעות Microsoft Entra ID.
OAuth 2.0 כללי	אימות באמצעות ספק OAuth 2.0 כללי.

יכולות סוכן

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

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

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

מאפייני מחבר

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

מאפיין‬	סוג נתונים	Description	סטטוס
OperationId	string	המזהה של הפעולה הספציפית במחבר; לדוגמה, AddRowV2	Preview
createdBy	GUID	המשתמש שהגדיר את הפעולה	Preview
isEnabled	boolean	האם פעולת המחבר מופעלת כעת	Preview
usedAs	string	אופן השימוש בפעולה: ToolTool אם היא מוגדרת ככלי כללי Topic Tool אם היא מוגדרת ככלי בנושא מסוים Knowledge אם המחבר מוגדר כמקור ידע	Preview
requiresEndUserConsent	boolean	האם משתמשי הקצה חייבים לתת את הסכמתם לפני שהסוכן יוכל להשתמש בפעולה	Preview
whenCanBeUsed	string	מתי ניתן להפעיל את הפעולה: Anytime אם הכלי זמין לסוכן ללא הגבלות ViaDirectReferenceOnly אם הסוכן משתמש בכלי רק כאשר היוצר הגדיר אותו במפורש בנושאים מסוימים Conditional אם הסוכן יכול להשתמש בכלי בהתאם ללוגיקה שהיוצר הגדיר מראש	Preview
connectionProvider	string	מי מספק את החיבור עבור הפעולה: User אם משתמש הקצה מספק אישורים בזמן ריצה Maker אם היוצר מגדיר את החיבור בזמן העריכה	Preview
connectionIdSharedByMaker	GUID	מזהה החיבור, המאוכלס רק כאשר connectionProvider = Maker	Preview

דוגמה

{
  "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
    }
  }
}

מאפייני ידע

המלאי כולל את המאפיין הבא לידע:

מאפיין‬	סוג נתונים	Description	סטטוס
IsWebSearchEnabledForKnowledge	boolean	True אם הסוכן יכול להשתמש בחיפוש באינטרנט כמקור ידע	Preview

‏‫מגבלות ידועות‬

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

תוכן קשור

• מלאי Power Platform
• חומר העזר לסכימת מלאי Power Platform
• API של מלאי Power Platform