O que é o Microsoft Foundry Agent Service?

O Foundry Agent Service é uma plataforma gerida para construir, implementar e escalar agentes de IA. Use qualquer framework, qualquer modelo suportado do catálogo de modelos Foundry e a API Responses como ponto de entrada único.

Escolhe quanto da plataforma quer:

• Agentes de prompts — cria um agente de prompt no portal Foundry ou define-o com SDKs e REST, e o Foundry executa-o por ti. Sem código de aplicação para manter, sem computação para pagar, e sem contentores ou pacotes para otimizar, escalar ou corrigir.
• Hosted agents — escreva o seu código de agente com Agent Framework, LangGraph, o OpenAI Agents SDK, o Anthropic Agent SDK, o GitHub Copilot SDK ou o seu próprio código, acondicione-o como um contentor e deixe o Foundry executá-lo com um endpoint gerido, escalabilidade, identidade e observabilidade.

Já tens código de agente a correr fora do Foundry? Chame a Responses API a partir do seu processo existente para obter modelos Foundry e ferramentas da plataforma sem ter de mover o seu código.

O que é um agente?

Um agente é uma aplicação de IA que utiliza um modelo do catálogo de modelos Foundry para raciocinar sobre pedidos dos utilizadores e tomar ações autónomas para os satisfazer. Ao contrário de um chatbot simples que apenas gera texto, um agente pode ligar a ferramentas, aceder a dados externos e tomar decisões ao longo de várias etapas para completar uma tarefa. Em alguns casos, os agentes atuam sem interface de chat — trabalhando autonomamente em segundo plano, desencadeados por eventos do sistema, para realizar tarefas em nome de um utilizador ou organização.

Cada agente combina três componentes principais:

• Modelo: Um modelo do catálogo de modelos Foundry que fornece capacidades de raciocínio e linguagem.
• Instruções: Defina objetivos, restrições e comportamento. No Foundry, as instruções podem ser baseadas em prompts ou codificadas num agente Alojado.
• Ferramentas: Fornecem acesso a dados ou ações, como pesquisa, operações de ficheiros ou chamadas de API.

Serviço de Agentes em Resumo

Comece a trabalhar com os agentes

Escolha o seu caminho com base no que pretende fazer:

• Novo no mundo dos agentes?Comece com um agente de prompts — crie um agente no portal Foundry, escolha um modelo, anexe ferramentas e depois chame-o a partir do código. Não há código de execução para escrever ou manter — a Foundry executa o agente por si.
• Quer construir um agente baseado em código no Foundry?Implemente um agente alojado — escreva o seu agente com Agent Framework, LangGraph, o SDK OpenAI Agents ou o seu próprio código, empacote-o como um contentor e deixe a Foundry executá-lo com um endpoint gerido, escalabilidade e identidade.
• Queres usar modelos e ferramentas do Foundry a partir de código de agente que já executas noutro lado?Ligue à API Responses do seu processo existente para obter modelos Foundry e ferramentas de plataforma sem mover o seu código.

Tipos de agentes

Existem dois tipos principais de agentes no Serviço de Agentes:

• Agentes de prompt — criação no portal ou em código, ambiente de execução totalmente gerido.
• Agentes alojados (pré-visualização) — o código do seu agente, executado pela Foundry.

Agentes de prompt

Os agentes de prompt são definidos inteiramente através da configuração — instruções, seleção de modelos e ferramentas. Pode criá-los no portal Foundry para começar rapidamente, ou defini-los programaticamente com os SDKs ou a API REST para os integrar nos seus fluxos de trabalho de CI/CD. De qualquer forma, o Foundry executa o agente por si — não há código de aplicação para manter, nem computação para pagar, nem contentores ou pacotes para otimizar, escalar ou monitorizar a segurança.

Dois caminhos para começar:

• Portal primeiro — cria um agente de forma interativa no portal Foundry, testa-o no playground e depois chama-o a partir do código da tua aplicação.
• Abordagem centrada no código — defina o agente com o SDK ou a API REST no seu pipeline de implementação, permitindo controlo de versão, revisão de código e distribuição automatizada.

Ideal para: Começar rapidamente, ferramentas internas, agentes de produção que não precisam de lógica de orquestração personalizada, e equipas que querem um runtime gerido sem sobrecarga de infraestrutura.

Agentes alojados (pré-visualização)

Agentes alojados são agentes baseados em código que cria com Agent Framework, LangGraph, o OpenAI Agents SDK, o Anthropic Agent SDK, o GitHub Copilot SDK ou com o seu próprio código. Implemente o seu agente como uma imagem de contentor ou um ficheiro ZIP do seu código-fonte — a Foundry cria a imagem para si quando fornece um ficheiro ZIP — e a Foundry executa-o com um endpoint gerido, escalonamento automático, uma identidade Microsoft Entra dedicada, persistência do estado ao nível da sessão e observabilidade de ponta a ponta.

Por baixo, o código do seu agente chama a API Responses no endpoint do seu projeto Foundry para inferência de modelos e orquestração de ferramentas, o que lhe dá acesso a modelos Foundry do catálogo e a um conjunto unificado de ferramentas de plataforma — ferramentas padrão OpenAI como pesquisa de ficheiros, interpretador de código e pesquisa web, além de ferramentas exclusivas Foundry como SharePoint, WorkIQ e Fabric IQ.

Ideal para: Agentes que ligam para o seu próprio código personalizado; em segundo lugar, lógica de orquestração personalizada, sistemas multi-agente e protocolos personalizados (webhooks, voz, AG-UI), onde se quer controlo total sobre a lógica do agente, deixando a Foundry tratar do alojamento, escalabilidade e identidade.

Se preferir continuar a executar o seu código de agente fora do Foundry — por exemplo, embutido numa aplicação existente — ainda pode obter os modelos e ferramentas da plataforma do Foundry ao chamar diretamente a API do Answers a partir do seu processo. Consulte Utilize a API Responses a partir do seu próprio código.

Compare os tipos de agentes

Utilize a Responses API no seu próprio código

A API Responses é o único modelo e endpoint de ferramentas por trás de cada tipo de agente. Podes chamá-lo diretamente do teu próprio código para obter modelos Foundry e ferramentas de plataforma sem criar um recurso de agente no Foundry. Este padrão é aditivo aos agentes alojados, não uma alternativa — o mesmo código do Agent Framework pode chamar a API de Respostas a partir do seu próprio processo hoje e ser empacotado como agente hospedado em contentor mais tarde quando quiser um endpoint gerido pela Foundry.

Consulte Quickstart: Use the Responses API para ver as opções do endpoint e exemplos completos.

Suporte a modelos

O Serviço de Agentes trabalha com muitos modelos disponíveis no catálogo de modelos da Foundry. Para a lista completa, consulte Cotas, limites e apoio regional.

Ferramentas

A Agent Service disponibiliza ferramentas integradas e suporta ferramentas personalizadas para que os seus agentes possam agir e aceder a dados. Para uma lista completa, consulte o catálogo de ferramentas Foundry. Para padrões avançados de seleção de ferramentas, consulte Melhores práticas de ferramentas.

O Foundry suporta servidores MCP remotos que pode adicionar a partir do catálogo Add Tools no portal Foundry. Por exemplo, o Azure DevOps MCP Server (pré-visualização pública) pode ser adicionado diretamente a partir do catálogo. Ligue a sua organização Azure DevOps para permitir o acesso dos agentes e configure um subconjunto de ferramentas disponíveis para controlar quais as ações que os agentes podem realizar. Também pode ligar servidores MCP personalizados alojados em Funções do Azure usando o endpoint webhook Functions MCP (/runtime/webhooks/mcp) para expor ferramentas personalizadas aos seus agentes.

As opções de autenticação suportadas para servidores MCP e outras ligações de ferramentas incluem:

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

Toolbox (pré-visualização)

O Toolbox permite-lhe definir um conjunto selecionado de ferramentas uma vez, geri-las centralmente no Foundry e expô-las através de um único endpoint compatível com MCP. Qualquer runtime ou cliente de agente compatível com MCP pode consumir uma caixa de ferramentas, independentemente do framework que utilize. O versionamento do toolbox dá-te controlo explícito sobre quando as alterações entram em vigor — cria uma nova versão, testa-a e promove-a para o padrão quando estiveres pronto.

Ciclo de vida do desenvolvimento

O Agent Service suporta o fluxo completo de trabalho de compilação-teste-implementação-monitor:

1. Criar — Defina um agente de prompt no portal ou com o SDK, ou escreva um agente alojado que chame a API de Respostas.
2. Teste — Fale com o seu agente no ambiente de testes para agentes ou execute localmente. Integrações com servidores MCP, incluindo servidores MCP personalizados alojados no Funções do Azure, podem ser exercidas diretamente no playground para validar a conectividade, permissões e comportamento da ferramenta antes da publicação.
3. Rastreio — Inspecione cada chamada de modelo, invocação de ferramenta e decisão com rastreio de agentes.
4. Avaliar — Realizar avaliações para medir a qualidade e detetar regressões.
5. Otimizar — Melhore automaticamente as instruções do seu agente hospedado usando o otimizador de agentes.
6. Publicar — Promova o seu agente para um recurso gerenciado com um endpoint estável.
7. Monitorizar — Acompanhar o desempenho e a fiabilidade com métricas de serviço e painéis.

Para uma guia detalhada, consulte o ciclo de vida do desenvolvimento do Agente.

Capacidades empresariais

A Agent Service fornece infraestrutura de nível empresarial para cada agente que implementa:

• Identidade do agente — Cada agente pode ter uma identidade Microsoft Entra dedicada, permitindo acesso seguro e com âmbito a recursos e APIs sem partilhar credenciais. As identidades dos agentes podem autenticar-se em servidores MCP externos, incluindo aqueles alojados em Funções do Azure, e o passthrough OAuth On-Behalf-Of (OBO) é suportado quando configurado.
• Rede privada — Execute agentes dentro da sua rede virtual Azure para isolamento total da rede e conformidade com os requisitos de residência de dados. Está disponível networking privado para agentes prontos. Os agentes alojados suportam o bring-your-own Rede Virtual do Azure (BYO VNet), onde cada sessão corre num sandbox isolado por VM ligado ao seu VNet.
• Controlo de acesso baseado em funções — Permissões detalhadas através de Microsoft Entra e Azure RBAC. Controlar quem pode criar, invocar e gerir agentes.
• Segurança de conteúdo — Filtros de conteúdo integrados ajudam a mitigar riscos de injeção de prompts (incluindo injeção cruzada) e a prevenir saídas inseguras.

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

Publicação e partilha

A Agent Service oferece versionamento e publicação integrados para que os seus agentes possam passar do desenvolvimento para a produção com confiança.

• Versionamento — À medida que fazes iterações sobre o teu agente, as versões são automaticamente registadas. Voltar a qualquer versão anterior ou comparar as alterações entre versões.
• Publicação — Promover um agente a um recurso gerido com um ponto final estável. Os agentes publicados herdam a identidade empresarial e os controlos de acesso configurados para o seu projeto e podem ser invocados programaticamente.
• Distribution — Partilhe agentes publicados através do Microsoft 365 Copilot e Teams e do Entra Agent Registry, colocando os seus agentes onde os utilizadores já trabalham. O Foundry Agent Service suporta os protocolos OpenResponses e Activity para publicação no Microsoft 365, um protocolo Invocations para integração flexível de endpoints com aplicações e serviços personalizados, e o protocolo A2A (pré-visualização) para comunicação entre agentes.

Segurança, privacidade e conformidade

O Agent Service foi concebido para cargas de trabalho empresariais onde precisa de controlos sólidos sobre identidade, redes, gestão de dados e segurança.

• Controlos de segurança: Utilize guardas integradas para ajudar a reduzir saídas inseguras e mitigar riscos de injeção rápida, incluindo ataques de injeção cruzada (XPIA).
• Isolamento de rede e controlos de residência de dados: Utilize redes virtuais e recursos próprios para satisfazer as suas necessidades.
• Traga os seus próprios recursos: Use os seus próprios recursos de Azure (por exemplo, armazenamento, Pesquisa de IA do Azure e Azure Cosmos DB para o estado de conversa) para satisfazer necessidades de conformidade e operacionais. Veja Use os seus próprios recursos.
• Orientação de IA Responsável: Para um conjunto mais amplo de recomendações e recursos de governação, consulte IA Responsável para Microsoft Foundry.

Conteúdo relacionado

• Configura o teu ambiente
• Ciclo de vida do desenvolvimento do agente
• Implemente o seu primeiro agente hospedado
• Catálogo de ferramentas
• Quotas, limites e apoio regional
• Para ajuda ou para te ligares à comunidade, junta-te ao Discord Microsoft IA.