🤖 Começando com Microsoft Agent Framework
📌 Pra que serve
O Agent Framework é um framework Python da Microsoft para construir agentes de IA que resolvem tarefas complexas. Você cria agentes com instruções claras, adiciona ferramentas customizadas (como consultar clima ou buscar dados), e até orquestra múltiplos agentes em paralelo. Suporta OpenAI, Azure OpenAI e Microsoft Foundry.
🛠️ Passo a passo
1. Instale o framework
pip install agent-frameworkOu, se quer apenas o core:
pip install agent-framework-core2. Configure suas chaves de API
Crie um arquivo .env na raiz do projeto:
OPENAI_API_KEY=sk-...
OPENAI_MODEL=gpt-43. Crie seu primeiro agente
import asyncio
from agent_framework import Agent
from agent_framework.openai import OpenAIChatClientasync def main():
agent = Agent(
client=OpenAIChatClient(),
instructions="Você é um assistente útil em português."
)
response = await agent.run("Me explique em 3 linhas o que é IA")
print(response)
asyncio.run(main())
4. Adicione ferramentas (tools)
def get_weather(location: str) -> str:
"""Retorna o clima de uma localização."""
return f"Clima em {location}: Ensolarado, 25°C"agent = Agent(
client=OpenAIChatClient(),
instructions="Use as ferramentas disponíveis para ajudar o usuário.",
tools=[get_weather]
)
response = await agent.run("Como está o clima em São Paulo?")
5. Orquestre múltiplos agentes
writer = Agent(client=OpenAIChatClient(), name="Escritor",
instructions="Crie textos criativos")
reviewer = Agent(client=OpenAIChatClient(), name="Revisor",
instructions="Critique e melhore textos")Step 1: Escritor gera
texto = await writer.run("Crie um título para produto de IA")Step 2: Revisor melhora
melhorado = await reviewer.run(f"Melhore: {texto}")💡 Dica: Use async with para gerenciar conexões com segurança:
async
with OpenAIChatClient() as client:
agent = Agent(client=client, instructions="...")
response = await agent.run("sua pergunta")🔗 Links e instalação
- PyPI oficial: https://pypi.org/project/agent-framework/
- Repositório GitHub: Veja em
sourcena página PyPI - Documentação: Agent Framework Documentation (link na PyPI)
- Versão atual: 1.26.0 (11 nov 2026)
- Requer: Python 3.11+
Instale agora:
pip install agent-framework