Copilot Studion havaittavuuden integrointi

Microsoft Copilot Studio -agentit lähettävät automaattisesti telemetriaa Microsoft Agent 365:n havaittavuuden taustajärjestelmään—manuaalista SDK-instrumentointia ei tarvita. Tämä automaattinen havaittavuus tarjoaa näkyvyyden agenttien toimintaan, suorituskykyyn ja virheisiin Microsoft 365 -hallintakeskuksessa, Microsoft Defenderissä ja Microsoft Purview'ssa.

Tässä artikkelissa selitetään, miten Copilot Studio käsittelee havaittavuutta automaattisesti ja missä telemetriadataa voi tarkastella.

Muistiinpano

Yleisiä Agent 365:n havaittavuuskäsitteitä ja manuaalista instrumentointia pro-koodiagenteille löytyy kohdasta Agentin havaittavuus. Tämä artikkeli keskittyy Copilot Studio -agenttien automaattiseen havaittavuuteen.

Automaattinen havainnointi

Copilot Studio -agentit osallistuvat automaattisesti Agent 365 -havaittavuusjärjestelmään:

  • SDK:ta ei tarvita: Toisin kuin pro-code-agentit, jotka vaativat OpenTelemetry SDK:n asennuksen ja konfiguroinnin, Copilot Studio hoitaa kaiken telemetrian lähetyksen alustan käyttöympäristössä.
  • OpenTelemetryn vaatimustenmukaisuus: Telemetria noudattaa OpenTelemetryn semanttisia käytäntöjä, varmistaen yhtenäisyyden pro-code-agenttien ja muiden alustojen kanssa.
  • Automaattinen vastaanotto: Telemetria kulkee Agent 365:n havaittavuustaustajärjestelmään ilman lisäkonfiguraatiota.
  • Välitön saatavuus: Havaittavuustiedot ovat saatavilla Microsoft 365 -hallintakeskuksessa muutaman minuutin sisällä agentin toiminnasta.

Tämä automaatio mahdollistaa keskitetyn valvonnan, tietoturva-analyysin ja vaatimustenmukaisuuden raportoinnin ilman kehittäjän työtä.

Mitä telemetriatietoja kerätään

Copilot Studio tuottaa automaattisesti kaksi OpenTelemetryn semanttista konventiota generatiivisen tekoälyn alueiden jäljitykseen:

Muistiinpano

  • Telemetriaa tallennetaan vain todennettuja istuntoja varten
  • Monivuokrausagentit jätetään telemetrian ulkopuolelle
  • Agentteja, joiden nimi ylittää 42 merkkiä, ei tallenneta
  • Liian suuret syötteet ja tulosteet katkaistaan automaattisesti seuraavissa kentissä:
    • Tulosviestit
    • Työkaluparametrit
    • Työkalun vastaus (gen_ai.event.content)
    • Agentin kuvaus

Käynnistä agentti

Tallentaa agentin kutsutoimintaa:

  • Agentin tunnistetiedot: Kutsutun agentin tunnus, nimi, Entra ID -tunnus ja tyyppi
  • Käyttäjän tunnistus: Kuka oli vuorovaikutuksessa agentin kanssa (kun käytettiin On-Behalf-Of-virtaa)
  • Syöte: Käyttäjän agentille lähettämä viesti (arkaluonteiset tiedot poistettu)
  • Muut tunnisteet: vuokraajan ja ympäristön tunnukset
  • Aloitus- ja lopetusaikaleimat: Kun kutsu alkoi ja päättyi

Esimerkkitapahtuma

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

Vastausviesti

Tallentaa agentin tuloksen:

  • Tulosviesti: Agentin vastaus käyttäjälle (Arkaluonteiset tiedot poistettu)

Muistiinpano

Virheilmoitukset agentin kutsuista tai työkalun suorituksista kirjataan tulosviesteinä.

Seuraavassa on toinen esimerkkitapahtuma.

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

Työkalun suoritus

Tallentaa työkalun suorituksen, kun agentti käyttää liittimiä tai toimintoja:

  • Agentin tunnistetiedot: Kutsutun agentin tunnus, nimi, Entra ID -tunnus ja tyyppi
  • Työkalun tunnistus: Suoritetun työkalun tunnus ja nimi
  • Työkaluargumentit: Mitä dataa lähetettiin (Arkaluonteiset tiedot poistettu)
  • Käyttäjän tunnistus: Kuka oli vuorovaikutuksessa agentin kanssa (kun käytettiin On-Behalf-Of-prosessia)
  • Muut tunnisteet: vuokraajan ja ympäristön tunnukset
  • Aloitus- ja lopetusaikaleimat: milloin suoritus alkoi ja päättyi

Seuraavassa on toinen esimerkkitapahtuma.

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

Kaikki telemetria kunnioittaa yksityisyyden rajoja. Viesteissä ja työkalujen syötteissä sekä tulosteissa oleva arkaluonteinen käyttäjätieto on peitetty eikä näy ylläpitäjille. Telemetriaa käytetään sisäisen turvallisuuden valvontaan ja vaatimustenmukaisuuden tarkoituksiin.

Seuraavat vaiheet

  • Last updated on