Observabilitet for Fabric-dataagenter i Microsoft Foundry

Du kan legge til en Fabric-dataagent som et verktøy til en agent du bygger i Microsoft Foundry. Etter at du har koblet den, ringer Foundry-agenten Fabric-dataagenten for å svare på spørsmål som er forankret i bedriftsdataene dine som ligger i Fabric OneLake.

Denne artikkelen handler om observabilitet for dette oppsettet. Når du bygger en agent i Foundry og kobler en Fabric-dataagent til den, vil du se hva dataagenten gjorde på hver forespørsel, ikke bare det endelige svaret. Foundry Observability gir deg den synligheten. Dataagentens logger og spor sendes til samme sted som Foundry-agenten allerede rapporterer til, slik at du kan følge en forespørsel fra Foundry-agenten, inn i Fabric-dataagenten, og ned til datakildene den spurte om.

Resten av denne artikkelen forklarer hvor telemetrien lagres, hvordan den kommer dit, hvordan man leser den, hvem som kan se den, og hvordan man kontrollerer den.

For en generell oversikt, se Observability in generative AI . For å koble en Fabric-dataagent til Foundry, se Consume a data agent i Microsoft Foundry.

Støperiprosjekter og applikasjonsinnsikt

Et Foundry-prosjekt er der du bygger og driver agentene dine. Foundry lagrer agentspor i en Azure Monitor Application Insights-ressurs, og hvert prosjekt kobles til én slik ressurs.

Som agentbygger, sett dette opp én gang. I Foundry-prosjektet ditt, åpne Agents-seksjonen, velg Traces, og velg Connect. Du kan opprette en ny Application Insights-ressurs eller koble til en som allerede eksisterer. Etter at du har koblet ressursen, aktiverer Foundry automatisk serversidesporing for prosjektet. Du trenger ikke å gjøre noen kodeendringer, og sporene begynner å flyte i løpet av minutter.

Forholdet er enkelt: prosjektet peker på én Application Insights-ressurs, og hver agent i det prosjektet sender sine spor dit. Prosjektet definerer hvor telemetri samles inn; Application Insights er der den ligger og hvor du kan spørre den.

Du kan se spor i fanen Traces hos Foundry-agenten din, eller spørre dem direkte i den tilknyttede Application Insights-ressursen. Foundry-portalen viser spor fra de siste 90 dagene.

For trinnvis oppsett, se Sett opp sporing for AI-agenter i Microsoft Foundry.

Hvordan Fabric-dataagentlogger og spor når prosjektet ditt

For å koble en Fabric-dataagent til Foundry, arbeid i et Foundry-prosjekt. Hvis du kobler en Application Insights-ressurs til det prosjektet, sender Fabric-dataagenten sine logger og spor til den samme ressursen. Foundry-agentens telemetri og Fabric-dataagentens telemetri lander på ett sted, så dere kan lese dem sammen.

Flyten fungerer slik:

1. I Foundry-prosjektet ditt, koble til en Application Insights-ressurs, som beskrevet i forrige avsnitt.
2. Legg til en Fabric-dataagent som verktøy til en Foundry-agent i det prosjektet.
3. Når Foundry-agenten kjører, kaller den Fabric-dataagenten for å få innsikt fra bedriftsdataene i Fabric OneLake.
4. Fabric validerer Application Insights-ressursen som er koblet til prosjektet, og sender deretter dataagentens logger og spor til den.
5. Dataagentens telemetri vises sammen med Foundry-agentens spor, både i den tilkoblede Application Insights-ressursen og i agentens Traces-visning .

Resultatet er at arbeidet Fabric-dataagenten gjør blir en del av sporingen for forespørselen. Du ser at Foundry-agenten din ringte dataagenten, og du ser hva dataagenten gjorde for å gi svaret, inkludert hvilke datakilder den spurte, hvor lang tid hvert steg tok, og om hvert steg lyktes.

Les sporene

Foundry Observability registrerer hver forespørsel som et spor. Et spor består av spenn, og hvert spor representerer én arbeidsenhet med sin egen starttid, varighet og status. Spenn er nestet, så å lese en sporing fra topp til bunn viser hvilken vei en forespørsel tok og hvor tiden ble brukt.

En Fabric-dataagent legger til to typer spenn til sporet:

• Agent span: den totale kjøringen av Fabric-dataagenten for en enkelt forespørsel.
• Verktøyspennvidde: en enkelt datakilde eller verktøy dataagenten kaller mens forespørselen besvares. Én forespørsel kan produsere mer enn ett verktøyspenn.

Følgende eksempel viser en Foundry-agent som kaller en Fabric-dataagent, som spør to datakilder for å svare på spørsmå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

Tabellen nedenfor beskriver hvert nivå av sporet og typen metadata som er knyttet til det.

Med denne strukturen kan du svare på de spørsmålene som betyr noe når noe ser feil ut:

• Når en respons er treg, viser varigheten på hver spenn hvilket steg som tok lengst tid.
• Når et svar er feil, viser verktøyet hvilke datakilder som ble spurt og i hvilken rekkefølge.
• Når en forespørsel feiler, viser statusen på hver spenn hvor feilen oppsto.

Hvem kan se loggene og sporene

Application Insights-ressursen som lagrer dataagentens logger og spor styrer tilgangen. Alle med lesetilgang til den ressursen kan se telemetrien. Å koble en ressurs til et prosjekt gir ikke tilgang til dataene det inneholder.

Tilgang til et Foundry-prosjekt alene inkluderer ikke tilgang til telemetrien. Lesetillatelse på Application Insights-ressursen kreves alltid.

Operasjonell metadata-leietakerinnstilling

En leietakerinnstilling i Fabric-administrasjonsportalen styrer om Fabric-dataagenter sender operasjonell metadata for observabilitet i Foundry. Innstillingen er på som standard.

Innstillingen sender kun operasjonell metadata. Denne metadataen inkluderer agentvisningsnavn, datakildenavn, resonnementsteg-IDer og samtale-IDer. Fabric sender ikke noe kundeinnhold. Brukerprompts og svarene fra dataagenten forblir innenfor Fabric sine compliance-grenser og er ikke inkludert i denne telemetrien.

Settingen lyder som følger.

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

Agentskapere kan bruke operasjonell metadata for å overvåke agentens helse, oppdage problemer og forstå hvordan deres publiserte agenter brukes på tvers av applikasjoner og tjenester. Disse innsiktene hjelper agentskapere med å forbedre agentens pålitelighet og ytelse.

Når du slår på denne innstillingen, sender Fabric-dataagenter operasjonell metadata til en konfigurert Application Insights-ressurs for behandling og lagring. Disse dataene inkluderer agentens visningsnavn, datakildenavn, resonnementsteg-ID-er og samtale-IDer. Application Insights-ressursen som behandler og lagrer disse dataene kan være plassert utenfor leietakerens geografiske område, samsvarsgrense eller nasjonal skyinstans.

For å få tilgang til den operative metadataen trenger du en rolle med lesetillatelser (som Monitoring Reader eller Log Analytics Reader) på den konfigurerte Application Insights-ressursen. Brukere med denne tilgangen kan se dataene i Application Insights. Brukere kan også se dataene gjennom et Foundry-prosjekt som kobles til den konfigurerte Application Insights-ressursen. Tilgang gjennom Foundry krever rollebasert tilgang til Foundry-prosjektet (Foundry User eller høyere) i tillegg til lesetillatelser på Application Insights-ressursen. Tilgang til et Foundry-prosjekt alene inkluderer ikke tilgang til telemetridataene.

Relatert innhold

• Bruk en dataagent i Microsoft Foundry
• Sett opp sporing for AI-agenter i Microsoft Foundry
• Observerbarhet i generativ KUNSTIG INTELLIGENS
• Konfigurer Fabric data agent-leietakerinnstillinger