Observabilitet för Fabric-dataagenter i Microsoft Foundry

Du kan lägga till en Fabric-dataagent som ett verktyg till en agent du bygger i Microsoft Foundry. När du har anslutit den anropar Foundry-agenten Fabric-dataagenten för att besvara frågor som baseras på dina företagsdata som lagras i Fabric OneLake.

Den här artikeln handlar om observabilitet i den konfigurationen. När du bygger en agent i Foundry och kopplar en Fabric-dataagent till den, vill du se vad dataagenten gjorde på varje begäran, inte bara det slutgiltiga svaret. Foundry Observability ger dig den synligheten. Dataagentens loggar och spår skickas till samma plats som din Foundry-agent redan rapporterar till, så du kan följa en begäran från Foundry-agenten till Fabric-dataagenten och ner till de datakällor den frågade.

Resten av denna artikel förklarar var telemetrin lagras, hur den hamnar där, hur man läser den, vem som kan se den och hur man kontrollerar den.

För en allmän översikt, se Observerbarhet i generativ AI. För att koppla en Fabric-dataagent till Foundry, se Consume a data agent i Microsoft Foundry.

Gjuteriprojekt och applikationsinsikter

Ett Foundry-projekt är där du bygger och driver dina agenter. Foundry lagrar agentspår i en Azure Monitor Application Insights-resurs, och varje projekt kopplas till en sådan resurs.

Som agentbyggare behöver du bara konfigurera detta en gång. I ditt Foundry-projekt, öppna avsnittet Agenter , välj Spår och välj Koppla samman. Du kan skapa en ny Application Insights-resurs eller koppla upp en som redan finns. Efter att du har anslutit resursen aktiverar Foundry automatiskt server-side tracering för projektet. Du behöver inte göra några kodändringar, och spår börjar flöda inom några minuter.

Relationen är enkel: projektet pekar på en Application Insights-resurs, och varje agent i det projektet skickar sina spår dit. Projektet definierar var telemetri samlas in; Application Insights är där det finns och där du frågar efter det.

Du kan se spår i fliken Traces hos din Foundry-agent, eller fråga direkt i den anslutna Application Insights-resursen. Foundry-portalen visar spår från de senaste 90 dagarna.

För steg-för-steg-uppsättning, se Sätt upp spårning för AI-agenter i Microsoft Foundry.

Hur loggar och spårningar från Fabric-dataagenten når ditt projekt

För att koppla en Fabric-dataagent till Foundry, arbeta i ett Foundry-projekt. Om du kopplar en Application Insights-resurs till det projektet skickar Fabric-dataagenten sina loggar och spår till samma resurs. Din Foundry-agents telemetri och Fabric-dataagentens telemetri hamnar på ett ställe, så ni kan läsa dem tillsammans.

Flödet fungerar så här:

1. I ditt Foundry-projekt, koppla en Application Insights-resurs, som beskrivs i föregående avsnitt.
2. Lägg till en Fabric-dataagent som verktyg till en Foundry-agent i det projektet.
3. När Foundry-agenten körs anropar den Fabric-dataagenten för att få insikter från företagsdata i Fabric OneLake.
4. Fabric validerar Application Insights-resursen som är kopplad till projektet och skickar sedan dataagentens loggar och spår till den.
5. Telemetrin för dataagenten visas tillsammans med spårningarna för din Foundry-agent, både i den anslutna Application Insights-resursen och i agentens vy Traces.

Resultatet är att det arbete som Fabric-dataagenten utför blir en del av spårningen för förfrågan. Du ser att din Foundry-agent ringde dataagenten, och du ser vad dataagenten gjorde för att få fram sitt svar, inklusive vilka datakällor den frågade, hur lång tid varje steg tog och om varje steg lyckades.

Läs spåren

Foundry Observability registrerar varje begäran som en spårning. Ett spår består av spann, och varje spann representerar en arbetsenhet med egen starttid, varaktighet och status. Spannen är kapslade i varandra, så om man läser en spårning uppifrån och ned ser man vilken väg en begäran tog och var tiden gick åt.

En Fabric-dataagent lägger till två typer av spann till spåret:

• Agent span: den totala körningen av Fabric-dataagenten för en enda förfrågan.
• Verktygsspann: en enda datakälla eller ett verktyg som dataagenten anropar medan den svarar på förfrågan. En begäran kan generera mer än ett verktygsintervall.

Följande exempel visar en Foundry-agent som anropar en Fabric-dataagent, som frågar två datakällor för att besvara frågan:

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öljande tabell beskriver varje nivå av spåret och vilken typ av metadata som är kopplad till den.

Med denna struktur kan du besvara de frågor som är viktiga när något verkar fel:

• När ett svar är långsamt visar varaktigheten på varje spann vilket steg som tog mest tid.
• När ett svar är fel visar verktygen vilka datakällor som efterfrågades och i vilken ordning.
• När en förfrågan misslyckas visar statusen på varje spann var felet inträffade.

Vem kan se loggarna och spåren

Application Insights-resursen som lagrar dataagentens loggar och spår styr åtkomsten. Alla med läsåtkomst till den resursen kan se telemetrin. Att koppla en resurs till ett projekt ger inte tillgång till den data det innehåller.

Tillgång till ett Foundry-projekt i sig inkluderar inte tillgång till telemetrin. Läsbehörighet på Application Insights-resursen krävs alltid.

Klientinställning för driftsmetadata

En klientorganisationsinställning i administrationsportalen för Fabric styr om Fabric-dataagenter skickar driftsmetadata för observerbarhet i Foundry. Inställningen är aktiverad som standard.

Inställningen skickar endast driftsmetadata. Denna metadata inkluderar agentens visningsnamn, datakällors namn, resonemangssteg-ID:n och konversations-ID:n. Fabric skickar inget kundinnehåll. Användarpromptar och dataagentens svar håller sig inom Fabric:s efterlevnadsgränser och ingår inte i denna telemetri.

Miljön lyder som följer.

Fabric-dataagenter kan skicka operativ metadata för observabilitet i Microsoft Foundry

Agentskapare kan använda operativ metadata för att övervaka agentens hälsa, upptäcka problem och förstå hur deras publicerade agenter används över applikationer och tjänster. Dessa insikter hjälper agentskapare att förbättra agentens tillförlitlighet och prestanda.

När du aktiverar denna inställning skickar Fabric-dataagenter operativ metadata till en konfigurerad Application Insights-resurs för bearbetning och lagring. Denna data inkluderar agentvisningsnamn, datakällor, resonemangssteg-ID:n och konversations-ID:n. Application Insights-resursen som bearbetar och lagrar denna data kan vara belägen utanför din hyresgästs geografiska region, efterlevnadsgräns eller nationella molninstans.

För att få tillgång till den operativa metadatan behöver du en roll med läsbehörigheter (såsom Monitoring Reader eller Log Analytics Reader) på den konfigurerade Application Insights-resursen. Användare med denna åtkomst kan se datan i Application Insights. Användare kan också se datan via ett Foundry-projekt som ansluter till den konfigurerade Application Insights-resursen. Åtkomst via Foundry kräver rollbaserad åtkomst till Foundry-projektet (Foundry User eller högre) utöver läsbehörigheter på Application Insights-resursen. Tillgång till ett Foundry-projekt inkluderar inte tillgång till telemetridata.

Relaterat innehåll

• Använd en dataagent i Microsoft Foundry
• Konfigurera spårning för AI-agenter i Microsoft Foundry
• Observerbarhet i generativ AI
• Konfigurera Fabric data agent-tenant-inställningar