Pular para o conteúdo principal

Os 15 principais frameworks Python para criar aplicações completas de IA agentic

Compare ferramentas de uso geral, SDKs oficiais, orquestração multiagente, soluções de dados e RAG e opções leves com modelos abertos para construir aplicações de IA agentic.
Atualizado 31 de ago. de 2026  · 11 min lido

Explorar com IA

ChatGPTClaudePerplexity

Criar aplicações de IA agentic hoje é muito mais simples do que há alguns anos. Em vez de programar do zero loops de agente, integrações de ferramentas, memória, busca e orquestração, os desenvolvedores podem usar frameworks em Python que já trazem a maior parte desses componentes prontos.

Usei muitos dos frameworks deste artigo para construir aplicações de RAG, agentes autônomos, sistemas multiagentes e ferramentas de IA prontas para deploy.

Costumo usar LangChain para fluxos de trabalho flexíveis com agentes, LlamaIndex e Haystack para apps conectados a dados, e o OpenAI Agents SDK ou Google ADK quando quero integrar mais rápido com os modelos do provedor.

Alguns desses frameworks evoluíram tanto que muitas vezes não é necessário criar uma solução sob medida. Com uma chave de API, alguns créditos de modelo e o framework certo, você cria um agente, conecta a ferramentas ou dados privados, testa e faz o deploy via API ou interface.

Este artigo compara 15 frameworks Python em cinco categorias: frameworks de agentes de uso geral, SDKs oficiais de agentes, frameworks de orquestração multiagente, frameworks de dados e RAG, e frameworks leves para modelos abertos.

Cada seção também inclui um exemplo curto em Python que você pode copiar, colar e testar para entender rapidamente como o framework funciona.

Frameworks de agentes de uso geral

Esses frameworks oferecem blocos de construção amplos para criar agentes, conectar ferramentas, gerenciar estado e controlar fluxos de trabalho em várias etapas.

1. LangChain

Para muitos desenvolvedores, o desenvolvimento moderno de apps com LLM começou com o LangChain, um framework open source em Python pensado para conectar modelos de linguagem a dados externos, ferramentas, APIs e lógica de aplicação. Ele se tornou um dos primeiros frameworks amplamente adotados para usar a API da OpenAI com sites, documentos, bases vetoriais e outras fontes de dados, criando aplicações mais contextuais.

Hoje, o LangChain evoluiu para um ecossistema completo para construir aplicações de IA agentic de ponta a ponta, incluindo sistemas de RAG, agentes que usam ferramentas, workflows, integrações, monitoramento e avaliação. Recomendo conferir a trilha de aprendizado AI Engineering with LangChain para saber mais.

O exemplo a seguir cria um agente simples no LangChain que usa uma ferramenta de busca em documentação para encontrar informações relevantes antes de responder.

# pip install -U langchain "langchain[openai]"

from langchain.agents import create_agent

def search_docs(query: str) -> str:
    """Search the company documentation."""
    return f"Documentation found for: {query}"

agent = create_agent(
    model="openai:gpt-5.5",
    tools=[search_docs],
    system_prompt="Use the documentation tool when needed.",
)

result = agent.invoke({
    "messages": [{
        "role": "user",
        "content": "What is our remote-work policy?"
    }]
})

print(result["messages"][-1].content)

2. LangGraph

Enquanto o LangChain facilita criar agentes e ferramentas, o LangGraph dá mais controle sobre como esses agentes operam. Ele permite estruturar a aplicação como um grafo de etapas conectadas, o que facilita controlar loops, chamadas de ferramentas, estado compartilhado, aprovações humanas e fluxos multiagentes.

Acho especialmente útil para criar agentes autônomos que precisam decidir repetidamente o que fazer, selecionar a ferramenta certa, checar o resultado e continuar até concluir a tarefa. O LangGraph também oferece persistência, streaming, checkpoints e recuperação para aplicações de execução prolongada. Nosso tutorial de LangGraph traz mais detalhes.

O exemplo abaixo cria um agente que pode chamar ferramentas de calculadora repetidamente até ter informações suficientes para responder:

# pip install -U langgraph langchain langchain-openai

from langchain.chat_models import init_chat_model
from langchain.tools import tool
from langgraph.graph import MessagesState, StateGraph, START
from langgraph.prebuilt import ToolNode, tools_condition

model = init_chat_model("openai:gpt-5.5", temperature=0)

@tool
def add(a: int, b: int) -> int:
    """Add two numbers."""
    return a + b

@tool
def multiply(a: int, b: int) -> int:
    """Multiply two numbers."""
    return a * b

tools = [add, multiply]
model_with_tools = model.bind_tools(tools)

def call_model(state: MessagesState):
    response = model_with_tools.invoke(state["messages"])
    return {"messages": [response]}

builder = StateGraph(MessagesState)
builder.add_node("agent", call_model)
builder.add_node("tools", ToolNode(tools))

builder.add_edge(START, "agent")
builder.add_conditional_edges("agent", tools_condition)
builder.add_edge("tools", "agent")

agent = builder.compile()

result = agent.invoke({
    "messages": [{
        "role": "user",
        "content": "Add 12 and 8, then multiply the result by 3."
    }]
})

print(result["messages"][-1].content)

O grafo envia a solicitação para o modelo, executa as ferramentas necessárias e volta ao modelo até produzir a resposta final.

3. Agno

Agno é um framework em Python para construir agentes, times multiagentes e workflows estruturados. Ele também inclui o AgentOS, que ajuda a expor agentes via APIs, armazenar sessões e trilhas, e gerenciá-los como aplicações em produção. Como pode rodar na sua própria infraestrutura, as organizações mantêm maior controle sobre dados e segurança.

O exemplo a seguir cria um agente de pesquisa que pode buscar na web antes de produzir uma resposta objetiva.

# pip install -U agno ddgs openai

from agno.agent import Agent
from agno.models.openai import OpenAIResponses
from agno.tools.duckduckgo import DuckDuckGoTools

agent = Agent(
    name="AI Research Assistant",
    model=OpenAIResponses(id="gpt-5.5"),
    tools=[DuckDuckGoTools()],
    instructions="Search when needed and keep the answer concise.",
)

agent.print_response(
    "Find one recent development in open-source AI and summarize it.",
    stream=True,
)

O agente usa a ferramenta de busca para encontrar informações atuais e transmite um resumo curto para o usuário.

4. Pydantic AI

Pydantic AI é um framework Python-nativo da equipe do Pydantic para criar agentes e aplicações de IA generativa. A experiência lembra trabalhar com modelos Pydantic ou FastAPI, pois agentes, ferramentas, dependências e saídas são definidos com funções Python padrão, type hints, decoradores e classes BaseModel. Depois, o framework usa validação do Pydantic para manter argumentos de ferramentas e saídas do modelo estruturados e confiáveis.

Recomendo o tutorial de Pydantic AI para saber mais sobre o framework.

O exemplo abaixo cria um agente que retorna um plano de artigo validado como um modelo Pydantic.

# pip install -U pydantic-ai

from pydantic import BaseModel, Field
from pydantic_ai import Agent


class ArticlePlan(BaseModel):
    title: str
    key_points: list[str]
    reading_time_minutes: int = Field(ge=1)


agent = Agent(
    "openai:gpt-5.6-sol",
    output_type=ArticlePlan,
    instructions="Create concise article plans for technical readers.",
)

result = agent.run_sync(
    "Create a short article plan about building AI agents in Python."
)

print(result.output)

O agente gera um objeto ArticlePlan e valida que cada campo atende ao tipo e às regras exigidas em Python antes de retornar.

SDKs oficiais de agentes

SDKs oficiais são mantidos pelos provedores de IA e geralmente oferecem a integração mais simples com seus modelos, APIs, ferramentas, sistemas de deploy e plataformas de observabilidade.

5. OpenAI Agents SDK

O OpenAI Agents SDK é um framework leve e Python-first para criar aplicações com um ou vários agentes. Ele oferece loop de agente integrado, function tools, handoffs, guardrails, sessões, aprovações humanas e tracing, sem adicionar abstrações em excesso.

Gosto muito de usar o OpenAI Agents SDK porque é simples, rápido de integrar e fácil de entender. Já construí muitas aplicações com ele sem maiores problemas. Ele também cria traces automaticamente, visíveis no OpenAI Dashboard, facilitando inspecionar respostas do modelo, chamadas de ferramentas, handoffs e todo o fluxo de execução.

O exemplo abaixo cria um agente de história que pode chamar uma função Python para recuperar um fato histórico surpreendente.

# pip install openai-agents

import asyncio
from agents import Agent, Runner, function_tool


@function_tool
def history_fun_fact() -> str:
    """Return a surprising historical fact."""
    return "The first computer programmer, Ada Lovelace, lived in the 1800s."


agent = Agent(
    name="History Assistant",
    instructions=(
        "Answer history questions clearly and briefly. "
        "Use history_fun_fact when it is helpful."
    ),
    tools=[history_fun_fact],
)


async def main():
    result = await Runner.run(
        agent,
        "Tell me something surprising about the history of computing.",
    )
    print(result.final_output)


if __name__ == "__main__":
    asyncio.run(main())

O SDK executa o agente, chama a ferramenta de história quando necessário, retorna o resultado ao modelo e produz a resposta final. Toda a execução também pode ser inspecionada no visualizador de traces.

7. Google Agent Development Kit

O Agent Development Kit do Google, ou ADK, é um framework open source para criar, avaliar e fazer deploy de agentes individuais, assistentes que usam ferramentas, workflows em grafo e sistemas multiagentes. Ele funciona especialmente bem com modelos Gemini, embora também dê suporte a outros provedores.

O ADK se tornou um dos meus frameworks favoritos porque é simples e funciona naturalmente com o Gemini.

Já o usei para criar várias aplicações sem maiores problemas. Embora eu ainda ache o OpenAI Agents SDK mais fácil de integrar e mais flexível em termos de controles e recursos embutidos, o ADK é uma ótima alternativa — especialmente competitiva para aplicações baseadas em Gemini.

O exemplo abaixo cria um assistente de eventos que pode chamar uma função Python para obter o horário de início de um evento.

# pip install google-adk

from google.adk.agents.llm_agent import Agent


def get_event_time(city: str) -> dict:
    """Return the event starting time for a city."""
    return {
        "status": "success",
        "city": city,
        "time": "6:00 PM",
    }


root_agent = Agent(
    model="gemini-flash-latest",
    name="event_assistant",
    description="Provides information about events in different cities.",
    instruction=(
        "Answer event questions clearly. "
        "Use the get_event_time tool when the starting time is requested."
    ),
    tools=[get_event_time],
)

O agente usa a função como ferramenta sempre que precisa obter o horário do evento para uma cidade específica.

8. Claude Agent SDK

O Claude Agent SDK é o framework em Python e TypeScript da Anthropic para criar agentes autônomos com o mesmo loop de agente, ferramentas e gestão de contexto que alimentam o Claude Code. É particularmente útil para agentes que precisam ler arquivos, editar código, executar comandos, conectar-se a ferramentas MCP e concluir tarefas longas.

Anthropic, OpenAI e Google integram seus modelos de perto com seus próprios frameworks de agentes, tornando rápidas a configuração de ferramentas, sessões, tracing e outros recursos avançados.

No entanto, o Claude Agent SDK é projetado especificamente para o Claude, e não para modelos open source arbitrários ou hospedados localmente. Você pode saber mais no nosso tutorial do Claude Agent SDK.

O exemplo a seguir cria um agente de código que revisa um arquivo Python, identifica bugs e os corrige automaticamente.

# pip install claude-agent-sdk

import asyncio
from claude_agent_sdk import (
    AssistantMessage,
    ClaudeAgentOptions,
    ResultMessage,
    query,
)


async def main():
    async for message in query(
        prompt="Review app.py for errors that could cause crashes and fix them.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],
            permission_mode="acceptEdits",
        ),
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)
                elif hasattr(block, "name"):
                    print(f"Tool used: {block.name}")

        elif isinstance(message, ResultMessage):
            print(f"Completed: {message.subtype}")


if __name__ == "__main__":
    asyncio.run(main())

O SDK executa o loop do agente enquanto o Claude lê o arquivo, seleciona as ferramentas necessárias, edita o código e transmite o progresso até concluir a tarefa.

Frameworks de orquestração multiagente

Frameworks multiagentes coordenam vários agentes especializados, com cada agente assumindo um papel, objetivo, conjunto de ferramentas ou etapa específica dentro de um workflow maior. 

9. CrewAI

CrewAI é um framework popular em Python para montar times multiagentes. Os desenvolvedores criam agentes com papéis, objetivos e tarefas diferentes e os combinam em uma equipe que trabalha de forma autônoma. As tarefas podem rodar de forma sequencial ou por um processo hierárquico em que um gerente coordena e delega o trabalho aos agentes mais adequados.

O exemplo em Python abaixo cria um pesquisador e um redator que colaboram para produzir um relatório curto.

# pip install crewai
# Set OPENAI_API_KEY before running

from crewai import Agent, Crew, Process, Task

researcher = Agent(
    role="AI Researcher",
    goal="Find the key facts about {topic}",
    backstory="You research technical topics carefully.",
)

writer = Agent(
    role="Technical Writer",
    goal="Turn research into a clear summary",
    backstory="You explain complex topics simply.",
)

research_task = Task(
    description="Research {topic} and identify three key findings.",
    expected_output="Three concise findings.",
    agent=researcher,
)

writing_task = Task(
    description="Write a short summary using the research findings.",
    expected_output="A clear one-paragraph report.",
    agent=writer,
    context=[research_task],
)

crew = Crew(
    agents=[researcher, writer],
    tasks=[research_task, writing_task],
    process=Process.sequential,
)

result = crew.kickoff(inputs={"topic": "agentic AI"})
print(result.raw)

O pesquisador conclui a primeira tarefa, e o redator usa sua saída como contexto para criar o relatório final.

10. MetaGPT

MetaGPT é um framework multiagente que modela uma empresa de software usando agentes especializados como product manager, arquiteto, project manager e engenheiro. Esses agentes seguem procedimentos operacionais estruturados para transformar um requisito curto em planos, designs técnicos, documentação e código funcionando. 

O exemplo abaixo cria uma equipe de software e pede para construir um gerenciador de tarefas em linha de comando.

# pip install metagpt
# Configure a supported LLM API before running

import asyncio

from metagpt.roles import (
    Architect,
    Engineer,
    ProductManager,
    ProjectManager,
)
from metagpt.team import Team


async def startup(idea: str):
    company = Team()

    company.hire([
        ProductManager(),
        Architect(),
        ProjectManager(),
        Engineer(),
    ])

    company.invest(investment=3.0)
    company.run_project(idea=idea)

    await company.run(n_round=5)


if __name__ == "__main__":
    asyncio.run(
        startup("Build a simple command-line task manager")
    )

Os agentes dividem os requisitos entre seus diferentes papéis e colaboram para planejar e desenvolver o projeto de software. 

11. AgentScope

AgentScope é um framework em Python para construir agentes controláveis e observáveis e aplicações multiagentes. Ele oferece agentes prontos, ferramentas, memória, roteamento de mensagens, streaming, chamadas de ferramentas em paralelo, workflows, tracing e intervenção humana. O AgentScope Studio também pode ser usado para inspecionar e visualizar a execução dos agentes.

O exemplo seguinte cria um agente ReAct que consegue escrever e executar código Python para concluir um cálculo.

# pip install agentscope
# Set DASHSCOPE_API_KEY before running

import asyncio
import os

from agentscope.agent import ReActAgent
from agentscope.formatter import DashScopeChatFormatter
from agentscope.memory import InMemoryMemory
from agentscope.message import Msg
from agentscope.model import DashScopeChatModel
from agentscope.tool import Toolkit, execute_python_code


async def main():
    toolkit = Toolkit()
    toolkit.register_tool_function(execute_python_code)

    agent = ReActAgent(
        name="Nova",
        sys_prompt="You are a helpful Python assistant named Nova.",
        model=DashScopeChatModel(
            model_name="qwen-max",
            api_key=os.environ["DASHSCOPE_API_KEY"],
            stream=True,
        ),
        formatter=DashScopeChatFormatter(),
        toolkit=toolkit,
        memory=InMemoryMemory(),
    )

    await agent(
        Msg(
            name="user",
            content="Use Python to calculate the sum of numbers from 1 to 100.",
            role="user",
        )
    )


if __name__ == "__main__":
    asyncio.run(main())

O agente decide chamar a ferramenta de execução em Python, roda o código gerado e usa o resultado para responder ao usuário.

12. CAMEL-AI

CAMEL-AI é um framework open source em Python para criar agentes, sociedades multiagentes e simulações de role-playing. Tem forte foco em pesquisa e oferece componentes para colaboração entre agentes, ferramentas, memória, recuperação, geração de dados e simulação de mundos. Também dá suporte a modelos na nuvem e locais por meio de plataformas como Ollama, vLLM e SGLang.

O exemplo abaixo cria um agente que pode pesquisar na web antes de responder a uma pergunta.

# pip install "camel-ai[web_tools]"
# Set OPENAI_API_KEY before running

from camel.agents import ChatAgent
from camel.models import ModelFactory
from camel.toolkits import SearchToolkit
from camel.types import ModelPlatformType, ModelType

model = ModelFactory.create(
    model_platform=ModelPlatformType.OPENAI,
    model_type=ModelType.GPT_5_5,
    model_config_dict={"temperature": 0.0},
)

agent = ChatAgent(
    system_message="You are a helpful AI research assistant.",
    model=model,
    tools=[SearchToolkit().search_duckduckgo],
)

response = agent.step(
    "What are the main uses of multi-agent AI systems?"
)

print(response.msgs[0].content)

O agente usa a busca do DuckDuckGo quando precisa de informações atuais e depois retorna a resposta final.

Frameworks de dados e RAG

Esses frameworks conectam LLMs e agentes a documentos, bancos de dados, APIs e outras fontes de dados privadas para recuperar contexto relevante antes de responder.

13. LlamaIndex

LlamaIndex é um framework em Python para criar aplicações conscientes de contexto sobre dados privados ou de domínio específico. Ele oferece conectores, índices, recuperadores, mecanismos de consulta, agentes e workflows para aplicações como RAG, busca corporativa e assistentes de documentos.

O LlamaIndex foi um dos meus frameworks favoritos quando comecei a construir aplicações de RAG. Ele torna carregar, indexar e consultar dados extremamente simples, e muitas vezes acho seu código mais direto e curto do que construir o mesmo app com LangChain. Você pode fazer o curso de LlamaIndex para aprender mais.

O exemplo a seguir carrega documentos de uma pasta, cria um índice pesquisável e responde a uma pergunta usando o contexto recuperado.

# pip install llama-index
# Set OPENAI_API_KEY before running

from llama_index.core import SimpleDirectoryReader, VectorStoreIndex

documents = SimpleDirectoryReader("data").load_data()
index = VectorStoreIndex.from_documents(documents)

query_engine = index.as_query_engine()
response = query_engine.query(
    "What are the main findings in these documents?"
)

print(response)

O LlamaIndex indexa os arquivos dentro da pasta data e recupera informações relevantes antes de gerar a resposta.

14. Haystack

Haystack é um framework open source em Python para construir pipelines de RAG prontos para produção, sistemas de busca semântica, agentes e aplicações de IA orientadas a dados. Sua estrutura modular de pipeline dá controle claro sobre como a informação é recuperada, adicionada ao prompt e enviada ao modelo.

Usei o Haystack para criar aplicações de RAG e multiagente sem grandes problemas. Embora seja um framework de uso geral, ele é especialmente útil para apps que conectam LLMs a documentos, texto, sistemas de busca e outras fontes de dados.

O exemplo abaixo armazena alguns documentos, recupera o mais relevante e o usa para responder a uma pergunta.

# pip install -U haystack-ai
# Set OPENAI_API_KEY before running

from haystack import Document, Pipeline
from haystack.components.builders import ChatPromptBuilder
from haystack.components.generators.chat import (
    OpenAIResponsesChatGenerator,
)
from haystack.components.retrievers import InMemoryBM25Retriever
from haystack.dataclasses import ChatMessage
from haystack.document_stores.in_memory import InMemoryDocumentStore

document_store = InMemoryDocumentStore()
document_store.write_documents([
    Document(content="The London AI event starts at 6:00 PM."),
    Document(content="The Berlin AI event starts at 7:00 PM."),
])

template = [
    ChatMessage.from_system(
        "Answer using the following documents:\n"
        "{% for doc in documents %}{{ doc.content }}{% endfor %}"
    ),
    ChatMessage.from_user("{{ question }}"),
]

pipeline = Pipeline()
pipeline.add_component(
    "retriever",
    InMemoryBM25Retriever(document_store),
)
pipeline.add_component(
    "prompt_builder",
    ChatPromptBuilder(template=template),
)
pipeline.add_component(
    "llm",
    OpenAIResponsesChatGenerator(model="gpt-5.5"),
)

pipeline.connect("retriever", "prompt_builder.documents")
pipeline.connect("prompt_builder", "llm")

question = "When does the London AI event start?"

result = pipeline.run({
    "retriever": {"query": question},
    "prompt_builder": {"question": question},
})

print(result["llm"]["replies"][0].text)

O Haystack recupera o documento correspondente, o adiciona ao prompt e usa o GPT-5.5 para produzir uma resposta fundamentada.

Frameworks leves e com modelos abertos

Esses frameworks oferecem abstrações mais simples para criar agentes com modelos abertos hospedados ou locais.

15. Hugging Face smolagents

Hugging Face smolagents é um framework leve em Python para criar agentes com pouca quantidade de código. O CodeAgent executa ações escrevendo Python, enquanto o ToolCallingAgent usa chamadas de ferramentas estruturadas. Ele funciona especialmente bem com modelos do Hugging Face, Inference Providers e modelos open source hospedados localmente.

O exemplo abaixo cria um agente de busca na web e o entrega a um agente gerente que decide quando delegar a pesquisa.

# pip install -U "smolagents[toolkit]"
# Set HF_TOKEN before running

from smolagents import (
    CodeAgent,
    InferenceClientModel,
    ToolCallingAgent,
    WebSearchTool,
)

model = InferenceClientModel(
    model_id="Qwen/Qwen3-Next-80B-A3B-Thinking"
)

web_agent = ToolCallingAgent(
    tools=[WebSearchTool()],
    model=model,
    name="web_search_agent",
    description="Searches the web and returns useful information.",
)

manager_agent = CodeAgent(
    tools=[],
    model=model,
    managed_agents=[web_agent],
)

result = manager_agent.run(
    "Who created Hugging Face, and when was it founded?"
)

print(result)

O gerente decide quando precisa de informações atuais, delega a busca ao agente especialista e então produz a resposta final.

Comparativo rápido entre frameworks

A tabela abaixo compara o principal ponto forte de cada framework e o tipo de aplicação de IA agentic para o qual ele é mais indicado.

Framework

Ponto forte

Escolha quando

LangChain

Grande ecossistema de integrações

Você precisa de integrações amplas, ferramentas e flexibilidade

LangGraph

Orquestração com grafo e estado

Você precisa de loops controlados, execução durável e workflows complexos

Agno

Plataforma completa de agentes

Você quer criar, auto-hospedar e gerenciar serviços de agentes

Pydantic AI

Desenvolvimento Python com tipos seguros

Você precisa de ferramentas validadas, dependências e saídas estruturadas

OpenAI Agents SDK

Desenvolvimento simples e tracing

Você usa principalmente modelos OpenAI e quer integração rápida

Google ADK

Desenvolvimento nativo para Gemini

Você usa Gemini, Google Cloud ou workflows multiagentes

Claude Agent SDK

Ferramentas para computador, arquivos e comandos

Você está criando agentes de código, pesquisa ou de longa duração com o Claude

CrewAI

Times de agentes por papel

Vários agentes especializados precisam colaborar em um projeto

MetaGPT

Simulação de empresa de software

Você quer que agentes planejem e gerem projetos de software completos

AgentScope

Agentes observáveis e controláveis

Você precisa de agentes rastreáveis ou aplicações multiagentes

CAMEL-AI

Pesquisa e simulação multiagente

Você estuda role-playing, sociedades de agentes ou grandes sistemas de agentes

LlamaIndex

Aplicações conectadas a dados e conscientes de contexto

Seus agentes precisam recuperar e raciocinar sobre documentos privados

Haystack

Pipelines de RAG modulares e transparentes

Você precisa de controle sobre recuperação, prompting e fluxo de dados

smolagents

Agentes leves com modelos abertos

Você quer mínimas abstrações, agentes que escrevem código ou suporte a modelos locais

Considerações finais

Se você está começando com IA agentic, eu começaria por um SDK oficial como o OpenAI Agents SDK, Google ADK ou Claude Agent SDK. Eles trabalham de perto com seus próprios modelos e APIs, então a configuração costuma ser simples. Você adiciona uma chave de API, carrega alguns créditos e começa a construir.

Gosto desses SDKs porque facilitam criar agentes, conectar ferramentas e inspecionar o que aconteceu durante a execução. Com poucas linhas de Python, dá para criar um agente útil ou até um pequeno sistema multiagente.

Quando preciso de mais flexibilidade, geralmente recorro ao LangChain ou LangGraph. O LangChain é útil quando preciso de muitas integrações, enquanto o LangGraph me dá mais controle de estado, loops e workflows longos.

Para times de agentes com papéis diferentes, o CrewAI é uma boa opção. Para RAG, documentos privados e apps conectados a dados, eu escolheria LlamaIndex ou Haystack.

Por fim, o smolagents é uma ótima escolha quando quero algo leve, simples e fácil de usar com modelos abertos ou locais.

Meu conselho é começar pelo framework mais simples que atenda ao seu projeto. Construa uma versão pequena, teste bem e só aumente a complexidade quando realmente precisar.

FAQs

Quanto custa rodar um agente de IA em comparação com um prompt padrão de LLM?

Embora os frameworks em Python sejam open source e gratuitos, executar agentes pode sair bem mais caro do que chamadas padrão a APIs de LLM. Como agentes operam em loops, enviando constantemente o system prompt, descrições de ferramentas, saídas anteriores de ferramentas e passos de raciocínio (como no ReAct) de volta ao modelo, o uso de tokens cresce rapidamente. Um único pedido do usuário pode disparar cinco ou seis chamadas ao LLM antes de o agente chegar à resposta final. Para controlar custos, desenvolvedores costumam usar modelos menores e mais baratos para tarefas simples de roteamento e reservar modelos maiores para raciocínio complexo.

Como avalio se meu agente está realmente funcionando bem?

Testar agentes não determinísticos exige mais do que testes unitários tradicionais. Os desenvolvedores usam frameworks especializados de avaliação com "LLM-como-juiz", como Ragas, TruLens ou DeepEval. Essas ferramentas executam seu agente contra um conjunto de perguntas de teste e pontuam as saídas em métricas específicas, como:

  • Aderência ao contexto: O agente alucinou ou a resposta se baseia apenas no contexto recuperado?
  • Precisão na escolha de ferramentas: O agente escolheu a ferramenta certa para a tarefa?
  • Relevância da resposta: A resposta final realmente atende ao pedido do usuário?

Qual a diferença entre uma pipeline de RAG padrão (LlamaIndex/Haystack) e um sistema de RAG "agentic"?

Uma pipeline de RAG padrão segue um caminho estático e rígido: recebe a consulta do usuário, busca em uma base vetorial, injeta os resultados no prompt e gera uma resposta. Executa uma vez e para. Um sistema de Agentic RAG dá autonomia ao LLM no processo de recuperação. O agente pode decidir se precisa buscar, gerar várias consultas diferentes para ampliar o contexto, avaliar se os documentos recuperados são úteis e optar por buscar de novo se a informação estiver incompleta — só então responder ao usuário.


Abid Ali Awan's photo
Author
Abid Ali Awan
LinkedIn
Twitter

Sou um cientista de dados certificado que gosta de criar aplicativos de aprendizado de máquina e escrever blogs sobre ciência de dados. No momento, estou me concentrando na criação e edição de conteúdo e no trabalho com modelos de linguagem de grande porte.

Tópicos
Inteligência Artificial
Agentes de IA
Python

Principais cursos da DataCamp

Curso

Desenvolvimento de aplicativos de LLM com LangChain

3 h
50.5K
Descubra como criar aplicativos com tecnologia de IA usando LLMs, prompts, cadeias e agentes no LangChain.
Ver detalhesRight Arrow
Iniciar Curso
Ver maisRight Arrow
Relacionado

blog

Python no setor de saúde: Aplicativos de IA em hospitais

Saiba como os aplicativos baseados em python estão transformando o setor de saúde.

Armstrong Asenavi

15 min

Tutorial

21 ferramentas essenciais do Python

Aprenda sobre as ferramentas Python essenciais para o desenvolvimento de software, raspagem e desenvolvimento da Web, análise e visualização de dados e aprendizado de máquina.
Abid Ali Awan's photo

Abid Ali Awan

6 min

Tutorial

Criando agentes LangChain para automatizar tarefas em Python

Um tutorial abrangente sobre a criação de agentes LangChain com várias ferramentas para automatizar tarefas em Python usando LLMs e modelos de bate-papo usando OpenAI.

Tutorial

Como criar aplicativos LLM com o tutorial LangChain

Explore o potencial inexplorado dos modelos de linguagem grandes com o LangChain, uma estrutura Python de código aberto para criar aplicativos avançados de IA.
Moez Ali's photo

Moez Ali

12 min

Tutorial

Tutorial da API de assistentes da OpenAI

Uma visão geral abrangente da API Assistants com nosso artigo, que oferece uma análise aprofundada de seus recursos, usos no setor, orientação de configuração e práticas recomendadas para maximizar seu potencial em vários aplicativos de negócios.
Zoumana Keita 's photo

Zoumana Keita

14 min

Tutorial

Os 6 melhores IDEs Python para ciência de dados em 2026

Encontre o IDE Python perfeito para suas necessidades de ciência de dados em 2026. Compare recursos, benefícios e desempenho para fazer uma escolha informada e segura.
Adel Nehme's photo

Adel Nehme

9 min

Ver MaisVer Mais