<\> Casa do Dev
Notícias abrir
Ferramentas abrir
Vagas abrir
Aprender abrir
Comunidade abrir
Guia de Compras abrir

Como criar um agente de ia com python: tutorial prático do zero à execução

DA

7 min

Como criar um agente de ia com python: tutorial prático do zero à execução

Aprenda passo a passo como criar um agente de IA com Python usando LangChain: configure ferramentas, implemente memória persistente e evite armadilhas comuns.

Neste artigo

Aprender como criar um agente de ia com python exige entender a transição fundamental de uma simples chamada de API para um ciclo autônomo de raciocínio e execução. Neste tutorial, você vai construir um agente capaz de interpretar objetivos, escolher ferramentas adequadas e reter contexto de conversa sem estourar limites de contexto.

AspectoDetalhe
Linguagem e versãoPython 3.10 ou superior
Framework baseLangChain Core e LangChain OpenAI
Complexidade técnicaIntermediário (requer lógica de APIs e POO)
Custo estimadoCentavos de dólar via OpenAI API (ou gratuito com modelos locais)

O que é um agente de IA e como ele opera no Python?

Um agente de inteligência artificial é um sistema orientado a código que utiliza um modelo de linguagem como motor de inferência para decidir dinamicamente quais ações executar com base na entrada do usuário. Em vez de seguir um fluxo linear codificado em if/else, o agente avalia o problema, consulta ferramentas disponíveis e itera até obter uma resposta satisfatória.

Diferente de um chatbot padrão, o agente opera no padrão ReAct (Reasoning and Acting). Ele recebe o prompt, elabora um plano de raciocínio, aciona uma ferramenta externa (como consulta a bancos de dados, APIs ou calculadoras) e observa o retorno para decidir o próximo passo. Na vasta oferta de frameworks de agentes de IA, o ecossistema Python se consolidou como o padrão da indústria pela facilidade de orquestração.

Plano carreira analista de dados microsoft power bi

Se você está consolidando sua base técnica em automação e manipulação de fluxos, recomendo dar uma olhada nos cursos gratuitos de programação Python e IA para reforçar os fundamentos antes de lidar com pipelines mais densos.

Pré-requisitos e configuração do ambiente de desenvolvimento

Para configurar o ambiente de desenvolvimento sem conflito de dependências no seu sistema operacional, isole as bibliotecas em um ambiente virtual dedicado. Você precisará do Python 3.10 instalado e de uma chave de API válida da OpenAI ou de um provedor compatível.

Execute os comandos a seguir no terminal para criar o diretório do projeto e instalar as dependências necessárias:

mkdir agente-python && cd agente-python
python3 -m venv .venv
source .venv/bin/activate
pip install langchain langchain-openai langchain-community python-dotenv

Para gerenciar seu ambiente virtual de forma consistente em sistemas Linux ou macOS, consulte sempre a documentação do módulo venv no Python. Em seguida, crie um arquivo .env na raiz do projeto e declare sua chave de autenticação com a variável OPENAI_API_KEY="sua-chave-aqui".

Curso analista ciberseguranca junior cisco

Passo a passo: como construir seu primeiro agente com ferramentas

A construção do agente começa pela definição das ferramentas (tools) que o modelo poderá invocar durante a execução do raciocínio. O modelo de linguagem nunca executa código de rede por conta própria: ele apenas formata uma chamada em JSON que o executor do agente roda no interpretador Python.

Crie um arquivo chamado agent.py e insira o script abaixo:

from dotenv import load_dotenv
from langchain_core.tools import tool
from langchain_openai import ChatOpenAI
from langchain.agents import create_tool_calling_agent, AgentExecutor
from langchain_core.prompts import ChatPromptTemplate

load_dotenv()

@tool
def somar(a: int, b: int) -> int:
    """Soma dois números inteiros com precisão matemática."""
    return a + b

llm = ChatOpenAI(model="gpt-4o-mini", temperature=0)
tools = [somar]
prompt = ChatPromptTemplate.from_messages([
    ("system", "Você é um assistente técnico objetivo."),
    ("human", "{input}"),
    ("placeholder", "{agent_scratchpad}")
])

agent = create_tool_calling_agent(llm, tools, prompt)
executor = AgentExecutor(agent=agent, tools=tools, verbose=True)
resultado = executor.invoke({"input": "Quanto é 1480 mais 3520?"})
print(resultado["output"])

Neste código, o decorador @tool converte uma função Python comum em um esquema estruturado compreendido pelo LLM. A docstring da função não é apenas documentação interna: ela é o texto exato que o modelo lê para entender quando deve acionar a função.

Dica:Seja minucioso nas docstrings e na tipagem das suas ferramentas. Modelos tomam decisões erradas principalmente quando as descrições dos parâmetros estão vagas ou ambíguas.

Cursos google ciee gratuitos certificado

Como adicionar memória persistente e gerenciar estado

A gestão de memória e persistência em agentes é o mecanismo que impede o agente de sofrer de amnésia a cada novo prompt. Sem um buffer de histórico, o modelo perde qualquer referência a mensagens trocadas anteriormente no mesmo diálogo.

Para implementar histórico com LangChain, utilizamos o wrapper RunnableWithMessageHistory em conjunto com armazenadores de mensagens, como o ChatMessageHistory em memória ou conexões em bancos de dados como Redis e PostgreSQL.

Dar memória a um agente não é apenas concatenar strings no prompt; é gerenciar a janela de contexto para não estourar limites de tokens nem inflacionar o custo da infraestrutura.

Em projetos de dados corporativos onde agentes consultam relatórios analíticos, gerenciar o estado da aplicação exige padrões sólidos de governança. Para entender como estruturar grandes volumes de dados antes de conectar agentes, vale consultar conteúdos como os treinamentos de Databricks para engenharia e dados, que ajudam a organizar as bases de dados corporativas.

Curso gratuito analise de dados dashboards google looker studio senai

Erros comuns no desenvolvimento de agentes e como resolver

Erros em agentes autônomos costumam ser muito mais sutis do que exceções de sintaxe, pois acontecem na camada probabilística do modelo. O problema mais perigoso é o loop infinito de chamadas de ferramenta, no qual o agente chama a mesma função repetidamente sem chegar a uma conclusão.

Para neutralizar loops infinitos, defina explicitamente o parâmetro max_iterations=5 e max_execution_time=30 na inicialização do AgentExecutor. Isso garante que o agente pare forçadamente caso não encontre uma resposta em tempo hábil.

Atenção:Nunca suba um executor de agentes para produção sem um teto de iterações configurado. Um prompt impreciso ou falha de rede na tool pode fazer o modelo entrar em loop até esgotar seus créditos de API.

Outro problema frequente envolve a falha no parsing de JSON gerado pelo LLM. Em cenários voltados a deploy e produção de agentes de IA com Python, valide sempre as saídas com Pydantic antes de repassar dados para o cliente final, e consulte a documentação oficial do LangChain para acompanhar os padrões atualizados de Tool Calling.

Curso gratuito microsoft analise de dados power bi certificado

Acessar guia oficial de agentesDocumentação técnica e tutoriais avançados do LangChain

Perguntas frequentes sobre agentes de IA em Python

Quais são os melhores frameworks de agentes de IA em Python?

LangChain e LlamaIndex dominam o ecossistema geral de desenvolvimento, enquanto CrewAI e AutoGen se destacam para arquiteturas multiagente. A escolha depende se o foco do projeto é orquestração de ferramentas ou recuperação densa de dados.

Qual a diferença entre LangChain e LlamaIndex para agentes?

O LangChain é mais versátil para fluxos de decisão dinâmicos, ações com ferramentas externas e integração ampla de sistemas. O LlamaIndex é especializado em indexação, busca avançada e agentes voltados a pipelines de RAG sobre documentos volumosos.

Como testar e depurar um agente de IA localmente?

Utilize a flag verbose=True no AgentExecutor para inspecionar os passos de raciocínio no terminal. Para inspeção visual completa de tokens e chamadas, configure o LangSmith ou use modelos locais via Ollama para isolar testes de lógica sem custos.

O que considerar no deploy e produção de agentes de IA com Python?

É mandatório configurar timeouts rígidos, limites de iterações, cache de consultas frequentes e validação de schema nas saídas. Além disso, encapsule o agente em uma API assíncrona com FastAPI e adicione observabilidade sobre o consumo de tokens.

O que você achou deste artigo?

Responda a Pergunta do Dia Teste seu conhecimento e mantenha sua streak. Crie seu Dev Card público Perfil dev compartilhável em um único link.

Depois dessa formação...

Veja vagas em tecnologia →

Vagas relacionadas

Ver todas as vagas →
DA

Escrito por

Dagmar

Publicado em

Ver perfil do autor

COMPARTILHAR