Observabilidade para agentes de dados do Fabric no Microsoft Foundry

Você pode adicionar um agente de dados Fabric como ferramenta a um agente que você construir no Microsoft Foundry. Depois que você conecta, o agente da Foundry liga para o agente de dados da Fabric para responder perguntas que estejam relacionadas aos dados da sua empresa que estão no Fabric OneLake.

Este artigo é sobre observabilidade para essa configuração. Quando você constrói um agente no Foundry e conecta um agente de dados Fabric a ele, você quer ver o que o agente de dados fez em cada solicitação, não apenas a resposta final. O Foundry Observability oferece essa visibilidade. Os logs e rastreamentos do agente de dados são enviados para o mesmo lugar para o qual seu agente do Foundry já envia dados, para que você possa acompanhar uma solicitação de ponta a ponta, do agente do Foundry até o agente de dados do Fabric, e daí até as fontes de dados que ele consultou.

O restante deste artigo explica onde essa telemetria é armazenada, como ela chega lá, como lê-la, quem pode vê-la e como controlá-la.

Para uma visão geral, veja Observabilidade em IA generativa . Para conectar um agente de dados Fabric ao Foundry, veja Consumir um agente de dados no Microsoft Foundry.

Projetos de fundição e insights de aplicação

Um projeto Foundry é onde você constrói e executa seus agentes. O Foundry armazena rastros de agente em um recurso do Azure Monitor Application Insights, e cada projeto se conecta a um desses recursos.

Como criador de agentes, faça essa configuração uma única vez. No seu projeto Foundry, abra a seção Agentes , selecione Traços e selecione Conectar. Você pode criar um novo recurso de Insights de Aplicação ou conectar um que já existe. Depois que você conecta o recurso, o Foundry ativa automaticamente o rastreamento do lado do servidor para o projeto. Você não precisa fazer nenhuma alteração no código, e os rastreios começam a fluir em minutos.

A relação é simples: o projeto aponta para um recurso do Application Insights, e todo agente desse projeto envia seus rastreamentos para lá. O projeto define onde a telemetria é coletada; O Application Insights é onde ele está e onde você o consulta.

Você pode visualizar os rastreios na aba Traces do seu agente Foundry, ou consultá-los diretamente no recurso conectado do Application Insights. O portal da Fundição mostra vestígios dos últimos 90 dias.

Para configuração passo a passo, veja Configurar rastreamento para agentes de IA no Microsoft Foundry.

Como os logs e rastreamentos do Fabric data agent chegam ao seu projeto

Para conectar um agente de dados Fabric ao Foundry, trabalhe em um projeto Foundry. Se você conectar um recurso Application Insights a esse projeto, o agente de dados Fabric envia seus logs e rastreamentos para esse mesmo recurso. A telemetria do seu agente da Foundry e a telemetria do agente de dados da Fabric ficam em um só lugar, então vocês podem lê-las juntas.

O fluxo funciona assim:

1. No seu projeto Foundry, conecte um recurso Application Insights, conforme descrito na seção anterior.
2. Adicione um agente de dados Fabric como ferramenta a um agente Foundry nesse projeto.
3. Quando o agente do Foundry é executado, ele chama o agente de dados do Fabric para obter informações dos dados empresariais no Fabric OneLake.
4. O Fabric valida o recurso Application Insights conectado ao projeto e depois envia os logs e rastreamentos do agente de dados para ele.
5. A telemetria do agente de dados aparece ao lado dos rastreamentos do seu agente do Foundry, tanto no recurso conectado do Application Insights quanto na exibição Rastreamentos do agente.

O resultado é que o trabalho realizado pelo agente de dados Fabric passa a fazer parte do rastreamento da solicitação. Você vê que seu agente da Foundry ligou para o agente de dados, e vê o que o agente de dados fez para produzir sua resposta, incluindo quais fontes de dados ele consultou, quanto tempo levou cada etapa e se cada etapa teve sucesso.

Leia as pegadas

Foundry Observability registra cada requisição como um rastreamento. Um rastreamento consiste em spans, e cada span representa uma unidade de trabalho com seu próprio instante de início, duração e status. Os spans são aninhados, então ler um trace de cima para baixo mostra o caminho percorrido pela solicitação e onde o tempo foi gasto.

Um agente de dados do Fabric adiciona dois tipos de intervalos ao rastreamento:

• Agente span: a execução geral do agente de dados Fabric para uma única solicitação.
• Escopo da ferramenta: uma única fonte de dados ou ferramenta que o agente de dados aciona ao responder à solicitação. Uma solicitação pode gerar mais de um span de ferramenta.

O exemplo a seguir mostra um agente Foundry que chama um agente de dados Fabric, que consulta duas fontes de dados para responder à pergunta:

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

A tabela a seguir descreve cada nível do traço e o tipo de metadados anexados a ele.

Com essa estrutura, você pode responder às perguntas que importam quando algo parece errado:

• Quando uma resposta está lenta, a duração de cada span mostra qual etapa demorou mais.
• Quando uma resposta está errada, a ferramenta mostra quais fontes de dados foram consultadas e em que ordem.
• Quando uma requisição falha, o status em cada tramo mostra onde a falha ocorreu.

Quem pode ver os registros e rastros

O recurso Application Insights que armazena os logs e rastreamentos do agente de dados governa o acesso. Qualquer pessoa com acesso de leitura a esse recurso pode ver a telemetria. Conectar um recurso a um projeto não concede acesso aos dados que ele contém.

O acesso a um projeto de fundição isoladamente não inclui acesso à telemetria. Permissão de leitura no recurso Application Insights é sempre necessária.

Configuração operacional de locatário de metadados

Uma configuração do locatário no portal de administração do Fabric controla se os agentes de dados do Fabric enviam metadados operacionais para fins de observabilidade no Foundry. A configuração é ativa por padrão.

A configuração envia apenas metadados operacionais. Esses metadados incluem nomes de exibição de agentes, nomes de fontes de dados, IDs de etapas de raciocínio e IDs de conversa. A Fabric não envia nenhum conteúdo para clientes. Os prompts do usuário e as respostas dos agentes de dados permanecem dentro do limite de conformidade do Fabric e não são incluídos nessa telemetria.

O cenário é o seguinte.

Agentes de dados Fabric podem enviar metadados operacionais para observabilidade no Microsoft Foundry

Criadores de agentes podem usar metadados operacionais para monitorar a saúde dos agentes, detectar problemas e entender como seus agentes publicados são usados em aplicações e serviços. Esses insights ajudam os criadores de agentes a melhorar a confiabilidade e o desempenho dos agentes.

Quando você ativa essa configuração, os agentes de dados do Fabric enviam metadados operacionais para um recurso de Insights de Aplicação configurado para processamento e armazenamento. Esses dados incluem nomes de exibição dos agentes, nomes de origem de dados, IDs de etapas de raciocínio e IDs de conversas. O recurso Application Insights que processa e armazena esses dados pode estar localizado fora da região geográfica, limite de conformidade ou instância nacional de nuvem do seu locatário.

Para acessar os metadados operacionais, você precisa de uma função com permissões de leitura (como Monitoring Reader ou Log Analytics Reader) no recurso configurado Application Insights. Usuários com esse acesso podem visualizar os dados no Application Insights. Os usuários também podem visualizar os dados por meio de um projeto Foundry que se conecta ao recurso configurado Application Insights. O acesso pelo Foundry requer acesso baseado em função ao projeto Foundry (Usuário Foundry ou superior), além de permissões de leitura no recurso Application Insights. O acesso a um projeto da Foundry sozinho não inclui acesso aos dados de telemetria.

Conteúdo relacionado

• Consumir um agente de dados no Microsoft Foundry
• Configure o rastreamento para agentes de IA no Microsoft Foundry
• Observabilidade na IA generativa
• Configurar configurações de inquilino do Fabric Data Agent