Observabilitet for Fabric-dataagenter i Microsoft Foundry

Du kan tilføje en Fabric dataagent som et værktøj til en agent, du bygger i Microsoft Foundry. Efter du har forbundet den, ringer Foundry-agenten til Fabric-dataagenten for at besvare spørgsmål, der er forankret i dine virksomhedsdata, som ligger i Fabric OneLake.

Denne artikel handler om observabilitet for den opsætning. Når du bygger en agent i Foundry og forbinder en Fabric-dataagent til den, vil du se, hvad dataagenten gjorde på hver anmodning, ikke kun det endelige svar. Foundry Observability giver dig den synlighed. Dataagentens logfiler og spor sendes til det samme sted, som din Foundry-agent allerede rapporterer til, så du kan følge en anmodning fra Foundry-agenten, ind i Fabric-dataagenten og ned til de datakilder, den har forespurgt.

Resten af denne artikel forklarer, hvor telemetrien er gemt, hvordan den kommer dertil, hvordan man læser den, hvem der kan se den, og hvordan man kontrollerer den.

For et generelt overblik, se Observerbarhed i generativ AI . For at forbinde en Fabric-dataagent til Foundry, se Consume en dataagent i Microsoft Foundry.

Foundry-projekter og applikationsindsigter

Et foundry-projekt er, hvor du bygger og driver dine agenter. Foundry gemmer agentspor i en Azure Monitor Application Insights-ressource, og hvert projekt forbinder til én sådan ressource.

Som agentbygger, sæt dette op én gang. I dit Foundry-projekt åbner du Agents-sektionen , vælger Traces, og vælger Connect. Du kan oprette en ny Application Insights-ressource eller forbinde en, der allerede eksisterer. Efter du har forbundet ressourcen, aktiverer Foundry automatisk server-side sporing for projektet. Du behøver ikke lave nogen kodeændringer, og spor begynder at flyde inden for få minutter.

Forholdet er ligetil: projektet peger på én Application Insights-ressource, og hver agent i det projekt sender sine spor dertil. Projektet definerer, hvor telemetri indsamles; Application Insights er stedet, hvor det findes, og hvor du forespørger det.

Du kan se spor i fanen Traces hos din Foundry-agent eller forespørge dem direkte i den tilknyttede Application Insights-ressource. Foundry-portalen viser spor fra de sidste 90 dage.

For trin-for-trin opsætning, se Opsætning af sporing for AI-agenter i Microsoft Foundry.

Hvordan Fabric-dataagentlogs og -traces når dit projekt

For at forbinde en Fabric-dataagent til Foundry, arbejd i et Foundry-projekt. Hvis du forbinder en Application Insights-ressource til det projekt, sender Fabric-dataagenten sine logfiler og traces til den samme ressource. Din Foundry-agents telemetri og Fabric-dataagentens telemetri lander ét sted, så I kan læse dem sammen.

Flowet fungerer sådan her:

1. I dit Foundry-projekt skal du forbinde en Application Insights-ressource, som beskrevet i det forrige afsnit.
2. Tilføj en Fabric-dataagent som værktøj til en Foundry-agent i det projekt.
3. Når Foundry-agenten kører, kalder den Fabric-dataagenten for at få indsigt fra virksomhedens data i Fabric OneLake.
4. Fabric validerer Application Insights-ressourcen, der er forbundet til projektet, og sender derefter dataagentens logfiler og spor til den.
5. Dataagentens telemetri vises sammen med din Foundry-agents spor, både i den tilknyttede Application Insights-ressource og i agentens Traces-visning .

Resultatet er, at det arbejde, Fabric-dataagenten udfører, bliver en del af sporingen for anmodningen. Du ser, at din Foundry-agent ringede til dataagenten, og du ser, hvad dataagenten gjorde for at få sit svar, inklusive hvilke datakilder den spurgte, hvor lang tid hvert trin tog, og om hvert trin lykkedes.

Læs sporene

Foundry Observability registrerer hver anmodning som et spor. Et spor består af spænd, og hvert spænd repræsenterer én enhed arbejde med sin egen starttid, varighed og status. Spænd er indlejrede, så at læse en sporing fra top til bund viser, hvilken vej en anmodning tog, og hvor tiden blev tilbragt.

En Fabric-dataagent tilføjer to slags spænd til sporet:

• Agent span: den samlede kørsel af Fabric-dataagenten for en enkelt anmodning.
• Værktøjsspændvidde: en enkelt datakilde eller et værktøj, som dataagenten kalder på, mens den besvarer anmodningen. Én anmodning kan producere mere end ét værktøjsspænd.

Følgende eksempel viser en Foundry-agent, der kalder en Fabric-dataagent, som forespørger to datakilder for at besvare spørgsmålet:

Request (trace)
└─ Foundry agent run
   └─ Fabric data agent (called as a tool)
      └─ Agent span            Overall run of the Fabric data agent
         ├─ Tool span          First data source the data agent queried
         └─ Tool span          Second data source the data agent queried

Følgende tabel beskriver hvert niveau af sporet og den type metadata, der er knyttet til det.

Med denne struktur kan du besvare de spørgsmål, der betyder noget, når noget ser forkert ud:

• Når et svar er langsomt, viser varigheden på hver spændvidde, hvilket trin der tog længst tid.
• Når et svar er forkert, viser værktøjsspænderne, hvilke datakilder der blev forespurgt, og i hvilken rækkefølge.
• Når en anmodning fejler, viser status på hver span, hvor fejlen opstod.

Hvem kan se logbøgerne og sporene

Application Insights-ressourcen, der gemmer dataagentens logfiler og spor, styrer adgangen. Alle med læseadgang til den ressource kan se telemetrien. At forbinde en ressource til et projekt giver ikke adgang til de data, det indeholder.

Adgang til et Foundry-projekt alene inkluderer ikke adgang til telemetrien. Læsetilladelse på Application Insights-ressourcen er altid påkrævet.

Operationel metadata-lejerindstilling

En lejerindstilling i Fabric-administrationsportalen styrer, om Fabric-dataagenter sender operationelle metadata for observabilitet i Foundry. Indstillingen er slået til som standard.

Indstillingen sender kun operationel metadata. Disse metadata inkluderer agentvisningsnavne, datakildenavne, ræsonnementsteg-ID'er og samtale-ID'er. Fabric sender ikke noget kundeindhold. Brugerprompts og dataagentens svar forbliver inden for Fabric's compliance-grænser og er ikke inkluderet i denne telemetri.

Settingen lyder som følger.

Fabric-dataagenter kan sende operationel metadata for observabilitet i Microsoft Foundry

Agentskabere kan bruge operationel metadata til at overvåge agentens sundhed, opdage problemer og forstå, hvordan deres offentliggjorte agenter bruges på tværs af applikationer og tjenester. Disse indsigter hjælper agentskabere med at forbedre agentens pålidelighed og ydeevne.

Når du slår denne indstilling til, sender Fabric-dataagenter operationel metadata til en konfigureret Application Insights-ressource til behandling og lagring. Disse data inkluderer agentens displaynavne, datakildenavne, ræsonnementstrin-ID'er og samtale-ID'er. Application Insights-ressourcen, der behandler og gemmer disse data, kan være placeret uden for din lejers geografiske område, overholdelsesgrænse eller nationale cloud-instans.

For at få adgang til de operationelle metadata skal du have en rolle med læsetilladelser (såsom Monitoring Reader eller Log Analytics Reader) på den konfigurerede Application Insights-ressource. Brugere med denne adgang kan se dataene i Application Insights. Brugere kan også se dataene gennem et Foundry-projekt, der forbinder til den konfigurerede Application Insights-ressource. Adgang gennem Foundry kræver rollebaseret adgang til Foundry-projektet (Foundry User eller højere) ud over læsetilladelser på Application Insights-ressourcen. Adgang til et Foundry-projekt alene inkluderer ikke adgang til telemetridataene.

Relateret indhold

• Forbrug en dataagent i Microsoft Foundry
• Opsætning af sporing for AI-agenter i Microsoft Foundry
• Observability i generativ AI
• Konfigurér Fabric data agent lejerindstillinger