🤖 Microsoft Agent Framework: primeiros passos com agentes de IA
📌 Pra que serve
Microsoft Agent Framework (MAF) é o sucessor oficial do AutoGen e Semantic Kernel: um framework open source para construir agentes de IA e workflows multi-agente em .NET, Python e Go. Use quando precisar de agentes que tomem decisões autonomamente, chamem ferramentas/APIs, trabalhem juntos em tarefas complexas — sem ficar preso ao AutoGen (que parou de receber atualizações).
🛠️ Passo a passo
1. Instale o pacote base
pip install agent-frameworkPython 3.11+ obrigatório.
2. Configure sua chave de API
Escolha seu modelo (Claude, OpenAI, Azure OpenAI, Gemini, Bedrock…):
export ANTHROPIC_API_KEY="sua-chave-aqui"3. Primeiro agente (exemplo com Claude)
from agent_framework import Agent, AgentSession
from agent_framework.clients import AnthropicChatClientCriar cliente
client = AnthropicChatClient(
model="claude-opus-5-5",
)Criar agente
agent = Agent(
name="AgenteDemo",
description="Ajuda com tarefas",
model_client=client,
)Executar com histórico
session = AgentSession()
response = agent.invoke(
input="Me explique o que é um agente de IA em 2 linhas",
session=session
)print(response.messages[-1].content)
4. Agora com ferramentas
Defina uma função que o agente possa chamar:
from agent_framework import Agent
import jsondef buscar_temperatura(cidade: str) -> str:
"""Fictício: retorna temp de uma cidade"""
temps = {"São Paulo": "28°C", "Rio": "30°C"}
return json.dumps(temps.get(cidade, "Desconhecida"))
Registre a ferramenta
agent.tools.register(buscar_temperatura)Agora o agente pode chamar:
response = agent.invoke(
input="Qual a temperatura em São Paulo?",
session=session
)5. Workflows: coordenar múltiplos agentes
Para tarefas bem-definidas com vários agentes:
from agent_framework.orchestration import Sequentialworkflow = Sequ
ential([
agent_pesquisa, # Agente 1
agent_resumo, # Agente 2
agent_revisor, # Agente 3
])
resultado = workflow.run(input="Pesquise sobre IA generativa")
💡 Dica: Comece com um agente simples, sem ferramentas. Depois adicione funções/APIs que ele precisa chamar. Para debug local, use DevUI (python -m agent_framework.devui).
🔗 Links e instalação
- GitHub oficial: https://github.com/microsoft/agent-framework
- Docs Microsoft Learn: https://learn.microsoft.com/en-us/microsoft-agents/
- Primeiros passos: https://github.com/microsoft/agent-framework/tree/main/python/samples
- Guia de segurança: https://learn.microsoft.com/en-us/microsoft-agents/security
Instale agora:
pip install agent-framework
pip install agent-framework-lab # (opcional: módulos experimentais)Suporte oficial, sem paywall, sem AutoGen parado. Está aí pra usar.