Hosted agent
Concept
Um tipo de agente no Foundry Agent Service em que você traz seu próprio código e framework, e o Foundry o executa em uma sessão isolada, escalando-o e atribuindo-lhe uma identidade própria.
Descrição
Um Hosted agent é um tipo de agente no Foundry Agent Service em que o desenvolvedor fornece o código e o framework, e a plataforma os executa. O Microsoft Learn descreve os hosted agents como aplicações de IA agêntica em contêineres que rodam no Foundry Agent Service. Diferentemente dos agentes baseados em prompts, que são definidos apenas por meio de prompts e configurações de ferramentas no portal, o código de um Hosted agent é, por si só, uma imagem de contêiner. O desenvolvedor escolhe o framework e controla o comportamento em tempo de execução, enquanto os modelos vêm do catálogo de modelos do Foundry e o código personalizado cuida da orquestração.
O principal motivo para escolher um Hosted agent é o controle sobre o funcionamento do agente. As opções suportadas citadas na documentação incluem o Microsoft Agent Framework, LangChain e LangGraph, ou código personalizado escrito em Python e C#. A plataforma assume tarefas transversais que, de outra forma, caberiam à equipe: conteinerização, configuração do servidor web, segurança, persistência de memória, escalabilidade, instrumentação e reversão de versões. Essa divisão permite que os desenvolvedores se concentrem na lógica do agente em vez da infraestrutura de hospedagem.
Na operação, cada Hosted agent recebe uma identidade própria do Microsoft Entra e um endpoint dedicado. Cada sessão é executada em um sandbox isolado por VM, com sistema de arquivos persistente, e o serviço oferece suporte a escala para zero. As versões são imutáveis, e um endpoint atende a uma versão por vez, sem divisão de tráfego. Para implantar um agente, são necessárias uma imagem de contêiner no Azure Container Registry e um projeto do Foundry. A cobrança segue o uso de CPU e memória durante as sessões ativas. Quanto aos segredos, a documentação desaconselha colocá-los nas imagens ou em variáveis de ambiente e recomenda identidades gerenciadas e o Key Vault.
As decisões típicas em torno dos Hosted agents envolvem a escolha entre um agente de prompt e um hospedado. Um agente de prompt é adequado quando os prompts e as configurações de ferramentas definidos no portal são suficientes. Um Hosted agent se aplica quando é necessária orquestração personalizada, um framework específico ou controle total do ambiente de execução. Como as versões são imutáveis e um endpoint aponta para uma versão por vez, as implantações e reversões são feitas trocando de versão, e não dividindo o tráfego.
O episódio do M365.FM "Enterprise AI Agent Fabric: Architecture Beyond Chatbots" posiciona os Hosted agents dentro do fluxo de trabalho mais amplo do Foundry. De acordo com o episódio, o Foundry conecta modelos, conhecimento e ferramentas em um único ambiente de execução e oferece suporte a um fluxo de trabalho de construir-testar-implantar-monitorar para o desenvolvimento de agentes. Em sua visão geral desse fluxo, criar um agente pode significar definir um agente de prompt no portal ou com o SDK, ou escrever um Hosted agent que chama a Responses API. O episódio then lista os testes no playground de agentes ou localmente, o rastreamento de cada chamada de modelo, invocação de ferramenta e decisão, a execução de avaliações para detectar regressões e a otimização das instruções de um hosted agent com o agent optimizer.
Em resumo, um Hosted agent combina código sob controle do desenvolvedor com um ambiente de execução gerenciado: o contêiner e o framework são escolhas da equipe, enquanto isolamento, identidade, escalabilidade e versionamento são fornecidos pelo Foundry Agent Service.
Overview compiled with AI from M365.FM episodes and the facts on this page. You can improve it with the edit button below.
| Tipo | Concept |
|---|
Perguntas frequentes
Questions marked with AI were written with AI from the facts on this page.
Qual é a diferença entre um Hosted agent e um agente de prompt? (AI)
Um agente de prompt é definido apenas por meio de prompts e configurações de ferramentas no portal, enquanto o código de um Hosted agent é uma imagem de contêiner cujo framework e comportamento em tempo de execução são controlados pelo desenvolvedor.
Quais frameworks um Hosted agent pode usar? (AI)
O Microsoft Learn cita o Microsoft Agent Framework, LangChain e LangGraph, ou código personalizado em Python e C#.
Como os Hosted agents são isolados e identificados? (AI)
Cada agente recebe uma identidade própria do Microsoft Entra e um endpoint dedicado, e cada sessão é executada em um sandbox isolado por VM, com sistema de arquivos persistente.
Community wiki
Short info above, community knowledge below: add practical tips, examples or corrections. New contributions are reviewed first; trusted members publish directly.
Especialistas e empresas para este tópico
Ninguém indicou ainda este tópico. Adicione-o ao seu perfil.
Maintained by Mirko Peters (Microsoft MVP) · Last updated: