Repolode
Moh4696

Moh4696/build-ai-agents-free

Tutorial gratuito, passo a passo, para criar um agente de IA em Python com LangChain e LangGraph usando os modelos gratuitos dos planos free do Groq e do Gemini.

Estrelas
369
Forks
115
Issues abertas
2
Último commit
há 3 meses

O que é?

Este tutorial para iniciantes ensina a criar um agente de IA em Python sem pagar por nenhuma API. Ele explica o ciclo de planejar, agir e observar, que diferencia um agente de um chatbot comum, e mostra como executar esse ciclo com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.

O guia desenvolve o agente passo a passo. Começa com um agente mínimo e, em seguida, adiciona uma ferramenta pronta de busca na web com DuckDuckGo e uma ferramenta personalizada word_count, definida com o decorator @tool. Depois, adiciona memória de conversa usando um checkpointer InMemorySaver e thread_id e, por fim, um fallback que muda do Groq para o Google Gemini quando o provedor principal falha. Cada etapa tem um script correspondente na pasta src do repositório, e o agent.py reúne tudo.

O tutorial é voltado a quem não tem experiência prévia com agentes e quer evitar chaves de API pagas. Também aponta as limitações da configuração gratuita, como limites de requisições na ferramenta de busca, a perda da memória quando o script é encerrado e a possibilidade de provedores com planos gratuitos usarem os prompts para treinamento.

Recursos principais

  • 01Cria um agente funcional com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.
  • 02Adiciona uma ferramenta de busca na web com DuckDuckGo que não exige chave de API.
  • 03Mostra como transformar qualquer função Python em uma ferramenta com o decorator @tool.
  • 04Adiciona memória para conversas com várias interações usando um checkpointer InMemorySaver e thread_id.
  • 05Demonstra o fallback de provedor do Groq para o Google Gemini em caso de falha.
  • 06Inclui um script executável para cada etapa e um agent.py que reúne tudo.

Casos de uso

  • Aprender do zero o ciclo de planejar, agir e observar dos agentes de IA.
  • Prototipar um agente que usa ferramentas sem uma chave de API paga.
  • Ensinar os fundamentos de LangChain e LangGraph em uma oficina para iniciantes.
  • Criar um projeto pessoal que precise de um fallback quando um dos provedores gratuitos estiver indisponível.

Início rápido

  1. 1

    Verifique se o Python 3.10 ou uma versão mais recente está instalado

    python3 --version
  2. 2

    Crie uma pasta para o projeto e acesse-a

    mkdir my-agent cd my-agent
  3. 3

    Instale langchain, o conector do Groq e python-dotenv

    pip install -U "langchain[groq]" python-dotenv
  4. 4

    Obtenha uma Groq API key gratuita em console.groq.com e salve-a em um arquivo .env. Em seguida, execute o primeiro script do agente

    python3 agent.py

Antes de usar

  • Os níveis gratuitos dos modelos podem mudar sem aviso, e a maioria dos provedores pode usar seus prompts para treinamento. Portanto, não inclua dados confidenciais.
  • A ferramenta de busca DuckDuckGo limita o uso intenso e pode falhar ocasionalmente.
  • InMemorySaver mantém a memória da conversa apenas na RAM, então ela é perdida quando o script é encerrado.

Tópicos

Perguntas frequentes

O que é build-ai-agents-free?
Tutorial gratuito, passo a passo, para criar um agente de IA em Python com LangChain e LangGraph usando os modelos gratuitos dos planos free do Groq e do Gemini. Este tutorial para iniciantes ensina a criar um agente de IA em Python sem pagar por nenhuma API. Ele explica o ciclo de planejar, agir e observar, que diferencia um agente de um chatbot comum, e mostra como executar esse ciclo com o create_agent do LangChain e o modelo gratuito Llama 3.3 70B do Groq.
build-ai-agents-free é gratuito? Qual é a licença?
build-ai-agents-free é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
build-ai-agents-free ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de build-ai-agents-free foi em 8 de jul. de 2026.
Para que posso usar build-ai-agents-free?
Aprender do zero o ciclo de planejar, agir e observar dos agentes de IA. Prototipar um agente que usa ferramentas sem uma chave de API paga. Ensinar os fundamentos de LangChain e LangGraph em uma oficina para iniciantes. Criar um projeto pessoal que precise de um fallback quando um dos provedores gratuitos estiver indisponível.
Como instalar build-ai-agents-free?
Verifique se o Python 3.10 ou uma versão mais recente está instalado: python3 --version Crie uma pasta para o projeto e acesse-a: mkdir my-agent cd my-agent Instale langchain, o conector do Groq e python-dotenv: pip install -U "langchain[groq]" python-dotenv Obtenha uma Groq API key gratuita em console.groq.com e salve-a em um arquivo .env. Em seguida, execute o primeiro script do agente: python3 agent.py
Onde consigo build-ai-agents-free?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/Moh4696/build-ai-agents-free

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados