אינטגרציה לניראות עבור Copilot Studio

סוכני Microsoft Copilot Studio משדרים אוטומטית נתוני מדידת שימוש ל-backend של Microsoft Agent 365 – ללא צורך במדידת SDK ידנית. תצפית אוטומטית זו מספקת נראות לפעילות סוכנים, ביצועים ושגיאות ברחבי מרכז הניהול של Microsoft 365, Microsoft Defender ו-Microsoft Purview.

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

הערה

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

יכולת צפייה אוטומטית

סוכני Copilot Studio משתתפים באופן אוטומטי במסגרת ניראות של Agent 365:

  • אין צורך ב-SDK: בניגוד לסוכני קוד מקצועי שדורשים התקנה והגדרת OpenTelemetry SDK, ‏Copilot Studio מטפל בכל נתוני מדידת השימוש בזמן הריצה של הפלטפורמה.
  • תאימות של OpenTelemetry: מדידת שימוש פועלת לפי קונבנציות סמנטיות של OpenTelemetry, ומבטיחה עקביות עם סוכני קוד מקצועי ופלטפורמות אחרות.
  • קליטה אוטומטית: מדידת השימוש מועברת למערכת הניראות של הקצה עורפי של Agent 365 ללא צורך בהגדרות נוספות.
  • זמינות מיידית: נתוני ניטור מופיעים במרכז הניהול של Microsoft 365 בתוך דקות מפעילות הסוכן.

האוטומציה הזו מאפשרת ניטור מרכזי, ניתוח אבטחה ודיווח תאימות ללא מאמץ מצד המפתחים.

אילו נתוני מדידת שימוש נאספים?

Copilot Studio משדר אוטומטית שתי קונבנציות סמנטיות של OpenTelemetry עבור טווחי בינה מלאכותית גנרטיבית:

הערה

  • מדידת שימוש נלכדת רק בהפעלות מאומתות
  • סוכנים מרובי דיירים אינם כלולים במדידת שימוש
  • סוכנים עם שמות ארוכים מ-42 תווים לא נרשמים
  • קלטים ופלטים גדולים מוקצים אוטומטית בשדות הבאים:
    • הודעות פלט
    • ארגומנטים של כלי
    • תגובת כלי (gen_ai.event.content)
    • תיאור הסוכן

הפעלת סוכן

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

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

אירוע לדוגמה

{
  "Name": "InvokeAgent",
  "Attributes": {
    "gen_ai.operation.name": "invoke_agent",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.execution.type": "HumanToAgent",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "gen_ai.input.messages": "What's the weather in Seattle?",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000000000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

הודעת פלט

לוכד את תוצאת הסוכן:

  • הודעת פלט: תגובת הסוכן למשתמש (נתונים רגישים הוסתרו)

הערה

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

להלן אירוע נוסף לדוגמה.

{
  "Name": "OutputMessages",
  "Attributes": {
    "gen_ai.operation.name": "output_messages",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.output.messages": "The current weather in **Seattle, WA** is:\n\n- **Temperature:** 18°C (feels like 17°C)...",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 0,
  "EndTimeUnixNano": 1700000005000000000,
  "SpanId": "bbbb2222-cccc-3333-dddd-444444444444",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

הפעלת כלי

אירוע זה מתעד ביצוע כלי כאשר הסוכן שלך משתמש במחברים או בפעולות:

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

להלן אירוע נוסף לדוגמה.

{
  "Name": "ExecuteTool",
  "Attributes": {
    "gen_ai.operation.name": "execute_tool",
    "gen_ai.agent.id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "gen_ai.agent.name": "customer-support-agent",
    "gen_ai.agent.applicationid": "12345678-90ab-cdef-1234-567890abcdef",
    "gen_ai.agent.platformid": "Default-11111111-2222-3333-4444-555555555555_01234567-89ab-cdef-0123-456789abcdef",
    "gen_ai.agent.type": "CopilotStudio",
    "tenant.id": "11111111-2222-3333-4444-555555555555",
    "gen_ai.tool.name": "msnweather:CurrentWeather",
    "gen_ai.tool.arguments": "{\"Location\":\"Seattle, WA\",\"units\":\"C\"}",
    "gen_ai.tool.call.id": "/providers/Microsoft.PowerApps/apis/shared_msnweather:CurrentWeather:abcdef12-3456-7890-abcd-ef1234567890",
    "gen_ai.tool.type": "Power Platform Connector",
    "gen_ai.conversation.id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "gen_ai.event.content": "{ /* tool execution results */ }",
    "gen_ai.channel.name": "Copilot Studio Test Pane",
    "gen_ai.caller.id": "99999999-8888-7777-6666-555555555555",
    "gen_ai.caller.upn": "alex.smith@contoso.com",
    "gen_ai.caller.name": "Alex Smith",
    "gen_ai.caller.client.ip": "192.168.1.100",
    "gen_ai.caller.tenantid": "11111111-2222-3333-4444-555555555555",
    "env.id": "Default-11111111-2222-3333-4444-555555555555"
  },
  "StartTimeUnixNano": 1700000002000000000,
  "EndTimeUnixNano": 0,
  "SpanId": "cccc3333-dddd-4444-eeee-555555555555",
  "ParentSpanId": "aaaa1111-bbbb-2222-cccc-333333333333"
}

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

‏‫השלבים הבאים‬

  • Last updated on