O que é Serviço Microsoft Foundry Agent?

O Foundry Agent Service é uma plataforma gerenciada para criar, implantar e dimensionar agentes de IA. Use qualquer estrutura, qualquer modelo com suporte do catálogo de modelos do Foundry e a API de Respostas como um único ponto de entrada.

Você escolhe quanto da plataforma deseja:

• Agentes de prompt – criar um agente de prompt no portal do Foundry ou defini-lo com SDKs e REST, e o Foundry o executa para você. Nenhum código de aplicativo a ser mantido, nenhuma computação a ser paga e nenhum contêiner ou pacote para otimizar, dimensionar ou aplicar patch.
• Hosted agents — escreva o código do agente com Agent FrameworkLangGraph, OpenAI Agents SDK, o SDK do agente Anthropic, o SDK GitHub Copilot ou seu próprio código, empacote-o como um contêiner e deixe o Foundry executá-lo com um ponto de extremidade gerenciado, dimensionamento, identidade e observabilidade.

Já tem o código do agente em execução fora do Foundry? Chame a API de Respostas do processo existente para obter modelos do Foundry e ferramentas de plataforma sem mover seu código.

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. Em alguns casos, os agentes atuam sem uma interface de chat , trabalhando de forma autônoma em segundo plano, disparada por eventos do sistema, para realizar tarefas em nome de um usuário ou organização.

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. Na Foundry, as instruções podem ser baseadas em prompt ou código em um agente hospedado.
• Ferramentas: forneça acesso a dados ou ações, como pesquisa, operações de arquivo ou chamadas à API.

Serviço de Agente: Visão Geral

Comece com agentes

Escolha seu caminho com base no que você está tentando fazer:

• Novo para os agentes?Comece com um agente de prompt – crie um agente no portal do Foundry, escolha um modelo, anexe as ferramentas e chame-o do código. Nenhum código de runtime para gravar ou manter – a Foundry executa o agente para você.
• Deseja criar um agente baseado em código no Foundry?Implantar um agente hospedado – escreva seu agente com o Agent Framework, LangGraph, o SDK de Agentes openai ou seu próprio código, empacote-o como um contêiner e deixe o Foundry executá-lo com um ponto de extremidade, dimensionamento e identidade gerenciados.
• Deseja usar modelos e ferramentas do Foundry do código do agente que você já executou em outro lugar?Chame a API de Respostas do processo existente para obter modelos do Foundry e ferramentas de plataforma sem mover seu código.

Tipos de agente

Há dois tipos principais de agente no Serviço de Agente:

• Agentes de prompt – autor no portal ou código, runtime totalmente gerenciado.
• Agentes hospedados (versão prévia) – o código do agente, executado pelo Foundry.

Agentes de prompt

Os agentes de prompt são definidos inteiramente por meio da configuração – instruções, seleção de modelo e ferramentas. Você os cria no portal do Foundry para um início rápido ou os define programaticamente com os SDKs ou a API REST para se integrar aos fluxos de trabalho de CI/CD. De qualquer forma, o Foundry executa o agente para você – não há nenhum código de aplicativo a ser mantido, nenhuma computação para pagar e nenhum contêiner ou pacote para otimizar, dimensionar ou monitorar a segurança.

Dois caminhos para começar:

• Primeiro, no portal — crie um agente interativamente no portal do Foundry, teste-o no playground e, em seguida, chame-o no código do seu aplicativo.
• Code-first – defina o agente usando o SDK ou a API REST no pipeline de implantação, habilitando o controle de versão, a revisão de código e a distribuição automatizada.

Melhor para: introdução rápida, ferramentas internas, agentes de produção que não precisam de lógica de orquestração personalizada e equipes que desejam um runtime gerenciado sem sobrecarga de infraestrutura.

Agentes hospedados (versão prévia)

Hosted agents são agentes baseados em código que você cria com Agent FrameworkLangGraph, o SDK OpenAI Agents, o SDK do agente Anthropic, o SDK GitHub Copilot, ou seu próprio código. Envie seu agente como uma imagem de contêiner ou um arquivo ZIP com seu código-fonte — a Foundry cria a imagem para você quando você fornece um arquivo ZIP — e a Foundry o executa com um endpoint gerenciado, escalabilidade automática, uma identidade dedicada do Microsoft Entra, persistência de estado no nível da sessão e observabilidade de ponta a ponta.

Nos bastidores, o código do seu agente chama a API Responses no endpoint do projeto Foundry para inferência de modelos e orquestração de ferramentas, dando a você acesso aos modelos do Foundry no catálogo e a um conjunto unificado de ferramentas da plataforma — ferramentas padrão da OpenAI, como pesquisa de arquivos, interpretador de código e pesquisa na web, além de ferramentas exclusivas do Foundry, como SharePoint, WorkIQ e Fabric IQ.

Melhor para: agentes que fazem chamadas ao seu próprio código personalizado; secundariamente, lógica de orquestração personalizada, sistemas multiagente e protocolos personalizados (webhooks, voz, AG-UI) nos quais você deseja ter controle total sobre a lógica do agente, enquanto o Foundry cuida da hospedagem, do dimensionamento e da identidade.

Se preferir continuar executando o código do agente fora do Foundry , por exemplo, inserido em um aplicativo existente, você ainda poderá obter modelos do Foundry e ferramentas de plataforma chamando a API de Respostas diretamente do seu processo. Veja Como usar a API Responses no seu próprio código.

Comparar tipos de agente

Usar a API de Respostas do seu próprio código

A API de Respostas é o único modelo e ponto de extremidade de ferramentas por trás de cada tipo de agente. Você pode chamá-lo diretamente do seu próprio código para obter modelos do Foundry e ferramentas de plataforma sem criar um recurso de agente no Foundry. Esse padrão é aditivo para agentes hospedados, não uma alternativa – o mesmo código do Agent Framework pode chamar a API de Respostas do seu próprio processo hoje e ser empacotado como um agente hospedado em contêiner mais tarde quando você quiser um ponto de extremidade gerenciado pelo Foundry.

Consulte Guia de início rápido: Use a API Responses para ver as opções de endpoint e exemplos completos.

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 do Functions (/runtime/webhooks/mcp) para expor ferramentas personalizadas aos seus agentes.

As opções de autenticação com suporte para servidores MCP e outras conexões de ferramenta 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

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.

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 — Defina um agente com prompt no portal ou com o SDK, ou crie um agente hospedado que chama a API Responses.
2. Testar — Converse com seu agente no ambiente de testes 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 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. Otimizar – aprimore automaticamente as instruções do agente hospedado usando o otimizador do agente.
6. Publicar – Promova seu agente a um recurso gerenciado com um endpoint estável.
7. 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 privada está disponível para agentes de prompt. 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 em seu agente, as versões são automaticamente capturadas. Reverta para qualquer versão anterior ou compare as alterações entre as versões.
• Publicação — Promova um agente para 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 Serviço de Agente do Foundry dá suporte aos Protocolos OpenResponses e Activity para a publicação no Microsoft 365, ao Protocolo Invocations para a integração flexível de ponto de extremidade com aplicativos e serviços personalizados e ao Protocolo A2A (versão prévia) para a comunicação entre agentes.

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: use proteções integradas para ajudar a minimizar saídas não seguras e mitigar os riscos de injeção de solicitação, incluindo ataques de injeção de solicitação cruzada (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.

Conteúdo relacionado

• Configurar seu ambiente
• Ciclo de vida de desenvolvimento do agente
• Implantar seu primeiro agente hospedado
• Catálogo de ferramentas
• Cotas, limites e suporte regional
• Para obter ajuda ou se conectar com a comunidade, participe do Microsoft AI Discord.