Principais conclusões
- Licença MIT — completamente gratuito para usar, modificar e autoalojar, sem limites de uso sobre o framework em si
- Construído pela Microsoft, convergindo seus projetos anteriores AutoGen (Microsoft Research) e Semantic Kernel (Microsoft) em uma única plataforma
- Prévia pública anunciada em 1º de outubro de 2025; o Agent Framework 1.0 alcançou disponibilidade geral em abril de 2026, com um compromisso público de APIs estáveis e suporte de longo prazo
- Compatível com Python e .NET (C#) na disponibilidade geral, com Go disponível como prévia pública
- Adiciona fluxos de trabalho baseados em grafos para orquestração multiagente explícita, algo que o AutoGen e o Semantic Kernel não ofereciam separadamente
- Funciona com o Microsoft Foundry (antigo Azure AI Foundry), Azure OpenAI, OpenAI, Anthropic, Ollama e outros provedores de modelos — não é limitado aos modelos da Microsoft
- A Microsoft afirma que continua dando suporte ao AutoGen e ao Semantic Kernel como projetos separados, mas direciona a maior parte do novo investimento e dos novos usuários ao Agent Framework
📍 Em uma frase
O Microsoft Agent Framework é um SDK gratuito, de código aberto e licenciado sob MIT para construir agentes de IA e fluxos de trabalho multiagente em Python e .NET, criado pela Microsoft como o sucessor unificado tanto do AutoGen quanto do Semantic Kernel.
💬 Em termos simples
Em vez de escolher entre o AutoGen da Microsoft, voltado à pesquisa (bom para padrões multiagente experimentais), ou o Semantic Kernel, voltado à empresa (bom para estabilidade em produção), o Microsoft Agent Framework funde os dois em um único SDK, então você obtém abstrações de agentes simples junto com gestão de estado, telemetria e segurança de tipos de nível empresarial no mesmo pacote.
📌Nota: O Microsoft Agent Framework é um SDK contra o qual você escreve código Python ou .NET, não um aplicativo para baixar — não há interface gráfica para instalar. Esta análise cobre tanto o framework de código aberto em si quanto os serviços pagos opcionais do Azure (Foundry Agent Service, Foundry Models) contra os quais ele pode rodar.
Quem criou o Microsoft Agent Framework, e por que ele existe?
A Microsoft construiu o Agent Framework para fundir seus dois projetos de agentes separados, AutoGen e Semantic Kernel, em uma única plataforma suportada — a própria documentação da Microsoft o descreve como "o sucessor direto, criado pelas mesmas equipes" por trás de ambos os predecessores. O Semantic Kernel, lançado como código aberto pela primeira vez em 2023, deu à Microsoft um SDK de nível empresarial para integrar LLMs em aplicações — gestão de estado baseada em sessões, segurança de tipos, filtros, telemetria e amplo suporte a modelos e embeddings — voltado à estabilidade em produção. O AutoGen, originado na Microsoft Research e apresentado em um artigo de pesquisa de agosto de 2023, seguiu o caminho oposto: padrões de conversação multiagente ágeis e orientados à pesquisa, priorizando a experimentação em vez da estabilidade de API a longo prazo.
No fim de 2025, a Microsoft avaliou que manter dois SDKs de agentes separados, com governanças diferentes, gerava confusão sobre qual escolher. Ela anunciou o Agent Framework em prévia pública em 1º de outubro de 2025, combinando explicitamente as abstrações de agentes simples do AutoGen com os recursos empresariais do Semantic Kernel, e adicionando fluxos de trabalho baseados em grafos para controle explícito sobre os caminhos de execução multiagente — uma capacidade que nenhum dos predecessores oferecia sozinho. O Agent Framework 1.0 alcançou disponibilidade geral em abril de 2026, o que o anúncio da Microsoft descreveu como "a versão pronta para produção: APIs estáveis e um compromisso de suporte de longo prazo". A Microsoft continuou lançando componentes adicionais depois disso — incluindo um "Agent Harness" para tarefas longas e de vários passos, com planejamento, compactação de contexto e observabilidade — que, junto com o suporte a agentes hospedados, alcançou disponibilidade geral em agosto de 2026.
Semantic Kernel se torna aberto
- Data:
- 2023
- O que significa:
- O SDK de integração de LLM de nível empresarial da Microsoft é lançado publicamente
Artigo de pesquisa do AutoGen
- Data:
- 2023-08
- O que significa:
- A Microsoft Research apresenta o framework de conversação multiagente que se tornou o AutoGen
Prévia pública do Agent Framework
- Data:
- 2025-10-01
- O que significa:
- A Microsoft anuncia a convergência de AutoGen e Semantic Kernel em um só SDK
Agent Framework 1.0 (GA)
- Data:
- 2026-04
- O que significa:
- Versão pronta para produção, com APIs estáveis e compromisso de suporte de longo prazo
Novidades da BUILD 2026
- Data:
- 2026-06
- O que significa:
- Agent Harness, conectores do GitHub Copilot SDK e do Claude Agent SDK, CodeAct em prévia
GA do Agent Harness e agentes hospedados
- Data:
- 2026-08
- O que significa:
- O harness para tarefas longas e a hospedagem gerenciada para frameworks externos alcançam disponibilidade geral
📌Nota: A própria documentação da Microsoft afirma que o AutoGen e o Semantic Kernel não estão descontinuados — ambos continuam disponíveis como projetos separados —, mas a maior parte do novo investimento em recursos e a recomendação da Microsoft para projetos novos agora vão para o Agent Framework. Veja a análise do AutoGen da PromptQuorum para conhecer o status em modo de manutenção do repositório original do AutoGen e seu fork comunitário independente, o AG2.
O que é o Microsoft Agent Framework?
O Microsoft Agent Framework é um SDK de código aberto (licença MIT, github.com/microsoft/agent-framework) para construir agentes de IA e fluxos de trabalho multiagente, disponível para Python e .NET, com Go em prévia pública. Ele oferece quatro áreas principais: agentes individuais que chamam modelos e ferramentas, um "Harness Agent" opinativo para tarefas longas de vários passos, fluxos de trabalho baseados em grafos para conectar agentes e funções por meio de caminhos de execução explícitos, e integrações com provedores de modelos, serviços de agentes e ferramentas de avaliação.
- Agentes: componentes individuais que usam um LLM para processar entradas, chamar ferramentas e servidores MCP (Model Context Protocol), e gerar respostas — com suporte a Microsoft Foundry, Anthropic, Azure OpenAI, OpenAI, Ollama e outros provedores
- Harness Agent: um agente com tudo incluído para tarefas longas de vários passos — planejamento e acompanhamento de tarefas pendentes, compactação de contexto, acesso a arquivos e memória, controle de aprovação de ferramentas, e observabilidade integrada
- Workflows: orquestração funcional e baseada em grafos que conecta vários agentes e funções por meio de caminhos de execução explícitos, para casos que precisam de mais controle do que um único agente autônomo
- Gestão de estado baseada em sessões: herdada do Semantic Kernel, dando aos agentes estado persistente entre turnos em vez de reenviar todo o histórico da conversa a cada chamada
- Suporte aos protocolos MCP e A2A: os agentes podem expor ou consumir ferramentas via Model Context Protocol e coordenar-se com outros agentes via protocolo Agent-to-Agent
- Ferramentas de migração: guias de migração oficiais a partir do AutoGen e do Semantic Kernel, incluindo ferramentas que analisam o código existente e geram um plano de migração passo a passo
Agentes vs. workflows
Orientação da própria Microsoft: use um agente quando a tarefa for aberta ou conversacional e exigir uso autônomo de ferramentas e planejamento; use um workflow quando o processo tiver passos bem definidos, exigir controle explícito sobre a ordem de execução, ou precisar que vários agentes ou funções se coordenem. Se uma função simples resolver a tarefa, a documentação da Microsoft recomenda escrever essa função em vez de recorrer a um agente.
from agent_framework import Agent
from agent_framework.foundry import FoundryChatClient
from azure.identity import AzureCliCredential
agent = Agent(
client=FoundryChatClient(
project_endpoint="https://your-foundry-service.services.ai.azure.com/api/projects/your-foundry-project",
model="your-deployed-model",
credential=AzureCliCredential(),
),
name="HelloAgent",
instructions="You are a friendly assistant. Keep your answers brief.",
)
result = await agent.run("What is the largest city in France?")
print(f"Agent: {result}")Quanto custa o Microsoft Agent Framework?
O SDK do Microsoft Agent Framework em si é gratuito sob a licença MIT — o custo vem do provedor de modelo e, opcionalmente, dos serviços do Azure aos quais você o conecta. A Microsoft não cobra para baixar, autoalojar ou rodar o framework de código aberto contra qualquer provedor de modelo suportado, incluindo provedores que não são da Microsoft, como OpenAI, Anthropic ou uma instância local do Ollama.
- Microsoft Agent Framework (o SDK): gratuito para sempre sob a licença MIT, seja autoalojado, usado comercialmente ou modificado
- Foundry Agent Service (a hospedagem de agentes gerenciada pela Microsoft no Azure): sem cobrança adicional para criar ou rodar agentes nativos do Foundry usando prompts e workflows
- Tokens de modelo: cobrados separadamente pelo Microsoft Foundry Models, independentemente de qual SDK de agentes os chama — o preço varia por modelo e muda com o tempo, então consulte a página de preços do Foundry Models ao vivo antes de planejar o orçamento, em vez de confiar em um número fixo aqui
- Conexões de ferramentas e conhecimento: cobranças separadas se aplicam a conexões como Grounding with Bing Search, Azure AI Search, Microsoft Fabric e SharePoint quando um agente as usa
- Ferramentas integradas no Foundry Agent Service: File Search Storage (1 GB grátis, depois cobrado por GB/dia), Code Interpreter (cobrado por sessão), Web Search e Custom Search (cobrado a cada 1.000 transações)
- Agentes hospedados no Foundry (rodando o Microsoft Agent Framework, LangGraph ou outros frameworks externos em contêineres gerenciados): cobrados por hora de vCPU e hora de GiB de memória, em vez de uma taxa fixa de SDK
- Autoalojar o framework totalmente fora do Azure (seus próprios servidores, ou outra nuvem) custa o que você provisionar em cômputo e uso de API de modelo — a Microsoft não exige o Azure para rodar o Agent Framework
Componente | Preço | Notas |
|---|---|---|
| SDK Agent Framework | Gratuito (licença MIT) | Sem custo para usar, modificar ou autoalojar |
| Foundry Agent Service | Sem taxa de serviço extra | Você paga só pelos tokens e ferramentas usados |
| Tokens de modelo | Varia por modelo | Cobrado pelo Foundry Models ou seu próprio provedor |
| Agentes hospedados (contêineres) | Por hora de vCPU / GiB | Para rodar o MAF na infraestrutura do Foundry |
Estrutura de preços verificada na página oficial de preços do Foundry Agent Service da Microsoft e na documentação do Agent Framework em setembro de 2026. As páginas de preços do Azure são a única fonte confiável para tarifas atuais — esta análise não repete valores específicos por token porque eles mudam independentemente do framework e são específicos de cada modelo; confira a calculadora de preços do Azure ao vivo antes de planejar o orçamento.
Como instalar e começar a usar o Microsoft Agent Framework?
Instalar o Microsoft Agent Framework exige apenas um comando pip ou dotnet — nenhuma conta do Azure é necessária para instalar o SDK em si, embora você precise de credenciais para o provedor de modelo que conectar.
- 1Instale o pacote para sua linguagem:
pip install agent-framework(Python) oudotnet add package Microsoft.Agents.AI.Foundry --prerelease(.NET); o Go está disponível viago get github.com/microsoft/agent-framework-goem prévia pública. - 2Configure as credenciais de um provedor de modelo — Microsoft Foundry, Azure OpenAI, OpenAI, Anthropic, Ollama ou outro provedor suportado. O Agent Framework não exige especificamente o Azure; tanto um modelo local do Ollama quanto uma API de nuvem que não seja da Microsoft funcionam.
- 3Crie um agente instanciando um cliente de chat para o seu provedor e passando-o, junto com um nome e instruções, para a classe
Agent(Python) ou o tipoAIAgent(.NET). - 4Chame o agente com
.run()(sem streaming, resposta completa de uma vez) ou o equivalente em streaming para saída incremental. - 5Para processos de vários passos ou vários agentes, use a API de Workflows para conectar agentes e funções por meio de um grafo explícito, em vez de depender de um único agente autônomo.
- 6Se estiver migrando um projeto existente, use o guia de migração a partir do AutoGen ou o guia de migração a partir do Semantic Kernel — a Microsoft fornece ferramentas que analisam o código existente e geram um plano de migração.
Preciso do Azure para usar o Microsoft Agent Framework?
Não. O SDK se conecta ao Microsoft Foundry, Azure OpenAI, OpenAI, Anthropic, Ollama e outros provedores, então você pode rodá-lo totalmente fora do Azure — por exemplo, contra um modelo local do Ollama ou uma API de nuvem que não seja da Microsoft — e só precisa de credenciais do Azure se escolher especificamente um modelo hospedado no Microsoft Foundry ou o Foundry Agent Service.
O Agent Framework lê automaticamente um arquivo .env para chaves de API?
Não — este é um comportamento documentado do pacote Python. Você precisa chamar load_dotenv() por conta própria no início da aplicação, ou definir as variáveis de ambiente diretamente no seu shell ou IDE, antes de instanciar um cliente.
Quem deveria usar o Microsoft Agent Framework?
O Microsoft Agent Framework é adequado para equipes que querem um único SDK suportado que cubra tanto agentes simples que usam ferramentas quanto orquestração multiagente explícita e baseada em grafos — especialmente equipes já investidas no ecossistema Microsoft ou Azure. É uma opção mais fraca para equipes sem vínculos com o ecossistema Microsoft que já são produtivas em outro framework.
Use o Microsoft Agent Framework se
- Você está começando um novo projeto de agentes no ecossistema Python ou .NET/Azure e quer suporte de API de longo prazo respaldado pela Microsoft, em vez de um projeto em modo de manutenção
- Você antes escolhia entre AutoGen e Semantic Kernel e não achava nenhum dos dois ideal sozinho — o Agent Framework funde os dois conjuntos de capacidades
- Você precisa de controle explícito baseado em grafos sobre a ordem de execução multiagente, o estado ou pontos de checagem com intervenção humana, além de agentes autônomos simples
- Você quer implantar no Microsoft Foundry com hospedagem gerenciada (Foundry Agent Service ou agentes hospedados), mas não é obrigado a isso — autoalojar em outro lugar também funciona
- Você precisa de agentes que falem MCP (Model Context Protocol) ou se coordenem com outros agentes via protocolo A2A (Agent-to-Agent)
Evite o Microsoft Agent Framework se
- Você tem uma implantação estabelecida e funcional de AutoGen ou Semantic Kernel, sem necessidade urgente de migrar — ambos continuam recebendo suporte, e migrar tem um custo real de engenharia
- Sua equipe não tem outros vínculos com o ecossistema Microsoft/Azure e já é produtiva com uma alternativa madura como o LangGraph ou o CrewAI
- Você precisa de um histórico de produção de vários anos para avaliar afirmações de estabilidade — o Agent Framework 1.0 é uma versão jovem, com um compromisso de estabilidade declarado, mas ainda sem um histórico de vários anos
- Você quer a menor pegada de dependências possível para uma única chamada de prompt e resposta, sem ferramentas, memória ou orquestração — uma chamada direta à API do modelo tem menos overhead do que qualquer framework de agentes
Quando você NÃO deveria usar o Microsoft Agent Framework?
Evite o Microsoft Agent Framework para uma única chamada de API a um modelo, sem ferramentas, memória ou orquestração de vários passos — o overhead da abstração supera o benefício. Algumas situações concretas em que outra abordagem é melhor.
- Um chatbot que apenas envia um prompt e retorna a resposta bruta — chame diretamente o SDK do provedor de modelo, em vez de adicionar uma camada de framework de agentes
- Uma aplicação existente e estável de AutoGen ou Semantic Kernel, sem um motivo específico para migrar — ambos os projetos continuam recebendo suporte da Microsoft, então migrar só para "estar na coisa mais nova" adiciona risco sem um benefício concreto
- Uma equipe totalmente comprometida com uma nuvem que não é da Microsoft e sem interesse em integração com o Azure — o LangGraph ou o CrewAI têm históricos independentes mais longos fora do ecossistema Microsoft
- Um projeto que precisa de um histórico de estabilidade de API de vários anos para reduzir o risco de uma escolha tecnológica — o Agent Framework alcançou sua versão estável 1.0 em 2026, então seu compromisso de suporte de longo prazo ainda não foi testado ao longo de anos de uso real
- Use o Microsoft Agent Framework em vez disso quando o projeto realmente precisar de suporte respaldado pela Microsoft, opções de hospedagem nativa no Azure, ou um único SDK que abranja tanto agentes simples quanto workflows multiagente explícitos
Microsoft Agent Framework vs. alternativas
O Microsoft Agent Framework compete com outros frameworks de agentes e orquestração, incluindo seus próprios dois projetos predecessores, aos quais a Microsoft continua dando suporte separadamente.
Ferramenta | Interface | Licença | Apoio | Melhor para |
|---|---|---|---|---|
| Microsoft Agent Framework | Python / .NET / Go (preview) | MIT | Microsoft | Agentes e workflows nativos do Azure |
| AutoGen | Código Python | MIT / CC-BY | Microsoft Research (modo manutenção) | Implantações existentes de AutoGen |
| LangChain | Código Python / JS | MIT | LangChain Inc. (capital de risco) | Apps e agentes LLM de propósito geral |
| LangGraph | Código Python / JS | MIT | LangChain Inc. (capital de risco) | Estado e controle de agentes baseado em grafos |
| CrewAI | Código Python | MIT | CrewAI Inc. (capital de risco) | Equipes multiagente baseadas em papéis |
Erros comuns ao avaliar o Microsoft Agent Framework
Esses erros vêm de confundir o Agent Framework com seus predecessores, ou de julgar mal o que custa rodá-lo.
Erro 1: presumir que o AutoGen ou o Semantic Kernel estão descontinuados
A própria documentação da Microsoft afirma que ambos continuam disponíveis como projetos separados e suportados — o Agent Framework converge suas capacidades em um só SDK, mas aplicações existentes de AutoGen ou Semantic Kernel não são forçadas a migrar imediatamente. Ainda assim, a maior parte do novo investimento em recursos e a recomendação da Microsoft para projetos novos agora vão para o Agent Framework.
Erro 2: presumir que a licença MIT gratuita significa que rodar agentes em produção é gratuito
O SDK não tem custo de licença, mas cada agente ainda chama um provedor de modelo que cobra por token, e complementos do Azure como conexões de ferramentas do Foundry ou cômputo de agentes hospedados são cobrados separadamente. "Framework gratuito" e "gratuito para rodar em produção" são afirmações diferentes.
Erro 3: tratar Agent Framework, AutoGen e Semantic Kernel como nomes intercambiáveis para a mesma coisa
Eles compartilham ancestralidade e, segundo a Microsoft, as mesmas equipes por trás, mas são bases de código separadas com status de governança diferentes (o Agent Framework é o sucessor em desenvolvimento ativo; o AutoGen e o Semantic Kernel continuam como projetos separados, com ritmos diferentes). Um tutorial ou pacote escrito para um deles não se aplica automaticamente a outro.
Perguntas frequentes
O Microsoft Agent Framework é gratuito para usar?
Sim. O SDK é de código aberto sob a licença MIT e gratuito para qualquer uso, incluindo produtos comerciais, sem limites de uso sobre o framework em si. Rodar agentes contra um provedor de modelo ou serviços do Azure gera custos separados, baseados no uso.
Quem criou o Microsoft Agent Framework?
A Microsoft construiu o Agent Framework, descrito em sua própria documentação como o sucessor direto do AutoGen e do Semantic Kernel, "criado pelas mesmas equipes" por trás de ambos os projetos predecessores.
Qual é a relação entre Microsoft Agent Framework, AutoGen e Semantic Kernel?
O Agent Framework converge os dois predecessores em um só SDK: combina as abstrações multiagente simples do AutoGen com a gestão de estado, a segurança de tipos e a telemetria de nível empresarial do Semantic Kernel, e adiciona fluxos de trabalho baseados em grafos que nenhum dos dois oferecia sozinho. A Microsoft afirma que nem o AutoGen nem o Semantic Kernel estão descontinuados, mas a maior parte do novo investimento agora vai para o Agent Framework.
Quando o Microsoft Agent Framework alcançou disponibilidade geral?
A Microsoft anunciou o Agent Framework em prévia pública em 1º de outubro de 2025, e o Agent Framework 1.0 alcançou disponibilidade geral em abril de 2026, descrito pela Microsoft como "a versão pronta para produção: APIs estáveis e um compromisso de suporte de longo prazo".
Qual licença o Microsoft Agent Framework usa?
MIT, confirmada diretamente no arquivo de licença do repositório microsoft/agent-framework no GitHub — uma licença de código aberto gratuita e permissiva, sem restrições para uso comercial ou autoalojado.
O Microsoft Agent Framework exige o Azure?
Não. Ele se conecta ao Microsoft Foundry, Azure OpenAI, OpenAI, Anthropic, Ollama e outros provedores de modelos, e pode rodar totalmente fora do Azure. Custos específicos do Azure só se aplicam se você escolher modelos hospedados no Azure ou o Foundry Agent Service.
Quanto custa rodar agentes no Azure AI Foundry?
Não há cobrança de serviço adicional para criar ou rodar agentes nativos do Foundry. Você paga separadamente pelos tokens de modelo (cobrados via Foundry Models), por quaisquer conexões de ferramentas ou conhecimento que um agente use e, para agentes hospedados rodando frameworks externos, por cobranças de cômputo por hora de vCPU e por hora de GiB de memória. Confira as páginas de preços ao vivo da Microsoft antes de planejar o orçamento, já que as tarifas mudam.
Devo migrar um projeto existente de AutoGen ou Semantic Kernel para o Agent Framework?
Não necessariamente de imediato — a Microsoft continua dando suporte a ambos os predecessores. Migre quando precisar das capacidades que o Agent Framework adiciona (workflows baseados em grafos, gestão de estado unificada) ou quiser o investimento principal e contínuo da Microsoft; a Microsoft fornece guias de migração e ferramentas oficiais para ambos os caminhos.
Quais linguagens o Microsoft Agent Framework suporta?
Python e .NET (C#) na disponibilidade geral, com uma implementação em Go disponível como prévia pública que ainda não inclui agentes declarativos, RAG, CodeAct ou workflows funcionais.
O Microsoft Agent Framework pode usar modelos que não são da Microsoft?
Sim. Seus provedores de modelo documentados incluem Anthropic, OpenAI e Ollama para modelos locais, além do Microsoft Foundry e do Azure OpenAI — ele não é limitado a modelos hospedados pela Microsoft.