Gerenciar agentes em escala no Microsoft Foundry Control Plane

Plano de Controle do Microsoft Foundry fornece gerenciamento centralizado e observabilidade para os agentes executados em plataformas e infraestruturas com suporte. Com o Plano de Controle do Foundry, você pode gerenciar agentes distribuídos entre vários projetos em uma assinatura.

Este artigo explica como exibir o inventário do agente, monitorar a integridade do agente e executar operações de ciclo de vida usando o portal do Foundry.

Pré-requisitos

• Uma conta Azure com uma assinatura ativa. Se você não tiver uma, crie uma conta de Azure free, que inclui uma assinatura de avaliação gratuita.

• Um projeto do Foundry. Se você não tiver um, crie um projeto.

• Application Insights configurado para métricas de observabilidade (opcional, porém recomendado).

Inventário de agente

O painel Ativos fornece uma tabela unificada e pesquisável de todos os ativos de IA em projetos dentro de uma assinatura. Esse inventário reúne metadados críticos e indicadores de integridade, para que você possa avaliar e agir sobre seu patrimônio de IA com eficiência.

O Foundry Control Plane descobre automaticamente agentes com suporte dentro dos recursos na assinatura selecionada e os exibe na guia Agentes. Para exibi-los, selecione Operar>Ativos>Agentes.

As seguintes informações são exibidas:

Modelo de permissões

O Plano de Controle Foundry descobre automaticamente agentes que os usuários têm permissão para acessar. Como o Plano de Controle do Foundry agrega informações entre recursos dentro da assinatura, usuários diferentes podem ver diferentes agentes listados no painel Ativos , dependendo do nível de acesso em cada recurso.

As seguintes funções afetam o que você pode ver e fazer:

Plataformas de agentes suportadas

O Foundry Control Plane descobre automaticamente agentes nas seguintes plataformas:

Agentes de fundição

O Plano de Controle do Foundry ajuda você a gerenciar agentes em todos os seus projetos do seu Foundry. Quando você cria um agente ou fluxo de trabalho em um projeto do Foundry, o agente aparece no inventário. O Plano de Controle do Foundry lista todos os agentes em todos os projetos em uma assinatura.

Para cada agente, as informações incluem:

• A versão mais recente do agente.
• Versões publicadas como aplicativos de agente.

Você pode monitorar versões consumidas por seus usuários e novas versões em desenvolvimento. O exemplo a seguir mostra vários agentes do Foundry listados. A versão 6 do agente foi publicada, mas a format-agent versão 7 (mais recente) ainda está em desenvolvimento.

Agente SRE do Azure

Azure agente SRE ajuda você a manter a integridade e o desempenho de seus recursos de Azure por meio de monitoramento e assistência alimentados por IA. Os agentes observam continuamente seus recursos em busca de problemas, fornecem ajuda para solução de problemas e sugerem etapas de correção em uma interface de chat em linguagem natural. Saiba mais sobre o Agente SRE do Azure.

O Plano de Controle Foundry descobre os recursos do Agente SRE do Azure em sua assinatura e os exibe no inventário.

loop do agente Aplicativos Lógicos do Azure

Aplicativos Lógicos do Azure dá suporte a fluxos de trabalho que completam tarefas usando ciclos de agente com modelos de linguagem de grande porte (LLMs). Um loop de agente usa um processo iterativo para resolver problemas complexos de várias etapas. Saiba mais sobre fluxos de trabalho com agentes de IA e modelos em Aplicativos Lógicos.

O Plano de Controle de Foundry descobre recursos de Aplicativos Lógicos que contêm workflows de loop de agente e os lista no inventário.

Agentes personalizados

Para plataformas agentic que o Plano de Controle do Foundry não dá suporte, você pode registrar manualmente agentes em um projeto do Foundry para habilitar o gerenciamento.

Registrar agentes personalizados executados em Azure serviços de computação ou em outros ambientes de nuvem pode ajudá-lo a obter visibilidade de suas operações e controlar seu comportamento. Você pode registrar um agente personalizado no Plano de Controle do Foundry e desenvolver o agente na tecnologia de sua escolha, tanto para soluções de plataforma quanto de infraestrutura.

Saiba como registrar um agente no Plano de Controle do Foundry para habilitar o gerenciamento.

Observabilidade de agentes

O Plano de Controle do Foundry usa os recursos do Application Insights que hospedam seus agentes para ajudá-lo a monitorar e diagnosticar esses agentes. Quando esses dados estão disponíveis, o Plano de Controle do Foundry pode:

• Execuções de computação e taxas de erro.
• Métricas de uso de computação, incluindo o uso e o custo do token.
• Coletar rastros de execução.

Se você não visualizar essas informações no seu agente, precisará configurar Application Insights. Verifique se você também tem as permissões apropriadas para exibir dados do Application Insights e métricas de custo.

Exibir rastreamentos

Você pode exibir rastreamentos e logs enviados para o Foundry. Os rastreamentos são armazenados no Application Insights e você pode consultá-los usando o portal do Foundry ou qualquer outra ferramenta compatível.

Para exibi-los:

1. Na barra de ferramentas, selecione Operar.

2. No painel esquerdo, selecione Ativos.

3. Selecione o agente.

4. Selecione a guia Rastreamentos . A guia mostra uma entrada para cada chamada feita ao agente.

   Duas colunas contêm IDs associadas à chamada: ID de rastreamento e ID de conversa. Os rastreamentos são armazenados no Application Insights e contêm dados para diagnosticar o comportamento. A coluna ID da conversa se aplica a agentes do Foundry. Ele contém a conversa associada ao rastreamento. As conversas são armazenadas no serviço Foundry.

   

5. Para ver os detalhes, selecione um valor na coluna ID de rastreamento .

   

   Dica

   Os agentes personalizados exigem uma configuração extra para mostrar detalhes, incluindo ferramentas e extensões LLM. Saiba mais em Instrumentar agentes de código personalizados.

Operações de ciclo de vida

O Foundry Control Plane ajuda as organizações a controlar agentes para gerenciar o uso e o custo da infraestrutura. Diferentes plataformas de agente dão suporte a operações diferentes.

A tabela a seguir resume as ações com suporte para cada plataforma. O suporte de um agente do Foundry depende do tipo de agente e do seu estado de publicação.

Iniciar e parar agentes

Ao parar um agente, você interrompe a infraestrutura associada a ele e move o agente para o estado Parado .

Parar um agente desprovisiona sua infraestrutura e impede novas execuções de tarefas. Quaisquer fluxos de trabalho ou recursos conectados a esse agente não podem acessá-lo. Essa operação não encerra as execuções existentes.

Para interromper um agente:

1. Na barra de ferramentas, selecione Operar.

2. No painel esquerdo, selecione Ativos.

3. Selecione o agente que você deseja parar. O painel de informações é exibido.

4. Selecione Atualizar status e, em seguida, selecione Parar.

   

5. Confirme a operação.

Depois de interromper o agente, o valor Status do agente na Foundry será Parado.

Para iniciar o agente:

1. Selecione Atualizar status e, em seguida, selecione Iniciar.

2. Confirme a operação.

Bloquear e desbloquear agentes

Para agentes personalizados, a Foundry não tem acesso à infraestrutura subjacente em que o agente é executado, portanto, as operações iniciar e parar não estão disponíveis. No entanto, a Foundry pode bloquear solicitações recebidas para o agente. O bloqueio impede que os clientes usem o agente. Essa funcionalidade permite que os administradores desabilitem um agente se ele se comportar mal.

Para bloquear solicitações recebidas para seu agente:

1. Na barra de ferramentas, selecione Operar.

2. No painel esquerdo, selecione Ativos.

3. Selecione o agente que você deseja bloquear. O painel de informações é exibido.

4. Selecione Atualizar status e, em seguida, selecione Bloquear.

   

5. Confirme a operação.

Depois de bloquear o agente, o valor status do agente na Foundry será Bloqueado. Os agentes no estado Bloqueado operam em sua infraestrutura associada, mas não podem receber requisições de entrada. Foundry bloqueia qualquer tentativa de comunicação com o agente.

Para desbloquear o agente:

1. Selecione Atualizar status e, em seguida, selecione Desbloquear.

2. Confirme a operação.

Manipular estados desconhecidos

Em determinadas circunstâncias, os agentes podem exibir o status Desconhecido. Esse status indica que o Plano de Controle do Foundry não pode determinar o estado do agente porque a plataforma de origem está indisponível ou o agente não reportou.

Para solucionar problemas de um status desconhecido :

1. Verifique se a plataforma de origem (por exemplo, Aplicativos Lógicos do Azure ou Azure SRE Agent) está operacional.
2. Para agentes personalizados, certifique-se de que a infraestrutura do agente esteja operando e acessível.
3. Verifique os logs do Application Insights do agente para encontrar rastros de erro.
4. Se o status não for corrigido, tente parar e reiniciar o agente.

Solucionando problemas

Os dados de observabilidade não estão visíveis

Se métricas como taxa de erro, uso de token ou custo não aparecerem para um agente:

1. Verifique se o Application Insights está configurado para o recurso que hospeda o agente.
2. Confirme se você tem as permissões necessárias para exibir dados do Application Insights e métricas de custo.
3. Execute o agente depois de configurar o Application Insights. As métricas e rastreamentos são coletados apenas para execuções que ocorrem após a configuração. As execuções anteriores não são registradas retroativamente.
4. Aguarde até 15 minutos para que os dados sejam propagados após a primeira execução pós-configuração.

O agente não aparece no inventário

Se um agente esperado não aparecer no painel Ativos :

1. Confirme se o agente está em uma plataforma com suporte.
2. Verifique se você tem permissões RBAC no recurso que hospeda o agente.
3. Verifique se o agente está dentro da assinatura selecionada no momento.
4. Para agentes personalizados, verifique se o agente está registrado em um projeto do Foundry.

Conteúdo relacionado

• O que é Microsoft Foundry Plano de Controle?
• Monitorar a saúde e o desempenho do agente em toda a frota
• Registrar um agente personalizado no Plano de Controle do Foundry