Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O Agent Framework oferece duas categorias primárias de funcionalidades:
| DESCRIÇÃO | |
|---|---|
| Agentes | Agentes individuais que usam LLMs para processar entradas, chamar ferramentas e se conectar a servidores MCP, gerando respostas. Dá suporte a Microsoft Foundry, Antropic, Azure OpenAI, OpenAI, Ollama e more. |
| Fluxos de Trabalho | Fluxos de trabalho baseados em grafo que conectam agentes e funções para tarefas de várias etapas com roteamento seguro de tipo, ponto de verificação e suporte humano no loop. |
A estrutura também fornece blocos de construção fundamentais, incluindo clientes de modelo (conclusões e respostas de chat), uma sessão de agente para gerenciamento de estado, provedores de contexto para memória do agente, middleware para interceptar ações do agente e clientes MCP para integração de ferramentas. Juntos, esses componentes oferecem flexibilidade e poder para criar aplicativos de IA interativos, robustos e seguros.
Introdução
dotnet add package Microsoft.Agents.AI.Foundry --prerelease
using System;
using Azure.AI.Projects;
using Azure.Identity;
using Microsoft.Agents.AI;
AIAgent agent = new AIProjectClient(
new Uri("https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project"),
new AzureCliCredential())
.AsAIAgent(
model: "gpt-5.4-mini",
instructions: "You are a friendly assistant. Keep your answers brief.");
Console.WriteLine(await agent.RunAsync("What is the largest city in France?"));
pip install agent-framework
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential
credential = AzureCliCredential()
client = FoundryChatClient(
project_endpoint="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project",
model="gpt-5.4-mini",
credential=credential,
)
agent = client.as_agent(
name="HelloAgent",
instructions="You are a friendly assistant. Keep your answers brief.",
)
# Non-streaming: get the complete response at once
result = await agent.run("What is the largest city in France?")
print(f"Agent: {result}")
É isso : um agente que chama uma LLM e retorna uma resposta. A partir daqui, você pode adicionar ferramentas, conversas de múltiplos turnos, middleware e fluxos de trabalho para criar aplicações de produção.
Observação
O Agent Framework não carrega .env arquivos automaticamente. Para usar um .env arquivo, chame load_dotenv() no início do aplicativo ou defina variáveis de ambiente diretamente em seu shell ou IDE.
Quando usar agentes versus fluxos de trabalho
| Use um agente quando... | Use um fluxo de trabalho quando... |
|---|---|
| A tarefa é aberta e conversacional. | O processo tem etapas bem definidas |
| Você precisa de uso e planejamento de ferramentas autônomas | Você precisa de controle explícito sobre a ordem de execução |
| Uma única chamada LLM (possivelmente com ferramentas) é suficiente. | Vários agentes ou funções devem ser coordenadas |
Se você puder escrever uma função para lidar com a tarefa, faça isso em vez de usar um agente de IA.
Por que o Agent Framework?
O Agent Framework combina abstrações de agente simples da AutoGen com os recursos corporativos da Kernel semântico — gerenciamento de estado baseado em sessão, segurança de tipo, middleware, telemetria — e adiciona fluxos de trabalho baseados em grafo para orquestração explícita de vários agentes.
Kernel semântico e AutoGen foi pioneiro nos conceitos de agentes de IA e orquestração multi-agente. O Agent Framework é o sucessor direto, criado pelas mesmas equipes. Ele combina as abstrações simples da AutoGen para padrões de agente único e múltiplo com os recursos de nível empresarial da Kernel semântico, como gerenciamento de estado baseado em sessão, segurança de tipo, filtros, telemetria e amplo suporte a modelos e inserção. Além de mesclar os dois, o Agent Framework apresenta fluxos de trabalho que dão aos desenvolvedores controle explícito sobre caminhos de execução de vários agentes, além de um sistema de gerenciamento de estado robusto para cenários de longa execução e humanos no loop. Em suma, o Agent Framework é a próxima geração de Kernel semântico e AutoGen.
Para saber mais sobre como migrar do Kernel semântico ou do AutoGen, consulte o Guia de Migração de Kernel semântico e o Guia de Migração de AutoGen.
Tanto o Kernel semântico quanto o AutoGen se beneficiaram significativamente da comunidade de software livre e o mesmo é esperado para o Agent Framework. Microsoft Agent Framework recebe contribuições e continuará melhorando com novos recursos e capacidades.
Importante
Se você usar Microsoft Agent Framework para criar aplicativos que operam com servidores, agentes, código ou modelos diretos não Azure de terceiros ("Sistemas de Terceiros"), você o fará por sua conta e risco. Sistemas de terceiros são produtos não Microsoft sob os Termos do Produto Microsoft e são regidos por seus próprios termos de licença de terceiros. Você é responsável por qualquer uso e custos associados.
Recomendamos revisar todos os dados compartilhados e recebidos de sistemas de terceiros e estar ciente das práticas de terceiros para manipulação, compartilhamento, retenção e localização de dados. É sua responsabilidade gerenciar se seus dados fluirão fora dos limites de conformidade e geográficos do Azure da sua organização e quaisquer implicações relacionadas, e garantir que as permissões, limites e aprovações apropriados sejam estabelecidos.
Você é responsável por examinar e testar cuidadosamente os aplicativos que cria usando Microsoft Agent Framework no contexto de seus casos de uso específicos e tomar todas as decisões e personalizações apropriadas. ** Isso inclui implementar suas próprias mitigações de IA responsáveis, como metaprompt, filtros de conteúdo ou outros sistemas de segurança, e garantir que seus aplicativos atendam aos padrões apropriados de qualidade, confiabilidade, segurança e fidelidade. Veja também: Perguntas frequentes sobre transparência
Próximas etapas
Vá mais fundo:
- Visão geral dos agentes – arquitetura, provedores, ferramentas
- Visão geral dos fluxos de trabalho — sequencial, simultânea, ramificação
- Integrations — A2A, AG-UI, Azure Functions, M365