Microsoft Foundry por dentro: a arquitetura de um agente de atendimento
Você manda "cadê meu pedido?" para o chat de uma loja e a resposta certa chega na hora. Por trás disso existe uma arquitetura com agente, modelo, ferramentas, controles de segurança e monitoramento.
Neste artigo, montamos essa arquitetura no Microsoft Foundry, a plataforma da Microsoft que reúne agentes, modelos e ferramentas sob um único recurso do Azure, com recursos corporativos como tracing, monitoramento e avaliações.
⚡ Destaques Rápidos
- Agente = modelo + instruções + ferramentas, capaz de raciocinar sobre o pedido e agir.
- Catálogo com mais de 10.000 modelos (Microsoft, OpenAI, Anthropic, Meta e outros) — e dá para trocar o modelo sem mudar o código do agente.
- Ferramentas: funções, busca na web, busca em arquivos, interpretador de código e servidores MCP, organizadas numa toolbox.
- Dois jeitos de criar: prompt agent (sem código) ou hosted agent (seu código em contêiner).
- Pronto para empresa: identidade Microsoft Entra por agente, RBAC, filtros de conteúdo e rede isolada; tracing e avaliações para observabilidade.
⟩_ Tudo começa num projeto
No Foundry, agentes, modelos e ferramentas ficam reunidos num projeto, com controle de acesso, rede e políticas unificados sob um único recurso do Azure. Na nossa arquitetura, o cliente conversa com o agente, e o agente usa o modelo e as ferramentas para responder.
⟩_ O que é um agente
Segundo a documentação oficial, um agente é um modelo combinado com instruções e ferramentas, capaz de raciocinar sobre uma solicitação e tomar ações. As instruções definem o papel — por exemplo, "você é o atendente da loja; consulte o pedido antes de responder".
⟩_ O catálogo de modelos
O Foundry dá acesso a mais de 10.000 modelos de Microsoft, OpenAI, Anthropic, Meta e outros. No Foundry Agent Service, é possível trocar o modelo sem mudar o código do agente — a documentação cita exemplos como GPT-4o, Llama e DeepSeek.
⟩_ Como o agente descobre onde está o pedido
Aqui entram as ferramentas. O modelo percebe que precisa de dados e pede a chamada de uma função; a função consulta o sistema de pedidos; o resultado volta para o agente, e o modelo escreve a resposta ao cliente.
⟩_ Ferramentas e toolbox
Além de funções personalizadas, o Foundry oferece ferramentas como busca na web, busca em arquivos, interpretador de código e memória, e permite conectar servidores MCP e especificações OpenAPI. Uma toolbox agrupa essas ferramentas uma vez e as expõe para vários agentes por meio de um único endpoint gerenciado compatível com MCP, com autenticação, governança e versionamento centralizados.
⟩_ Prompt agent ou hosted agent?
A escolha depende de quanto controle você precisa sobre como o agente roda:
- Prompt agent: você define instruções, modelo e ferramentas no portal ou pelo SDK, e o Foundry hospeda e executa o agente — sem código de aplicação nem contêineres para manter.
- Hosted agent: você traz seu próprio código ou framework (como Microsoft Agent Framework ou LangGraph), empacota em contêiner, e o Foundry executa com endpoint gerenciado, escala e identidade.
⟩_ Segurança de nível empresarial
Cada agente pode ter uma identidade dedicada no Microsoft Entra, com acesso restrito aos recursos de que precisa. Somam-se controle de acesso baseado em funções (RBAC), filtros de conteúdo que ajudam a reduzir riscos de prompt injection e saídas inseguras, e isolamento de rede com redes virtuais.
⟩_ Observabilidade: tracing e avaliações
Com o tracing, é possível inspecionar cada chamada de modelo, cada uso de ferramenta e cada decisão do agente. As avaliações medem a qualidade das respostas — o Foundry tem avaliadores nativos como relevância, coerência e precisão no uso de ferramentas.
⟩_ Publicar e levar para onde o time trabalha
Os agentes têm versões salvas automaticamente e podem ser publicados como recurso gerenciado com endpoint estável. Agentes publicados podem ser compartilhados no Microsoft Teams e no Microsoft Copilot.
⟩_ Resumo
Projeto, agente, modelo, ferramentas, segurança e observabilidade: essas são as peças que transformam um "cadê meu pedido?" numa resposta certa e rastreável.