🤖 Microsoft Agent Framework: construa agentes IA em produção

📌 Pra que serve

Microsoft Agent Framework é um SDK open-source para construir agentes de IA que resolvem tarefas multi-etapas de verdade: planejar, executar, revisar, repetir. Diferente de um chatbot simples, seu agente consegue manter estado, chamar ferramentas, e até pausar pra pedir aprovação humana. Roda em Python, .NET e Go (preview), e hospeda direto no Azure ou qualquer servidor.

🛠️ Passo a passo

1. Instale o essencial

pip install agent-framework-core agent-framework-openai

2. Defina uma ferramenta que seu agente vai usar

from typing import Annotated
from agent_framework import tool@tool(approval_mode="never_require")
def get_branch_status(branch: Annotated[str, "Nome da branch Git"]) -> str:
    """Retorna status do CI da branch."""
    return f"{branch}: testes passando" if branch == "main" else f"{branch}: falhou"

3. Crie o agente com instruções claras

import asyncio
from agent_framework import Agent
from agent_framework.openai import OpenAIChatClient
async def main():
    agent = Agent(
        client=OpenAIChatClient(model="gpt-5.4-mini"),
        name="ci-helper",
        instructions="Responda dúvidas sobre CI em uma linha.",
        tools=[get_branch_status],
    )
    
    session = agent.create_session()
    response = await agent.run("Main tá verde?", session=session)
    print(response.text)asyncio.run(main())

4. Para tarefas longas (release, pesquisa), use o Harness

from agent_framework import create_harness_agentagent = create_harness_agent(
    client=OpenAIChatClient(model="gpt-5.4-mini"),
    name="release-agent",
    agent_instructions="Planeje e execute steps de release.",
    max_context_window_tokens=128_000,
)

O Harness já vem com: checklist de tarefas, planejamento vs execução, memória de sessão, aprovação de ferramentas.

💡 Dica:

Se migra de AutoGen: a repo foi arquiv
ada em setembro de 2025. MAF é o sucessor oficial — copie seus agentes seguindo [o guia de migração](https://www.developersdigest.tech/blog/microsoft-agent-framework-whats-new-2026). Se usa Semantic Kernel: rode plugins antigos como ferramentas de MAF com .as_agent_framework_tool() e migra aos poucos.

🔗 Links e instalação

Documentação oficial: [Microsoft Agent Framework](https://github.com/microsoft/agent-framework)
Artigo completo: https://www.developersdigest.tech/blog/microsoft-agent-framework-whats-new-2026
Instalar: pip install agent-framework-core agent-framework-openai
Variáveis de ambiente: Precisa de OPENAI_API_KEY (MAF suporta Azure OpenAI, Anthropic Claude, Bedrock também)
Próximo passo: Workflows com checkpointing pra pausar/retomar — leia a seção "Workflows: functional vs graph" no artigo