Agentes do Microsoft Foundry

O Foundry Agent Service é uma plataforma gerida para construir, implementar e escalar agentes de IA. Crie com qualquer framework, qualquer modelo suportado do catálogo de modelos do Foundry e um único ponto de entrada para inferência de modelos e para ferramentas.

A Foundry encontra-te em qualquer ponto do espectro, desde o declarativo até ao código completo: define um agente de prompt ou um agente de prompt baseado em voz e deixa a Foundry executá-lo, empacota o teu próprio código como agente alojado, ou liga à API de Respostas a partir de um agente que já executas noutro local. Escolha como compilar abrange cada opção.

Serviço de Agentes em Resumo

Escolha como construir

O Foundry dá-lhe várias formas de criar, desde uma única chamada a um modelo até um agente totalmente contentorizado. Escolha o seu caminho com base no que pretende fazer:

• Quer o mínimo para gerir em termos de texto?Comece com um agente de prompts. Configurar instruções, um modelo e ferramentas; A Foundry corre sem código nem infraestrutura.
• Quer uma experiência de voz gerida em tempo real?Crie um agente de prompts baseado em voz. Configura a experiência de voz e liga-a através do Voice Live sem teres de hospedar o código de orquestração tu próprio.
• Quer controlo total na Foundry?Implementa um agente alojado. Utilize o seu próprio código e framework como contentor; a Foundry executa-o com um ponto final gerido, dimensionamento e identidade.
• Já executaste código de agente noutro lado?Ligue diretamente à API Responses para usar modelos e ferramentas Foundry, sem recurso de agente para gerir.

Os agentes de instruções, os agentes de instruções com base em voz e os agentes alojados são os tipos de agentes abrangidos nesta visão geral. A secção seguinte explica o valor de cada um para que possa escolher com confiança.

Tipos de agentes

O Serviço de Agentes oferece três tipos de agentes. A sua escolha define quanto constrói versus quanto a Foundry gere:

• Agentes de instruções: o caminho mais rápido. Define instruções, um modelo e ferramentas, e o Foundry executa o agente por ti sem qualquer código ou infraestrutura para gerir.
• Agentes de voz baseados em instruções: agentes de voz em tempo real geridos. Configura o modelo, as instruções, o áudio e as ferramentas, e depois liga-te ao agente através do Voice Live.
• Agentes alojados: o maior controlo. Traga o seu próprio código e framework, e o Foundry executa-o como um contentor com um endpoint gerido, escalabilidade e identidade.

Agentes de prompt

Defines os agentes de prompt inteiramente através da configuração, incluindo instruções, seleção de modelos e ferramentas. Crie-as no portal Foundry para um início rápido, ou defina-as programaticamente com os SDKs ou a API REST para integrarem com os seus fluxos de trabalho CI/CD. De qualquer forma, a Foundry gere o agente por si. Não há código de aplicação para manter, nem contentores ou pacotes para otimizar, escalar ou monitorizar a segurança.

Dois caminhos para começar:

• Portal-first: cria um agente de forma interativa no portal Foundry, testa-o no playground e depois liga-o a partir do código da tua aplicação.
• Código em primeiro lugar: defina o agente usando o SDK ou API REST no seu pipeline de implementação, permitindo controlo de versões, revisão de código e implementação automática.

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 de prompt baseados em voz

Os agentes de prompt baseados em voz são agentes geridos para conversas faladas em tempo real. Configure um modelo, instruções, definições de áudio, saudação opcional e ferramentas na definição do agente. A Foundry Agent Service gere o ciclo de vida do agente e utiliza o Voice Live para reconhecimento de voz, tomada de turnos, interação com modelos e síntese de voz.

Agentes de prompt baseados em voz suportam modelos geridos e, quando suportado, a implementação do seu próprio modelo. Liga-se ao agente através de um WebSocket em tempo real em vez de enviar pedidos de texto individuais. Para a configuração e as linguagens do cliente suportadas, veja Quickstart: Criar um agente de prompts baseado em voz. Para as arquiteturas de voz, recursos e limites atuais de pré-visualização, veja Como funcionam os agentes baseados em voz.

Ideal para: Experiências de voz direcionadas para o cliente, cenários de call center e aplicações que necessitam de interação áudio de baixa latência sem precisar de implementar o serviço de orquestração de voz por si próprio.

Agentes alojados

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. Envie o seu agente como uma imagem de contentor ou um ficheiro .zip do seu código-fonte (o Foundry constrói a imagem para si quando traz um ficheiro .zip), e o Foundry executa-o com um endpoint gerido, escalonamento automático, uma identidade Microsoft Entra dedicada, persistência de estado ao nível da sessão e observabilidade de ponta a ponta.

Nos bastidores, o código do seu agente invoca o ponto final do projeto Foundry para inferência de modelos e orquestração de ferramentas, o que lhe dá acesso aos modelos do Foundry disponíveis no catálogo e a um conjunto unificado de ferramentas da plataforma: ferramentas padrão, como pesquisa de ficheiros, interpretador de código e pesquisa na Web, além de ferramentas adicionais, 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.

Compare os tipos de agentes

Utilize a API Responses para agentes efémeros

Quando chama a API Responses diretamente a partir do seu próprio código, constrói um agente efémero: a definição do agente (instruções, ferramentas e modelo) reside no código da sua aplicação em vez de ser um recurso persistente no Foundry. Cada chamada monta o agente no seu processo e executa-o contra a API de Respostas, por isso não há agente para criar, atualizar ou eliminar no Foundry.

Usa este molde quando quiseres:

• Lógica de agente que vem com a tua aplicação. As versões de definição juntamente com o resto do teu código através do controlo de versões e revisão de código, em vez de serem um recurso separado do Foundry que alguém tem de manter sincronizado com a aplicação.
• Capacidades de fundição sem a sobrecarga de recursos. Ainda obtém modelos de catálogo, ferramentas de plataforma, dados com âmbito de projeto, autenticação On-Behalf-Of e observabilidade e governação ao nível do projeto. Tudo através do endpoint do seu projeto Foundry.

Consulte Quickstart: Use a API de Respostas para informações.

Como funcionam os agentes baseados em voz

Os agentes de instruções baseados na voz mantêm conversas por voz, em tempo real. Configura o agente no portal Foundry ou através do SDK, testa-o com um microfone e torna-o disponível através de uma experiência de navegador ou de um canal de número de telefone. A Foundry gere o ciclo de vida dos agentes e a orquestração de voz, por isso não hospedas essa infraestrutura tu próprio.

Os agentes baseados em voz suportam duas arquiteturas de modelo.

Voz para voz nativa

Caller audio
  -> realtime speech model
  -> spoken response

Esta arquitetura está otimizada para conversas naturais e de baixa latência. O modelo em tempo real trata diretamente da entrada e saída faladas. As definições suportadas e as famílias de vozes dependem do modelo selecionado.

Modelo de texto em cascata

Caller audio
  -> speech recognition
  -> text model
  -> speech synthesis
  -> spoken response

Esta arquitetura oferece uma maior variedade de opções de modelos de texto e de vozes do Azure. Também fornece controlo explícito sobre transcrição, listas de frases, deteção de turnos e respostas intermédias, mas cada etapa contribui para a latência de ponta a ponta.

Recursos essenciais

Um agente de voz típico criado por portal utiliza:

• Um recurso e projeto da Foundry.
• Um agente de prompts baseado em voz versionado.
• Um modelo Voice Live totalmente gerido, ou um modelo elegível implementado pelo cliente.
• O Azure Speech no Foundry Tools permite transcrição ou síntese quando necessário pela arquitetura selecionada.
• Application Insights para dados de rastreio, monitorização e avaliação.
• Azure Communication Services e Azure Event Grid para chamadas de entrada para extensibilidade do Teams Phone, ou uma ligação a um projeto do Twilio para canais de números de telefone do Twilio.

Não precisas de implementar um modelo de áudio separado quando usas um modelo Voice Live totalmente gerido. A disponibilidade e o comportamento dos modelos são carregados dinamicamente para o seu recurso e região.

Limites de suporte no portal atual

Disponibilidade e preços

A disponibilidade depende da região de recursos do Foundry, modelo selecionado, voz selecionada, subscrição e funcionalidades de pré-visualização ativadas. Verifique o portal antes de confiar num modelo específico.

Os custos potenciais incluem entrada e saída de modelos de IA generativa, reconhecimento e síntese de voz, treino e alojamento de voz personalizados, utilização de avatares, ingestão e retenção de Application Insights, chamadas e números de telefone do Azure Communication Services, Microsoft Teams e serviços de telefonia, e ferramentas e serviços de dados ligados. Para detalhes de custos, consulte Preços para agentes baseados em voz.

Documentação de agentes baseada em voz

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 o portal da Foundry.

Ferramentas e caixas de ferramentas

Os agentes agem sobre o mundo através de ferramentas. O Foundry oferece ferramentas integradas como pesquisa web, pesquisa de ficheiros, interpretador de código e memória, permitindo também adicionar ferramentas personalizadas através de funções, especificações OpenAPI e servidores MCP. Para o conjunto completo, consulte a visão geral da caixa de ferramentas.

Uma caixa de ferramentas agrupa essas ferramentas numa única unidade reutilizável. Seleciona e configura as ferramentas uma única vez, e o Foundry disponibiliza-as através de um endpoint gerido compatível com MCP que qualquer agente ou ambiente de execução pode consumir, independentemente da framework utilizada. As caixas de ferramentas centralizam a autenticação, governação e versionamento, por isso atualiza as ferramentas num só local em vez de reconfigurar todos os agentes. Cria uma nova versão, testa-a e promove-a para padrão quando estiveres pronto. Para saber mais, veja O que é a Toolbox na Foundry?.

Liga-te e autentica-te aos servidores remotos MCP

O Foundry suporta servidores MCP remotos que pode adicionar ao seu agente, como o Azure DevOps MCP Server. 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

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

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 Hospedado que chame a API de Respostas.
2. Teste: Converse com o seu agente no playground de 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 ferramentas 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: Transforme o seu agente num recurso gerido com um ponto final estável.
7. Monitorizar: Acompanhar o desempenho e a fiabilidade com métricas de serviço e dashboards.

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 do Microsoft Entra e Azure RBAC. Controlar quem pode criar, invocar e gerir agentes.
• Segurança de conteúdos: Filtros de conteúdo integrados ajudam a mitigar riscos de injeção rápida (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.

• Controlo de versões: À medida que vais iterando o teu agente, as versões são guardadas automaticamente. Voltar a qualquer versão anterior ou comparar as alterações entre versões.
• Publicação: Transformar um agente num recurso gerido com um endereço estável. Os agentes publicados herdam a identidade empresarial e os controlos de acesso configurados para o seu projeto e podem ser invocados programaticamente.
• Distribuição: Partilhe agentes publicados através do Microsoft Copilot, 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 para comunicação entre agentes. O A2A v1.0 está geralmente disponível, e o v0.3 permanece em pré-visualização.

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
• Visão geral do Foundry Toolbox
• Implemente o seu primeiro agente hospedado
• Crie um agente de prompts baseado em voz
• Boas práticas para agentes baseados em voz
• Catálogo de ferramentas
• Quotas, limites e apoio regional
• Para ajuda ou para te ligares à comunidade, junta-te ao Discord Microsoft IA.