Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
Denne artikkelen er den kanoniske attributt-for-attributt-spesifikasjonen som brukes av Agent 365s inntakspipeline. Hver spenn som importeres av Agent 365 – enten det sendes ut av Microsoft OpenTelemetrie-distribusjonen, den utdaterte Agent 365 Observability SDK, eller sendes direkte OTel – må være i samsvar med den. Hver oppføring viser operasjonstypene attributten gjelder for, om det er obligatorisk, feltnavnet verdien din havner i for avanserte jaktforespørsler (der en slik finnes), og effekten hvis du hopper over den.
Hvis du bruker SDK-en eller distribusjonen, sender SDK-en ut disse egenskapene for deg. Seksjonen for plukkeverdier gjelder bare når du må overstyre en standard. Hvis du bruker den direkte OTel-stien, emitterer du alle attributter manuelt. For hvordan du setter dem sammen til en forespørsel, se integrasjonsguiden.
Attribute table
Alle verdier sendes som stringValue - Token-tellinger må være "42" (ikke 42); porter må være "443" (ikke 443).
Operasjon legende.IA = invoke_agent, ET, = execute_toolCH = chat, OM, = output_messagesAll = gjelder for alle operasjoner.
Required legend.
- M: mandatory.
- M*1: obligatorisk kun for embodied agents (agenten har sin egen Entra Agent ID-brukerkonto).
- M*2: obligatorisk kun for agent-til-agent-samtaler.
-
M*3: obligatorisk kun for ikke-root spans. Roten
invoke_agenthar ingen forelder. - O*4: valgfritt, kun meningsfullt når spennstatusen er Feil.
- O: optional.
- N/A: ikke send ut. Agent 365 fylles automatisk.
Kolonnen "RawEventData" navngir en JSON-nøkkel inne i CloudAppEvents.RawEventData den kanoniske avanserte jakt-spørringen i Verifying Ingestion parses. En tom celle betyr at attributten ikke er eksponert i CloudAppEvents dag. Du bør fortsatt sende den ut (i henhold til kolonnen Påkrevd) fordi Agent 365 bruker den til inntasting, foreldreoppløsning og Microsoft Defender sine agentaktivitetsvisninger. Men du kan ikke spørre direkte fra Microsoft Defender avansert jakt i dag.
Note
Agent 365 fyller automatisk ut de statiske postfeltene (Id, RecordType, , Workload, UserType) Versionog de genererte forespørsels- og svar-ID-ene.
| Attribute | Applies to | Required | RawEventData field | Notater / innvirkning hvis det mangler |
|---|---|---|---|---|
gen_ai.operation.name |
All | M | Operation |
En av invoke_agent, execute_tool, chat, . output_messages Span falt hvis den var savnet eller ikke ble gjenkjent. |
microsoft.tenant.id |
All | M | OrganizationId |
URL {tenantId} er autoritativ. Hvis du setter denne verdien og den er uenig, blir forespørselen avvist (403). |
gen_ai.agent.id |
All | M |
TargetAgentId (IA); AgentId (ET, CH) |
Appens appID for anropsappen. Må matche URL {agentId} og den autentiserte appen. Mismatch gir 403. |
gen_ai.agent.name |
All | M |
TargetAgentName (IA); AgentName (ET, CH) |
Defender og administrasjonssenteret viser rå GUID i stedet for et navn hvis det mangler. |
microsoft.a365.agent.blueprint.id |
All | M |
TargetAgentBlueprintID (IA); AgentBlueprintId (ET, CH) |
Tegningen er relevant. For standard Entra-apper uten blueprint, gjenbruk agentens appId. Blueprint-rullene i administrasjonssenteret går ellers i stykker. |
gen_ai.agent.description |
All | O | -- | Detaljvisningen i administrasjonssenteret er tom for agenten. |
gen_ai.agent.type |
All | O |
PlatformTargetAgentType (IA); PlatformAgentType (ET); CopilotEventData.PlatformAgentType (CH) |
En etikett for identitetssystemet ditt, kombinert med microsoft.a365.agent.platform.id når agenten ikke har en entra-registrering. Fri tekst; Velg en verdi som unikt identifiserer ditt identitetssystem. Utelate når agenten har entra-registrering. Agent 365 klassifiserer automatisk. Ikke bruk de Microsoft-reserverte verdiene (se Picking values). |
microsoft.a365.agent.platform.id |
All | O |
PlatformTargetAgentId (IA, også toppnivå AlternateId); PlatformAgentId (ET, CH) |
Agentens unike ID i ditt ikke-entra-identitetssystem. Free-form text. Sett sammen med gen_ai.agent.type. Utelate når agenten har entra-registrering. Se Plukkeverdier. |
gen_ai.conversation.id |
All | M |
ConversationId (IA, ET); CopilotEventData.ConversationId / CopilotEventData.ThreadId (CH) |
Primær-join-nøkkelen for en gjennomspilling. Uten den vises ikke kjøringen i Defender-agentaktivitetsvisningene eller administrasjonssenteret. |
microsoft.channel.name |
All | M |
ChannelName (IA, ET) |
Overflaten agenten befinner seg i. Bruk en kort liten token. De kanoniske verdiene som brukes av Defender og administrasjonssenterfiltre i dag er msteams og outlook. Egendefinerte strenger (for eksempel web, <your-product-name>) aksepteres, men pivoterer ikke i innebygde kanalfiltre. Bruk samme verdi på hvert spenn. Se Plukkeverdier. |
microsoft.channel.link |
All | O | -- | Channel deep-link. |
microsoft.session.id |
All | O | SessionIdentity |
Sesjonspivotene er tomme hvis de mangler. |
microsoft.session.description |
All | O | -- | Session description. |
microsoft.conversation.item.link |
All | O | -- | Dyp lenke til meldingen. |
correlation.id |
All | O | -- | Cross-service tracing. Ikke dukket opp i avansert jakt i dag. |
operation.source |
All | O |
InvokeSource (IA) |
Identifikator for SDK-en eller tjenesten som sender ut telemetrien. Det kan være et ressursattributt. |
client.address |
IA, ET, CH | M |
ClientIP (IA, ET) |
Caller IP. IP-basert etterforskning blokkert hvis den er tom. |
server.address |
IA, ET, CH | M |
ServerAddress (IA, ET) |
Endepunkt, tjenesten din ringer. |
server.port |
IA, ET, CH | M |
ServerPort (IA) |
Strengkodet (for eksempel "443"). |
user.id |
IA | M | UserKey |
Microsoft Entra objekt-ID til den menneskelige innringeren. "Hvem drev denne agenten" er blankt uten det. |
user.email |
IA | O | UserId |
UPN på innringeren. |
user.name |
IA | O | -- | Vises navn på innringeren. |
gen_ai.input.messages |
IA, CH | M | -- | Forespørsel om nyttelast (JSON-streng). Fanget for analyse nedstrøms, men ennå ikke dukket opp i avansert jakt. |
gen_ai.output.messages |
IA, CH, OM | M | -- | Responspayload (JSON-streng). |
gen_ai.execution.type |
IA | O | -- | En av HumanToAgent, Agent2Agent, EventToAgent. |
microsoft.a365.agent.thought.process |
IA, CH | O | -- | Fri tekst-resonnement eller tankerekke. |
gen_ai.author.app.id |
OM | O | -- | Microsoft Entra-app-ID for applikasjonen som har laget eller laget agenten. |
gen_ai.tool.name |
ET | M | ToolName |
Tool name. Defender-verktøyvisningene er tomme hvis de mangler. |
gen_ai.tool.type |
ET | M | ToolType |
En av function, Power Platform Connector, MCP Server, , API, Knowledge Source, bing_grounding, code_interpreter, . file_search |
gen_ai.tool.call.id |
ET | M | ToolId |
Identifikator for dette verktøykallet. |
gen_ai.tool.call.arguments |
ET | M | -- | Verktøyargumenter (JSON-streng). Fanget, men ennå ikke dukket opp i avansert jakt. |
gen_ai.tool.call.result |
ET | M | -- | Verktøyresultat (JSON-streng). |
gen_ai.tool.description |
ET | O | ToolDescription |
Tool description. |
gen_ai.tool.server.name |
ET | O | -- | Verktøyserverens vertsnavn. Sett denne attributten for MCP-verktøy. |
gen_ai.request.model |
CH | M | -- | Modellnavn (for eksempel, gpt-4o). Fanget, men ennå ikke dukket opp i avansert jakt. |
gen_ai.provider.name |
CH | M | -- | Leverandørnavn (for eksempel, openai). |
gen_ai.usage.input_tokens |
CH | O | -- | Antall inndatatoken, strengkodet. |
gen_ai.usage.output_tokens |
CH | O | -- | Utdata-tokenantall, strengkodet. |
gen_ai.response.finish_reasons |
CH | O | -- | Finish reasons. |
microsoft.a365.caller.agent.id |
IA | M*2 |
AgentId (IA) |
Ringer agent AppId. Påkrevd for agent-til-agent. |
microsoft.a365.caller.agent.name |
IA | M*2 |
AgentName (IA) |
Kaller agentens visningsnavn. |
microsoft.a365.caller.agent.blueprint.id |
IA | M*2 | AgentBlueprintId |
Kaller agentens blueprint-appId. Påkrevd for embodied A2A. |
microsoft.a365.caller.agent.user.id |
IA | M*2 | -- | Bruker bruker-ID til den oppringende agenten. |
microsoft.a365.caller.agent.user.email |
IA | M*2 | -- | Ringer agent UPN. |
microsoft.a365.caller.agent.platform.id |
IA | N/A | -- | Reservert for alternative ID-er uten entra. |
gen_ai.caller.agent.type |
IA | N/A | -- | Agent 365 klassifiserer automatisk. |
microsoft.agent.user.id |
IA, ET, CH | M*1 |
TargetAgentUserKey (IA); UserKey (ET, CH) |
Microsoft Entra-objekt-ID for agentens egen brukerkonto. Påkrevd for AI-lagkamerater og legemliggjorte agenter. |
microsoft.agent.user.email |
IA, ET, CH | O*1 |
UserId (ET, CH) |
UPN til agentens brukerkonto. |
span.SpanId |
All | M | OpId |
OTel SDK sender ut dette. |
span.ParentSpanId |
All | M*3 | ParentId |
Påkrevd kun for ikke-rotspenn; roten invoke_agent har ingen. |
span.StartTimeUnixNano |
All | M | toppnivå TimeGenerated (også CreationTime i RawEventData) |
Unix-epokenanoer som en streng. |
span.EndTimeUnixNano |
All | M |
CompletionTime (IA, ET); CopilotEventData.CompletionTime (CH) |
Varigheten kan ikke beregnes hvis den mangler. |
span.Status.Message |
All | O*4 |
ErrorMessage (IA, ET); CopilotEventData.ErrorMessage (CH) |
Årsaken til mislykkede kjøringer er tom hvis den mangler. |
span.Status.Code |
All | O*4 |
ErrorType (IA); CopilotEventData.ErrorType (CH) |
Feilkategori er blank hvis den mangler. |
Note
Agent 365 aksepterer flere attributter du sender ut, som verktøyargumenter og resultater, modellparametere og kanal-dyplenker. Nedstrøms Microsoft Defender-visninger bruker disse attributtene, men Agent 365 eksponerer dem ennå ikke som en CloudAppEvents.RawEventData JSON-nøkkel. Sett dem etter kolonnen Påkrevd. De kan bli lagt til jaktlasten i en fremtidig utgivelse.
Important
På invoke_agent (IA)-poster beskriver , AgentName, og AgentBlueprintId feltene AgentIdden kallende agenten, ikke den påkalte agenten. Agent 365 fyller dem ut fra attributtene microsoft.a365.caller.agent.* . Når et menneske kaller agenten din, utelat disse attributtene, så AgentId og AgentBlueprintId vises som en GUID med nuller (00000000-0000-0000-0000-000000000000) og AgentName er tom i revisjonsposter og Microsoft Purview. All-zeros-verdien forventes for menneskeinitierte kjøringer. For å identifisere den påkalte agenten, bruk TargetAgentId, TargetAgentName, og TargetAgentBlueprintID.
Å velge verdier når du ikke har en naturlig
Noen nødvendige attributter beskriver konsepter som kanskje ikke finnes i agentens arkitektur. Hvis den naturlige verdien ikke er tilgjengelig, sett følgende verdier i stedet.
Ikke la et obligatorisk felt stå tomt. Selv en GUID med alle nuller skjuler runen din fra noen kundeorienterte opplevelser. Denne regelen gjelder kun for obligatoriske attributter. Det gjelder ikke for caller-agent-attributtene på menneskeinitierte kjøringer, hvor det forventes nuller AgentId på invoke_agent poster.
| Spørsmål / scenario | Field(s) | Hva skal settes |
|---|---|---|
| Min agent er en standard Entra-appregistrering (ikke bygget på en Entra Agent ID blueprint). | gen_ai.agent.id |
Entra-appens appId. |
| ↑ Samme scenario | microsoft.a365.agent.blueprint.id |
Gjenbruk samme verdi som gen_ai.agent.id (agentens appId). Skjemaet krever en ikke-tom verdi; Å gjenbruke agent appId er den sikre standarden når det ikke finnes noen blueprint. |
| Agenten min er bygget fra en Entra Agent ID blueprint – én eller flere agentidentiteter laget fra samme blueprint. | gen_ai.agent.id |
Agentidentitetens appID ( instansens appID, ikke blueprintens). |
| ↑ Samme scenario | microsoft.a365.agent.blueprint.id |
Tegningen er relevant. Alle instanser preget fra samme blåkopi deler denne verdien. |
| Innringeren er en menneskelig bruker, ikke en annen agent. | Alle microsoft.a365.caller.agent.* og gen_ai.caller.agent.* attributter |
Omit. De er kun obligatoriske i agent-til-agent-situasjoner. På invoke_agent registrene viser innringeren en AgentIdAgentBlueprintId GUID med alle nuller. Bruk TargetAgentId det til å identifisere agenten din. |
| I agent-til-agent: den kallende agenten er en standard Entra-app (uten blåkopi). | microsoft.a365.caller.agent.blueprint.id |
Gjenbruk appID-agentens appID. |
| Min agent er ikke en AI-lagkamerat – den har ikke sin egen brukerkonto i leietakeren. | Alle microsoft.agent.user.* egenskaper |
Omit. De er bare obligatoriske når agenten har sin egen Entra Agent ID-brukerkonto. |
| Agenten min har ingen forståelse av en økt utover en enkelt runde. | microsoft.session.id |
Valgfritt – utelat. Hvis du vil at hver gjennomspilling skal være sin egen økt, sett til en GUID per gjennomspilling. |
| Agenten min har ingen forståelse av en samtale (one-shot, stateless). | gen_ai.conversation.id |
Generer en ny GUID per gjennomspilling. Feltet er obligatorisk; å hoppe over den fjerner kjøringen fra Defender-agentaktivitetsvisningene og Administrasjonssenter for Microsoft 365. |
| Innringeren har ingen IP (for eksempel en autonom planlagt trigger). | client.address |
Bruk en stabil plassholder du kontrollerer (for eksempel, "0.0.0.0"). Feltet er obligatorisk; en tom verdi fjerner kjøringen fra IP-baserte undersøkelsespivoter. |
| Agenten kjører under behandling; Det er ingen separat "server" som kalles opp. | server.address / server.port |
Bruk vertsnavnet til maskinen som kjørte agenten (for eksempel myagent.example.com) og porten endepunktet ditt lytter på. Påkrevd selv når det ikke finnes en separat nedstrøms tjeneste. |
Min chat Span har ingen bruk av modelltoken. |
gen_ai.usage.input_tokens / gen_ai.usage.output_tokens |
Valgfritt – utelat. Hvis du har omtrentlige antall, send dem som stringValue. |
| Spanen min har ingen feil å rapportere. |
span.Status.Message, span.Status.Code |
Sett OTel-statusen til OK (numerisk kode 1) og utelat meldingen. Pipelinen konsulterer bare disse feltene når status er Error. |
| Agenten min bruker et ikke-entra-identitetssystem (agenten har ingen entra-registrering). |
microsoft.a365.agent.platform.id Og gen_ai.agent.type |
Sett begge, på hvert spenn.
platform.id er agentens unike ID i ditt identitetssystem; agent.type er en kort etikett som identifiserer hvilket identitetssystem det er. Begge er fri tekst – velg det som passer for systemet ditt.
Ikke bruk de Microsoft-reserverte typeverdiene: CustomBuiltAgentsUsingSDK, CopilotStudio, Foundry, DeclarativeAgent, Custom (disse verdiene er reservert for interne Microsoft-flater). Anropsappen du autentiserer deg som trenger fortsatt en entra-registrering for å bruke disse rutene – det alternative id-paret beskriver en målrettet agent, ikke innringeren. |
Hvilken verdi bør jeg legge i microsoft.channel.namedet? |
microsoft.channel.name |
Overflaten agenten befinner seg i. Defender- og administrasjonscenterfiltre baserer seg på den bokstavelige strengen, så bruk en kort, stabil, liten token. I dag er msteams de kanoniske verdiene og outlook; vanlige kundevendte flater bruker webogså , office, sharepoint, eller <your-product-name>. Velg én verdi og hold deg til den – verktøyene kan ikke forene msteams og Microsoft Teams som samme kanal. |
Bør jeg sette gen_ai.agent.type? |
gen_ai.agent.type |
Bare hvis du også setter microsoft.a365.agent.platform.id (for eksempel hvis agenten din ikke har entra-registrering). Paret forteller Agent 365 hvilket identitetssystem agenten kommer fra. Velg en kort etikett som unikt identifiserer identitetssystemet ditt .
Ikke bruk CustomBuiltAgentsUsingSDK, CopilotStudio, Foundry, DeclarativeAgent eller Custom – disse verdiene er reservert for intern Microsoft bruk. For Entra-registrerte agenter, utelat feltet; Agent 365 fyller den igjen. |
Hvilken OTLP kind bør jeg sette på spanene mine? |
span.kind |
Bruk heltalls enum-verdi, ikke proto-enum-strengen - 1 (INTERNAL), (), 2 (SERVER), 3 (CLIENT), (), 4 (PRODUCER), (), 5 (CONSUMER). Agent 365 aksepterer noen av disse og utleder ikke kundesynlig atferd fra kind, så 1 (INTERNAL) er en trygg standard for alle span. Hvis du vil at typen skal reflektere kalleformen, INTERNAL er forinvoke_agent / output_messagesog CLIENT for chat / execute_tool rimelig. |