Observabiliteit voor Fabric-dataagenten in Microsoft Foundry

Je kunt een Fabric data agent als tool toevoegen aan een agent die je in Microsoft Foundry bouwt. Nadat je het hebt gekoppeld, belt de Foundry-agent de Fabric-dataagent om vragen te beantwoorden die gebaseerd zijn op je enterprise-data die in Fabric OneLake staat.

Dit artikel gaat over observabiliteit voor die opstelling. Wanneer je een agent in Foundry bouwt en een Fabric dataagent eraan koppelt, wil je zien wat de dataagent bij elk verzoek heeft gedaan, niet alleen het uiteindelijke antwoord. Foundry Observability geeft je die zichtbaarheid. De logs en traces van de dataagent worden naar dezelfde plek gestuurd waar je Foundry-agent al rapporteert, zodat je een verzoek van begin tot eind kunt volgen, van de Foundry-agent, naar de Fabric-dataagent, en vervolgens naar de databronnen die hij heeft bevraagd.

De rest van dit artikel legt uit waar die telemetrie is opgeslagen, hoe het daar terechtkomt, hoe je het leest, wie het kan zien en hoe je het kunt besturen.

Voor een algemeen overzicht, zie Observability in generatieve AI . Om een Fabric-dataagent aan Foundry te koppelen, zie Consume a data agent in Microsoft Foundry.

Foundry-projecten en Application Insights

Een Foundry-project is waar je je agenten bouwt en runt. Foundry slaat agenttraces op in een Azure Monitor Application Insights-resource, en elk project maakt verbinding met zo'n resource.

Als makelaar bouw je dit één keer op. Open in je Foundry-project het Agents-gedeelte , selecteer Traces en selecteer Connect. Je kunt een nieuwe Application Insights-bron aanmaken of er een verbinden die al bestaat. Nadat je de bron hebt gekoppeld, schakelt Foundry automatisch server-side tracering voor het project in. Je hoeft geen codewijzigingen aan te brengen, en binnen enkele minuten beginnen de traces te stromen.

De relatie is eenvoudig: het project wijst naar één Application Insights-bron, en elke agent in dat project stuurt zijn traces daarheen. Het project bepaalt waar telemetrie wordt verzameld; Application Insights is waar het zich bevindt en waar je het bevraagt.

Je kunt traces bekijken in het tabblad Traces van je Foundry-agent, of ze direct opvragen in de verbonden Application Insights-bron. Het Foundry-portaal toont sporen van de afgelopen 90 dagen.

Voor stapsgewijze opzet, zie Stel tracing op voor AI-agenten in Microsoft Foundry.

Hoe logboeken en traceringen van de Fabric-data-agent uw project bereiken

Om een Fabric-dataagent aan Foundry te koppelen, werk je in een Foundry-project. Als je een Application Insights-bron aan dat project koppelt, stuurt de Fabric-dataagent zijn logs en traces naar diezelfde bron. De telemetrie van je Foundry-agent en die van de Fabric-dataagent landen op één plek, zodat je ze samen kunt lezen.

De flow werkt als volgt:

1. Verbind in je Foundry-project een Application Insights-bron, zoals beschreven in de vorige sectie.
2. Voeg een Fabric data agent toe als tool aan een Foundry-agent in dat project.
3. Wanneer de Foundry-agent draait, roept hij de Fabric-dataagent aan om inzichten te verkrijgen uit de enterprise-data in Fabric OneLake.
4. Fabric valideert de Application Insights-resource die aan het project is gekoppeld en stuurt vervolgens de logs en traces van de dataagent ernaartoe.
5. De telemetrie van de dataagent verschijnt naast de traces van je Foundry-agent, zowel in de verbonden Application Insights-bron als in de Traces-weergave van de agent.

Het resultaat is dat het werk dat de Fabric-dataagent verricht deel wordt van de trace voor het verzoek. Je ziet dat je Foundry-agent de dataagent heeft gebeld, en je ziet wat de dataagent heeft gedaan om zijn antwoord te geven, inclusief welke databronnen hij heeft geraadpleegd, hoe lang elke stap duurde en of elke stap geslaagd is.

Lees de sporen

Foundry Observability registreert elk verzoek als een trace. Een trace bestaat uit overspanningen, en elke overspanning vertegenwoordigt één eenheid werk met een eigen starttijd, duur en status. Spans zijn genest, dus als je een trace van boven naar beneden leest, zie je welk pad een verzoek heeft afgelegd en waar de tijd is besteed.

Een Fabric-gegevensagent voegt twee soorten spans toe aan de trace:

• Agent span: de totale run van de Fabric data-agent voor één enkel verzoek.
• Gereedschapsspan: één enkele databron of tool die de dataagent oproept tijdens het beantwoorden van het verzoek. Eén verzoek kan meer dan één gereedschapsreeks opleveren.

Het volgende voorbeeld toont een Foundry-agent die een Fabric-dataagent oproept, die twee databronnen raadpleegt om de vraag te beantwoorden:

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

De volgende tabel beschrijft elk niveau van de trace en het soort metadata dat eraan gekoppeld is.

Met deze structuur kun je de vragen beantwoorden die ertoe doen wanneer iets niet klopt:

• Wanneer een reactie traag is, laat de duur van elke span zien welke stap het meeste tijd duurde.
• Wanneer een antwoord onjuist is, laten de markeringen in de tool zien welke databronnen zijn geraadpleegd en in welke volgorde.
• Wanneer een verzoek faalt, geeft de status op elke overspanning aan waar de storing heeft plaatsgevonden.

Wie kan de logboeken en sporen zien

De Application Insights-bron die de logs en traces van de dataagent opslaat, regelt de toegang. Iedereen met leestoegang tot die bron kan de telemetrie zien. Het koppelen van een bron aan een project geeft geen toegang tot de data die het bevat.

Toegang tot een Foundry-project op zichzelf omvat geen toegang tot de telemetrie. Leestoestemming op de Application Insights-bron is altijd vereist.

Tenantinstelling voor bewerkingsmetadata

Een tenant-instelling in het Fabric-beheerportaal bepaalt of Fabric-dataagenten operationele metadata verzenden voor observabiliteit in Foundry. De instelling is standaard ingeschakeld.

De instelling stuurt alleen operationele metadata. Deze metadata omvat agentendisplaynamen, databronnamen, redeneringsstap-ID's en gespreks-ID's. Fabric stuurt geen klantcontent. Gebruikersprompts en reacties van dataagenten blijven binnen de compliance-grens van Fabric en worden niet opgenomen in deze telemetrie.

De setting luidt als volgt.

Fabric data-agenten kunnen operationele metadata verzenden voor observabiliteit in Microsoft Foundry

Agentmakers kunnen operationele metadata gebruiken om de gezondheid van agenten te monitoren, problemen te detecteren en te begrijpen hoe hun gepubliceerde agenten worden gebruikt in applicaties en diensten. Deze inzichten helpen agentmakers om de betrouwbaarheid en prestaties van agenten te verbeteren.

Wanneer je deze instelling inschakelt, sturen Fabric-dataagenten operationele metadata naar een geconfigureerde Application Insights-bron voor verwerking en opslag. Deze gegevens omvatten agentenweergavenamen, gegevensbronnamen, redeneerstap-ID's en gespreks-ID's. De Application Insights-bron die deze gegevens verwerkt en opslaat, kan zich buiten de geografische regio, compliancegrens of nationale cloudinstantie van uw tenant bevinden.

Om toegang te krijgen tot de operationele metadata, heb je een rol nodig met leesrechten (zoals Monitoring Reader of Log Analytics Reader) op de geconfigureerde Application Insights-bron. Gebruikers met deze toegang kunnen de gegevens bekijken in Application Insights. Gebruikers kunnen de data ook bekijken via een Foundry-project dat verbinding maakt met de geconfigureerde Application Insights-bron. Toegang via Foundry vereist rolgebaseerde toegang tot het Foundry-project (Foundry User of hoger) naast leesrechten op de Application Insights-resource. Toegang tot een Foundry-project alleen omvat geen toegang tot de telemetriegegevens.

Verwante onderwerpen

• Consumeer een data-agent in Microsoft Foundry
• Opsporing instellen voor AI-agents in Microsoft Foundry
• Waarneembaarheid in generatieve AI
• Configureer tenantinstellingen van Fabric data agent