Repolode
Moh4696

Moh4696/build-ai-agents-free

無料枠のGroqとGeminiを使い、LangChainとLangGraphでPython AIエージェントを構築する手順を解説する無料チュートリアル。

スター
369
フォーク
115
未解決の Issue
2
最終コミット
3 か月前

これは何?

API料金をかけずにPythonでAIエージェントを構築する、初心者向けのチュートリアルです。通常のチャットボットとエージェントを分ける「計画・実行・観察」のループを解説し、Groqの無料モデルLlama 3.3 70Bを使って、LangChainのcreate_agentでそのループを実行する方法を紹介します。

ガイドでは、段階を追って機能を追加していきます。まず最小構成のエージェントを作り、続いて組み込みのDuckDuckGoウェブ検索ツールと、@toolデコレーターで定義するカスタムのword_countツールを追加します。次にInMemorySaverチェックポインターとthread_idを使って会話メモリを加え、最後にプライマリプロバイダーが失敗した際にGroqからGoogle Geminiへ切り替えるフォールバックを実装します。各ステップに対応するスクリプトがリポジトリのsrcフォルダーにあり、agent.pyにはすべてをまとめたエージェントが用意されています。

エージェントの経験がなく、有料APIキーを使わずに学びたい読者を対象としています。また、検索ツールのレート制限、スクリプトの終了時に失われるメモリ、無料枠のプロバイダーがプロンプトを学習に利用する可能性など、無料構成の制約にも触れています。

主な機能

  • 01LangChainのcreate_agentとGroqの無料モデルLlama 3.3 70Bを使って、動作するエージェントを構築します。
  • 02APIキー不要のDuckDuckGoウェブ検索ツールを追加します。
  • 03@toolデコレーターを使って、任意のPython関数をツールにする方法を紹介します。
  • 04InMemorySaverチェックポインターとthread_idを使って、複数ターンにわたる会話メモリを追加します。
  • 05障害発生時にGroqからGoogle Geminiへ切り替えるプロバイダーフォールバックを実演します。
  • 06各ステップで実行できるスクリプトに加え、すべてをまとめたagent.pyを収録しています。

ユースケース

  • AIエージェントの「計画・実行・観察」ループを基礎から学ぶ。
  • 有料APIキーを使わずに、ツールを利用するエージェントのプロトタイプを作る。
  • LangChainとLangGraphの基礎を学ぶ初心者向けワークショップで教える。
  • 無料プロバイダーが利用できない場合のフォールバックが必要なサイドプロジェクトを構築する。

クイックスタート

  1. 1

    Python 3.10以降がインストールされていることを確認します

    python3 --version
  2. 2

    プロジェクト用のフォルダを作成して、そのフォルダに移動します

    mkdir my-agent cd my-agent
  3. 3

    langchain、Groq connector、python-dotenvをインストールします

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

    console.groq.comで無料のGroq API keyを取得して.envファイルに保存し、最初のagentスクリプトを実行します

    python3 agent.py

使う前に知っておきたいこと

  • 無料モデルの利用条件は予告なく変更されることがあり、多くのプロバイダーがプロンプトを学習に使用する可能性があるため、機密データは入力しないでください。
  • DuckDuckGo search toolは頻繁に使うとレート制限がかかり、一時的に失敗することがあります。
  • InMemorySaverは会話のメモリをRAM上にのみ保持するため、スクリプトを停止すると失われます。

トピック

よくある質問

build-ai-agents-free とは?
無料枠のGroqとGeminiを使い、LangChainとLangGraphでPython AIエージェントを構築する手順を解説する無料チュートリアル。 API料金をかけずにPythonでAIエージェントを構築する、初心者向けのチュートリアルです。通常のチャットボットとエージェントを分ける「計画・実行・観察」のループを解説し、Groqの無料モデルLlama 3.3 70Bを使って、LangChainのcreate_agentでそのループを実行する方法を紹介します。
build-ai-agents-free は無料で使えますか?ライセンスは?
build-ai-agents-free は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
build-ai-agents-free は今もメンテナンスされていますか?
半年以内に更新あり。build-ai-agents-free の最終コミットは 2026年7月8日 です。
build-ai-agents-free は何に使えますか?
AIエージェントの「計画・実行・観察」ループを基礎から学ぶ。 有料APIキーを使わずに、ツールを利用するエージェントのプロトタイプを作る。 LangChainとLangGraphの基礎を学ぶ初心者向けワークショップで教える。 無料プロバイダーが利用できない場合のフォールバックが必要なサイドプロジェクトを構築する。
build-ai-agents-free のインストール方法は?
Python 3.10以降がインストールされていることを確認します: python3 --version プロジェクト用のフォルダを作成して、そのフォルダに移動します: mkdir my-agent cd my-agent langchain、Groq connector、python-dotenvをインストールします: pip install -U "langchain[groq]" python-dotenv console.groq.comで無料のGroq API keyを取得して.envファイルに保存し、最初のagentスクリプトを実行します: python3 agent.py
build-ai-agents-free はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/Moh4696/build-ai-agents-free

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト