O que é o serviço Microsoft Foundry Agent?

O Foundry Agent Service é uma plataforma totalmente gerenciada para criar, implantar e dimensionar agentes de IA. Use qualquer estrutura e muitos modelos do catálogo de modelos do Foundry. Crie agentes de prompt sem código no portal do Foundry ou use os SDKs disponíveis e a API REST para implantá-los e agentes hospedados baseados em código criados com o Agent Framework, LangGraph ou seu próprio código.

O Serviço de Agente lida com hospedagem, dimensionamento, identidade, observabilidade e segurança da empresa para que você possa se concentrar na lógica do agente.

O que é um agente?

Um agente é um aplicativo de IA que usa um modelo do catálogo de modelos do Foundry para raciocinar sobre solicitações de usuário e tomar ações autônomas para atendê-las. Ao contrário de um chatbot simples que gera apenas texto, um agente pode chamar ferramentas, acessar dados externos e tomar decisões em várias etapas para concluir uma tarefa. Cada agente combina três componentes principais:

  • Modelo: um modelo do catálogo de modelos do Foundry que fornece recursos de raciocínio e linguagem.
  • Instruções: definir metas, restrições e comportamento. No Foundry, as instruções podem ser baseadas em prompt, definições de fluxo de trabalho ou código do agente hospedado.
  • Ferramentas: forneça acesso a dados ou ações, como pesquisa, operações de arquivo ou chamadas à API.

Um diagrama mostrando os componentes de um agente de IA.

Serviço de Agente: Visão Geral

Componente O que ele faz
Runtime do Agente Hospeda e dimensiona agentes de linha de comando e agentes hospedados. Gerencia conversas, invocações de ferramentas e ciclo de vida do agente.
Ferramentas Ferramentas internas, incluindo pesquisa na Web, pesquisa de arquivos, memória, interpretador de código, servidores MCP e funções personalizadas. Estenda os recursos do agente sem criar infraestrutura. As ferramentas possuem autenticação gerenciada, incluindo credenciais gerenciadas pelo serviço e autenticação Em-Nome-De-Outro (OBO). Alguns servidores MCP, como Azure DevOps SERVIDOR MCP (versão prévia), exigem a conexão de uma organização durante a instalação. O acesso pode ser definido por meio da configuração da ferramenta Foundry.
Modelos Funciona com muitos modelos do catálogo de modelos do Foundry, como GPT-4o, Llama e DeepSeek. Troque modelos sem alterar o código do agente.
Observabilidade Rastreamento de ponta a ponta, métricas e integração do Application Insights. Veja todas as decisões tomadas pelo agente.
Identidade & Segurança Microsoft Entra Identity, RBAC, filtros de conteúdo e isolamento de rede virtual. Confiança de nível empresarial incorporada.
Publicação Agentes de versão, crie pontos de extremidade estáveis e compartilhe por meio do Microsoft Teams, do Microsoft 365 Copilot e do Registro do Agente Entra.

Comece com agentes

Pronto para começar a usar agentes? Escolha seu caminho com base em como você deseja construir.

  • É novo em agentes?Comece com um agente inicial para configurar um agente com instruções e ferramentas. Use o portal do Foundry para criar um sem nenhum código necessário ou usar os SDKs ou a API REST.
  • Deseja implantar um agente como um contêiner com uma estrutura de sua escolha?Crie um agente hospedado com o Agent Framework ou o LangGraph, implante-o no Foundry e teste-o de ponta a ponta.
  • Deseja orquestrar vários agentes?Crie um fluxo de trabalho para orquestrar agentes e lógica de negócios em um construtor visual.

Tipos de agente

O Serviço de Agente dá suporte a três tipos de agentes, cada um projetado para necessidades diferentes:

  • Agentes de prompt
  • Agentes de fluxo de trabalho (versão prévia)
  • Agentes hospedados (versão prévia)

Agentes de prompt

Os agentes de prompt são definidos inteiramente por meio da configuração – instruções, seleção de modelo e ferramentas. Crie-os no portal do Foundry ou por meio da API ou SDKs, e o Serviço de Agente manipula a orquestração e a hospedagem automaticamente.

Melhor para: protótipos rápidos, ferramentas internas e agentes que não precisam de lógica de orquestração personalizada. Crie um agente de trabalho em minutos usando o portal.

Agentes de fluxo de trabalho (versão prévia)

Os agentes de fluxo de trabalho orquestram uma sequência de ações ou coordenam vários agentes usando definições declarativas. Crie fluxos de trabalho visualmente no portal do Foundry ou defina-os no YAML por meio de Visual Studio Code. Os fluxos de trabalho dão suporte à lógica de ramificação, etapas humanas no loop e padrões sequenciais ou de chat em grupo.

Melhor para: orquestração de várias etapas, coordenação de agente para agente, fluxos de trabalho de aprovação e cenários que precisam de automação repetível sem código personalizado.

Agentes hospedados (versão prévia)

Os agentes hospedados são agentes baseados em código criados com uma estrutura de sua escolha e implantados como contêineres no Serviço de Agente. Você escreve a lógica de orquestração – chamadas de ferramenta, raciocínio de várias etapas, coordenação de agente para agente – e o Foundry gerencia o runtime, o dimensionamento e a infraestrutura.

Nota

Os agentes hospedados estão atualmente em versão prévia pública.

Melhor para: fluxos de trabalho complexos, integrações de ferramentas personalizadas, sistemas de vários agentes e cenários em que você precisa de controle total sobre o comportamento do agente.

Comparar tipos de agente

Agentes de prompt Agentes de fluxo de trabalho Agentes hospedados (versão prévia)
Código necessário Não Não (YAML opcional) Sim
Hospedagem Totalmente gerenciado Totalmente gerenciado Baseado em contêiner, gerenciado
Orquestração Agente único Sistemas multiagentes, ramificação Lógica personalizada
Melhor para Prototipagem, tarefas simples Automação de várias etapas Controle total, estruturas personalizadas

Suporte ao modelo

O Serviço de Agente funciona com muitos modelos disponíveis no catálogo do Foundry. Para obter a lista completa, consulte Cotas, limites e suporte regional.

Ferramentas

O Serviço de Agente fornece ferramentas internas e dá suporte a ferramentas personalizadas para que seus agentes possam executar ações e acessar dados. Para obter uma lista completa, consulte o catálogo de ferramentas do Foundry. Para obter padrões avançados de seleção de ferramentas, consulte as práticas recomendadas da Ferramenta.

O Foundry dá suporte a servidores MCP remotos que você pode adicionar no catálogo Adicionar Ferramentas no portal do Foundry. Por exemplo, o servidor MCP Azure DevOps (versão prévia pública) pode ser adicionado diretamente do catálogo. Conecte sua organização Azure DevOps para habilitar o acesso ao agente e configure um subconjunto de ferramentas disponíveis para controlar quais ações os agentes podem executar. Você também pode conectar servidores MCP personalizados hospedados no Azure Functions usando o ponto de extremidade de webhook do MCP Functions (/runtime/webhooks/mcp) para expor ferramentas personalizadas aos seus agentes. O catálogo Adicionar Ferramentas é o ponto de entrada para habilitar servidores MCP e selecionar ferramentas permitidas para um agente.

As opções de autenticação com suporte para conectar servidores MCP incluem:

  • Acesso baseado em chave
  • Microsoft Entra (usando a identidade gerenciada do agente ou a identidade gerenciada do projeto)
  • Passagem de identidade OAuth (On-Behalf-Of)
  • Acesso não autenticado, quando apropriado

Essas opções de autenticação também se aplicam ao conectar servidores MCP remotos, com credenciais e escopos gerenciados na configuração da ferramenta.

Caixa de ferramentas (versão prévia)

Toolbox permite definir um conjunto de ferramentas com curadoria uma vez, gerenciá-las centralmente na Foundry e expô-las por meio de um único endpoint compatível com MCP. Qualquer cliente ou runtime de agente compatível com MCP pode consumir uma caixa de ferramentas, independentemente da estrutura usada. O controle de versão da caixa de ferramentas fornece controle explícito sobre quando as alterações entrarem em vigor – criar uma nova versão, testá-la e promovê-la para o padrão quando você estiver pronto.

Nota

Algumas ferramentas, incluindo memória e pesquisa na Web, estão em versão prévia. Para obter disponibilidade por região e status de visualização, consulte o suporte à ferramenta por região e modelo.

Ciclo de vida de desenvolvimento

O Serviço de Agente dá suporte ao fluxo de trabalho completo de compilação-teste-implantação-monitoramento:

  1. Criar – Definir um agente de comando no portal ou criar um agente hospedado no código.
  2. Teste – converse com o agente no laboratório de agentes ou execute localmente. As integrações de servidor MCP, incluindo servidores MCP personalizados hospedados em Azure Functions, podem ser exercidas diretamente no playground por meio de prompts de chat para validar a conectividade, as permissões e o comportamento da ferramenta antes da publicação.
  3. Rastreamento – Inspecione cada chamada de modelo, invocação de ferramenta e decisão com rastreamento de agente.
  4. Avaliar – Executar avaliações para medir a qualidade e capturar regressões.
  5. Publicar – Promova seu agente a um recurso gerenciado com um endpoint estável.
  6. Monitorar – Acompanhar o desempenho e a confiabilidade com métricas de serviço e dashboards.

Para obter um passo a passo detalhado, consulte o ciclo de vida de desenvolvimento do Agente.

Funcionalidades da empresa

O Serviço de Agente fornece infraestrutura de nível empresarial para cada agente que você implantar:

  • Agent identity — Cada agente pode ter uma identidade de Microsoft Entra dedicada, habilitando o acesso seguro e com escopo a recursos e APIs sem compartilhar credenciais. As identidades de agentes podem autenticar-se em servidores MCP externos, incluindo aqueles hospedados no Azure Functions, e a passagem OAuth On-Behalf-Of (OBO) é suportada quando configurada.
  • Private networking — Execute agentes em sua rede virtual Azure para isolamento de rede completo e conformidade com os requisitos de residência de dados. A rede de computadores privada está disponível para agentes de prompt e agentes de fluxo de trabalho. Os agentes hospedados oferecem suporte ao Bring-Your-Own Rede Virtual do Azure (BYO VNet), onde cada sessão ocorre em um "sandbox" isolado de VM conectado à sua VNet.
  • Controle de acesso baseado em funções — Permissões refinadas por meio do Microsoft Entra e Azure RBAC. Controlar quem pode criar, invocar e gerenciar agentes.
  • Proteção de conteúdo – filtros de conteúdo integrados ajudam a mitigar os riscos de injeção de comandos (incluindo injeção cruzada de comandos) e a evitar saídas não seguras.

Para obter instruções de configuração de ambiente, consulte Configurar seu ambiente.

Publicação e compartilhamento

O Serviço de Agente fornece controle de versão e publicação internos para que seus agentes possam passar do desenvolvimento para a produção com confiança.

  • Controle de versão – à medida que você itera seu agente, as versões são automaticamente armazenadas como instantâneos. Reverta para qualquer versão anterior ou compare as alterações entre as versões.
  • Publicação – promover um agente a um recurso gerenciado com um endpoint estável. Os agentes publicados herdam a identidade da empresa e os controles de acesso configurados para seu projeto e podem ser invocados programaticamente.
  • Distribution — Compartilhe agentes publicados através de Microsoft 365 Copilot e Teams e do Registro de Agentes do Entra, colocando seus agentes onde os usuários já trabalham. O Foundry Agent Service dá suporte aos Protocolos OpenResponses e de Atividade para publicação no Microsoft 365 e um protocolo de Invocações para integração de ponto de extremidade flexível com aplicativos e serviços personalizados.

Segurança, privacidade e conformidade

O Serviço de Agente foi projetado para cargas de trabalho corporativas em que você precisa de controles fortes sobre identidade, rede, manipulação de dados e segurança.

  • Controles de segurança: utilize guardrails integrados para ajudar a reduzir as saídas não seguras e atenuar os riscos de injeção de prompt, incluindo ataques de injeção de prompt cruzado (XPIA).
  • Isolamento de rede e controles de residência de dados: use redes virtuais e traga seus próprios recursos para atender às suas necessidades.
  • Traga seus próprios recursos: use seus próprios recursos do Azure (por exemplo, armazenamento, Pesquisa de IA do Azure  e Azure Cosmos DB para estado de conversa) para atender às necessidades operacionais e de conformidade. Consulte Usar seus próprios recursos.
  • Diretrizes de IA Responsável: para obter um conjunto mais amplo de recomendações e recursos de governança, consulte Responsible AI for Microsoft Foundry.

Manifestos do agente

Os manifestos do agente são configurações pré-criadas que você pode implantar com um clique. Cada manifesto combina instruções testadas, configurações de ferramenta e padrões de interação para fluxos de trabalho comuns da empresa. Procure manifestos por setor, ferramentas ou complexidade para encontrar um ponto de partida e personalize para seu cenário. Para obter mais informações, consulte Manifesto do Agente do Serviço Foundry.

Conteúdo relacionado

  • Last updated on