Ενσωμάτωση παρατηρησιμότητας για το Copilot Studio

Οι παράγοντες του Microsoft Copilot Studio εκπέμπουν αυτόματα τηλεμετρία στο παρασκήνιο παρατηρησιμότητας του Microsoft Agent 365—δεν απαιτείται μη αυτόματη ενορχήστρωση SDK. Αυτή η αυτόματη παρατηρησιμότητα παρέχει ορατότητα στη δραστηριότητα, τις επιδόσεις και τα σφάλματα του παράγοντα στο κέντρο διαχείρισης του Microsoft 365, το Microsoft Defender και το Microsoft Purview.

Αυτό το άρθρο εξηγεί πώς το Copilot Studio χειρίζεται αυτόματα την παρατηρησιμότητα και πού μπορείτε να προβάλετε δεδομένα τηλεμετρίας.

Σημείωμα

Για γενικές έννοιες παρατηρησιμότητας Agent 365 και χειροκίνητη παραμετροποίηση για pro-code παράγοντες, δείτε Agent observability. Το παρόν άρθρο επικεντρώνεται στην αυτόματη παρατηρησιμότητα των παραγόντων Copilot Studio.

Αυτόματη παρατηρησιμότητα

Οι παράγοντες του Copilot Studio εντάσσονται αυτόματα στο πλαίσιο παρατηρησιμότητας του Agent 365:

  • Δεν απαιτείται SDK: Σε αντίθεση με τους pro-code παράγοντες που χρειάζονται εγκατάσταση και ρύθμιση του OpenTelemetry SDK, το Copilot Studio διαχειρίζεται την παραγωγή τηλεμετρίας απευθείας στο runtime της πλατφόρμας.
  • Συμμόρφωση με το OpenTelemetry: Η τηλεμετρία ακολουθεί τις σημασιολογικές συμβάσεις του OpenTelemetry, διασφαλίζοντας συνέπεια με τους παράγοντες pro-code και άλλες πλατφόρμες.
  • Αυτόματη εισαγωγή: Η τηλεμετρία ρέει στο backend παρατηρησιμότητας του Agent 365 χωρίς πρόσθετη διαμόρφωση.
  • Άμεση διαθεσιμότητα: Τα δεδομένα παρατηρησιμότητας εμφανίζονται στο Κέντρο διαχείρισης Microsoft 365 μέσα σε λίγα λεπτά από τη δραστηριότητα του παράγοντα.

Αυτός ο αυτοματισμός επιτρέπει την κεντρική παρακολούθηση, την ανάλυση ασφάλειας και την αναφορά συμμόρφωσης χωρίς να απαιτείται παρέμβαση προγραμματιστή.

Ποια τηλεμετρία καταγράφεται

Το Copilot Studio εκπέμπει αυτόματα δύο σημασιολογικές συμβάσεις OpenTelemetry για παραγωγικά τμήματα AI:

Σημείωμα

  • Η τηλεμετρία συλλέγεται μόνο για συνεδρίες με έλεγχο ταυτότητας
  • Οι παράγοντες πολλών μισθωτών εξαιρούνται από την τηλεμετρία
  • Οι παράγοντες με ονόματα μεγαλύτερα από 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 και ο τύπος του παράγοντα που καλείται
  • Αναγνώριση εργαλείου: Το αναγνωριστικό και το όνομα του εκτελεσμένου εργαλείου
  • Ορίσματα εργαλείου: Ποια δεδομένα στάλθηκαν (ευαίσθητα δεδομένα που αποκρύφθηκαν)
  • Αναγνώριση χρήστη: Ποιος αλληλεπίδρασε με τον παράγοντα (κατά τη χρήση της ροής On-Behalf-Of)
  • Άλλα αναγνωριστικά: Αναγνωριστικά μισθωτή και περιβάλλοντος
  • Χρονικές σημάνσεις έναρξης και λήξης: Πότε ξεκίνησε και πότε ολοκληρώθηκε η εκτέλεση

Ακολουθεί ένα ακόμη παράδειγμα συμβάντος.

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