多くのエンジニアがLLMを実運用する中で、「単純なRAGでは複雑な質問に答えられない」「LLMが意図しない推論パスに入ってしまう」といった課題に直面しているのではないでしょうか。私も、従来のRAGでは対応が難しかった多段階の推論や、複数の情報源を横断した高度な意思決定が必要な場面で、LLMの限界を感じてきました。
この記事では、そんな課題を解決する「Agentic RAG」が、いかにしてLLMに自律推論能力をもたらすのかを深掘りします。特に、LangGraphという強力なオーケストレーションフレームワークを使い、LLMエージェントを構築する具体的な仕組み、設計思想、そして陥りがちな落とし穴とその回避策まで、実践的な知見を提供します。この記事を読めば、あなたのLLMアプリケーションは次のレベルに進むでしょう。
Agentic RAGとは?従来のRAGの限界と克服
このセクションでは、Agentic RAGの基本的な定義と、なぜこれが必要とされるのか、従来のRAGが抱えていた課題とAgentic RAGによるその克服方法について解説します。
従来のRAGの限界
従来のRAG(Retrieval-Augmented Generation)は、外部知識を検索してLLMの回答を補強する強力な手法です。しかし、その基本は「単一の検索クエリ → 関連ドキュメント取得 → LLMによる回答生成」という一本道のシーケンスに過ぎません。このシンプルな構造は、以下のような複雑なシナリオで限界を迎えます。
- 複雑なクエリや多段階推論: 複数の情報源からの推論が必要な場合や、中間ステップで得られた情報に基づいて次のアクションを決定する必要がある場合、従来のRAGは対応できません。
- 自己修正能力の欠如: 最初の検索結果が不十分だったり、LLMの生成が誤っていたりしても、それを検知して修正するメカニズムがありません。
- 限定的な情報源: 構造化データや外部APIの利用が困難で、主にテキストデータに依存します。
Agentic RAGによる自律推論の実現
Agentic RAGは、この従来のRAGに自律的なAIエージェントの概念を組み込むことで、上記の限界を突破します。具体的には、LLMエージェントが「計画(Planning)」「記憶(Memory)」「ツール利用(Tool Use)」といった機能を持ち、検索・生成のプロセスを反復的に、かつ動的に制御します。
Agentic RAGの主要な目的は、単なる情報の検索と生成を超えて、エージェントが以下のような自律的な行動を取れるようにすることです。
- 検索内容の決定: ユーザーのクエリを分析し、最適な検索クエリを生成します。
- 結果の評価: 検索結果が質問に対する回答として十分か、さらに情報が必要かを判断します。
- 信頼性の高い回答の生成: 必要に応じて追加の検索やツール利用を行い、最終的に信頼性の高い回答を構築します。
- 自己修正: 途中で誤りや不足に気づいた場合、計画を修正して再試行します。
これにより、Agentic RAGは、人間が複雑な問題解決を行うように、LLMが多段階の思考プロセスを経て回答を導き出すことを可能にします。
LLMエージェントの核心:計画・記憶・ツール利用
このセクションでは、Agentic RAGを支えるLLMエージェントが、どのようなコンポーネントで構成されているかを詳しく解説します。これらはエージェントの自律的な振る舞いを決定する重要な要素です。
LLMエージェントは、以下の3つのコア機能に依存しています。
1. 計画(Planning)
計画能力は、エージェントが目標を達成するために、タスクを段階的なステップに分解し、その実行順序を決定する機能です。複雑な質問に対して、エージェントはまず全体的な解決戦略を立て、次に個々のサブタスク(例: 「ユーザーの意図を理解する」「関連情報を検索する」「複数の情報を統合する」)に分割します。
この計画プロセスは、LLMが自身の推論能力を用いて行われることが多く、プロンプトエンジニアリングによってその精度を高めることができます。
2. 記憶(Memory)
記憶システムは、エージェントが過去のインタラクションや得られた情報を保持し、現在のコンテキストに活用するための機能です。これにより、エージェントはマルチターンの会話や長期的なタスクに対応できるようになります。
記憶は大きく分けて2種類あります。
- 短期記憶 (Short-term Memory): 現在のセッションやタスクに関連する一時的な情報(例: 直前のユーザー発言、現在の思考プロセス、検索結果)を保持します。これは主にLLMのコンテキストウィンドウ内で管理されます。
- 長期記憶 (Long-term Memory): 数週間から数ヶ月にわたる過去のインタラクションからの洞察や、永続的に保持すべき知識を格納します。通常、ベクトルデータベースや通常のデータベースに保存され、必要に応じて検索されてコンテキストに注入されます。
3. ツール利用(Tool Use / Function Calling)
ツール利用は、LLMエージェントが外部のソフトウェア、API、またはデータソースに接続し、タスクを実行する能力です。これにより、LLMの知識の限界を超え、リアルタイム情報へのアクセス、計算の実行、データベース操作などが可能になります。
例としては、以下のようなツールが考えられます。
- 検索ツール: ウェブ検索、社内ドキュメント検索
- データベースツール: SQLクエリ実行、データ取得
- APIツール: 外部サービスのAPI呼び出し(天気予報、株価情報など)
- 計算ツール: Pythonインタープリタ、電卓
-
HRアシスタントの例:
-
get_user_context: 従業員の基本情報を取得 -
search_leave_policy: 休暇ポリシーを検索 -
search_promotion_bonus_policy: 昇進・ボーナスに関するポリシーを検索
-
LLMは、ユーザーのクエリと利用可能なツールの説明に基づいて、どのツールをどの引数で呼び出すかを自律的に判断します(Function Calling)。
LangGraphによるAgentic RAGの構築
このセクションでは、LangGraphというフレームワークが、いかにしてAgentic RAGを実装するための強力な基盤となるかを解説します。LangGraphの主要な概念と、それらを使ってエージェントワークフローを構築する方法に焦点を当てます。
LangGraphの概要と特徴(LangGraph v1)
LangGraphは、LLMをグラフとしてステートフルなマルチアクターアプリケーションを構築するための低レベルなオーケストレーションフレームワークおよびランタイムです。LangGraph v1は安定性に焦点を当てたリリースであり、コアとなるグラフAPIと実行モデルは変更されていません。
- 安定性: コアAPIの安定性が高く、型安全性、ドキュメント、開発者の使いやすさが向上しています。
-
LangChain v1との連携: LangChainの
create_agentはLangGraph上に構築されており、高レベルな抽象化から始めて、必要に応じて詳細な制御に移行できます。 - 永続性: エージェントの実行状態が自動的に永続化されるため、途中で中断されても中断したところから再開できます。
- Human-in-the-loop (HITL): エージェントの状態を任意の時点で検査・変更することで、人間の監視や介入を容易に組み込むことができます。
LangGraphのコアコンポーネント
LangGraphは、グラフ理論に基づいたシンプルな概念でエージェントのワークフローを表現します。
-
State (状態)
- アプリケーションの現在のスナップショットを表す共有データ構造です。
- 各ノードは現在の状態を入力として受け取り、計算を実行し、更新された状態を返します。
- 通常は辞書やPydanticモデルなどで定義され、エージェントの記憶や現在のタスクの進行状況を保持します。
-
Nodes (ノード)
- エージェントのロジックをエンコードする関数です。
- 現在の状態を入力として受け取り、何らかの処理(例: LLM呼び出し、ツール実行、検索)を行い、更新された状態を返します。
- 各ノードは、エージェントの思考プロセスにおける個別のステップに対応します。
-
Edges (エッジ)
- 現在の状態に基づいて、次に実行するノードを決定する関数です。
- エージェントの意思決定ロジックを表現します。
- 条件付きエッジ: 特定の条件(例: LLMの出力、ツールの実行結果)に基づいて、次に進むノードを動的に決定します。
- 固定エッジ: 常に特定のノードに遷移します。
LangGraphを使用したエージェントの構築例
LangGraphでは、エージェントのワークフローをノードと呼ばれる個別のステップに分解し、各ノードからの異なる決定と遷移を記述し、各ノードが読み書きできる共有状態を介してノードを接続します。
以下は、ReActエージェントをLangGraphで構築する際の概念的な流れです。
-
状態の定義:
TypedDictやPydanticモデルで、input、agent_scratchpad(エージェントの思考記録)、outputなどの状態を定義します。 -
ノードの定義:
-
call_llm_node: LLMを呼び出し、思考や次に実行すべきツールを決定するノード。 -
call_tool_node: LLMが決定したツールを実行するノード。 -
finish_node: エージェントが最終回答を生成し、終了するノード。
-
-
エッジの定義:
- LLMの出力がツール呼び出しを示唆していれば
call_tool_nodeへ。 - LLMの出力が最終回答であれば
finish_nodeへ。 - ツール実行後、再び
call_llm_nodeに戻り、次の思考を促す。
- LLMの出力がツール呼び出しを示唆していれば
import os
from dotenv import load_dotenv
from typing import TypedDict, Annotated, List, Union
from langchain_core.agents import AgentAction, AgentFinish
from langchain_core.tools import tool
from langchain_openai import ChatOpenAI
from langgraph.graph import StateGraph, END
# 環境変数の設定
load_dotenv()
OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
# 1. 状態の定義
class AgentState(TypedDict):
input: str
chat_history: List[str]
agent_outcome: Union[AgentAction, AgentFinish, None]
intermediate_steps: Annotated[List[tuple[AgentAction, str]], operator.add]
# 2. ツールの定義 (例として簡単な計算ツール)
@tool
def multiply(a: int, b: int) -> int:
"""Calculates the product of two numbers."""
return a * b
tools = [multiply]
llm = ChatOpenAI(model="gpt-4o", temperature=0) # LLMを初期化
# 3. ノードの定義
def run_llm(state: AgentState):
"""LLMを呼び出し、次のアクションを決定するノード"""
# ここでLangChainのAgentExecutorをラップすることも可能
# 簡単のため、直接Function Callingをシミュレート
tool_names = {tool.name for tool in tools}
# プロンプトやLLMの呼び出しロジックは省略
# 実際にはここでLLMが思考し、ツールを呼び出すか、最終回答を生成する
# 仮のLLM出力 (ツール呼び出しのシミュレーション)
if "multiply" in state["input"]:
action = AgentAction(
tool="multiply",
tool_input={"a": 2, "b": 3},
log="Calling multiply tool with 2 and 3."
)
return {"agent_outcome": action}
else:
finish = AgentFinish(
return_values={"output": f"I received: {state['input']}"},
log="No tool needed, returning direct response."
)
return {"agent_outcome": finish}
def execute_tool(state: AgentState):
"""ツールを実行するノード"""
agent_outcome = state["agent_outcome"]
if isinstance(agent_outcome, AgentAction):
tool_name = agent_outcome.tool
tool_input = agent_outcome.tool_input
# ここで実際のツールを実行
if tool_name == "multiply":
result = multiply.run(tool_input)
return {"intermediate_steps": [(agent_outcome, str(result))]}
raise ValueError(f"Unknown tool: {tool_outcome.tool}")
# 4. エッジの定義 (条件付きエッジ)
def should_continue(state: AgentState):
"""次にLLMを呼び出すか、終了するかを決定する条件関数"""
if isinstance(state["agent_outcome"], AgentFinish):
return "end"
else:
return "continue"
# グラフの構築
workflow = StateGraph(AgentState)
workflow.add_node("llm", run_llm)
workflow.add_node("tool", execute_tool)
workflow.set_entry_point("llm")
# エッジを追加
workflow.add_conditional_edges(
"llm", # "llm" ノードの実行後
should_continue, # この関数で次に進むノードを決定
{
"continue": "tool",
"end": END
}
)
workflow.add_edge("tool", "llm") # ツール実行後、再びLLMに戻る
app = workflow.compile()
# 実行例
inputs = {"input": "What is 2 multiplied by 3?", "chat_history": []}
for s in app.stream(inputs):
print(s)
inputs_no_tool = {"input": "Hello there!", "chat_history": []}
for s in app.stream(inputs_no_tool):
print(s)
上記のコードは簡略化されていますが、run_llmノードがLLMの出力に基づいてAgentAction(ツール呼び出し)またはAgentFinish(最終回答)を生成し、should_continue関数がそれに応じて次のノード(toolノードまたはEND)に遷移させる、というLangGraphの基本的な流れを示しています。
よくあるエラーと回避策:Agentic RAGとLangGraphのデバッグ
このセクションでは、Agentic RAGやLangGraphで開発者が遭遇しやすいエラーやハマりどころを具体的に挙げ、その回避策やデバッグのヒントを提供します。
環境と接続の問題
-
不足しているライブラリ:
ImportErrorやModuleNotFoundErrorが発生した場合、pip install -r requirements.txtまたはpip install <library_name>で必要なライブラリがすべてインストールされているかを確認します。特にLangGraphとLangChainのバージョン互換性には注意が必要です。 -
APIキーの問題: "401 Unauthorized"、"AuthenticationError"、または無効なAPIキーに関するエラーは、環境変数(例:
OPENAI_API_KEY)が正しく設定され、コードと一致しているかを確認してください。dotenvなどでロードしている場合は、ファイルパスも確認します。 - ネットワーク接続の問題: LLMプロバイダーのステータスページを確認し、インターネット接続が安定していることを確認します。
-
レート制限(429 Too Many Requests): LLMプロバイダーからのレート制限エラーは、
Retry-Afterヘッダーを確認し、指数バックオフ(Exponential Backoff)を用いたリトライロジックを実装することで緩和できます。
LLMの出力処理の問題
- LLMの出力形式が期待と異なる: LLMが意図しないJSON形式や、期待する引数を返さない場合があります。デバッグ時はLLMの生の出力を常に検査し、プロンプトを洗練して、より構造化された出力を明示的に要求します(例: JSONスキーマの提供、明確な指示)。
エージェントのロジックの問題
-
意図しないループまたは明確な終了条件がない: エージェントが同じステップを繰り返したり、いつ終了すべきかわからない場合、LangGraphの実行フローがシンプルであることを確認し、ループがある場合は明確な終了条件(例:
AgentFinishの生成、特定の状態への遷移)を設定します。 - LangGraphノードが表示されない/トレースが複雑: 生のノード関数やルーティングロジックを記述した場合、スパンの欠落や孤立したノードの実行が見られることがあります。LangSmithなどのトレースツールを活用し、各ノードの入力・出力と遷移を視覚的に確認することが重要です。
-
GraphRecursionError: グラフが最大ステップ数(recursion_limit)を超過した場合に発生します。これは無限ループを防ぐための機構です。エージェントの思考ステップが多い場合や、意図しないループが発生している場合に発生します。recursion_limitを高く設定することで一時的に回避できますが、根本原因(ループの発生)を解決することが重要です。 -
InvalidUpdateError: 無効な更新セットでチャネル(状態)を更新しようとしたときに発生します。状態の型定義と、ノードからの戻り値が一致しているかを確認してください。 -
EmptyInputError: グラフが空の入力を受け取ったときに発生します。エージェントの初期入力や、ノード間の状態遷移でデータが欠落していないかを確認します。 -
NodeTimeoutError: ノードの呼び出しが設定されたタイムアウトを超過した場合に発生します。外部API呼び出しやLLMの応答が遅い場合に発生しがちです。
Agentic RAGの失敗モード
Agentic RAGは強力ですが、特有の失敗モードがあります。
- 低信頼度の検索、誤ったツール選択、冗長なコンテキスト: これらは、システムが軌道を外れていることを示す兆候です。LLMのプロンプトを調整し、ツール選択のロバスト性を高める必要があります。
- 意味的な不一致: 回答は一貫しているように見えても、ユーザーの真の意図を見逃している場合があります。ユーザーの意図を正確に捉えるためのプロンプト、そして検索結果の関連性評価ロジックを改善します。
- ノイズの多いまたは冗長なコンテキストへの過度の依存: 検索された情報がステップごとに広範になったり、古くなったり、識別性が低下したりすると、エージェントはしばしば軌道を失います。関連性の低い情報をフィルタリングするメカニズムや、コンテキストの要約・再構築を検討します。
- ツールストーム: ツール呼び出しがタスクあたりで異常に増加すること。LLMが不必要に多くのツールを呼び出す場合、ツールの説明を明確化したり、LLMに「本当に必要な場合のみツールを使う」といった指示を与えることで抑制できます。
- コンテキストの肥大化: イテレーションごとにコンテキスト長が過度に増加すること。これはコストとレイテンシに直結します。不要な情報をコンテキストから削除したり、長期記憶と短期記憶を効果的に使い分けたり、より短いプロンプトや要約を生成するように促すことで対応します。
設計上のトレードオフとベストプラクティス
このセクションでは、Agentic RAGシステムを設計・構築する際の重要な考慮事項、トレードオフ、そして推奨されるプラクティスについて解説します。
Agentic RAGの導入判断
すべての問題にAgentic RAGが必要なわけではありません。適切なタイミングで導入することが重要です。
-
従来のRAGを使用する場合:
- クエリが単一ステップで、データが単一ソースに存在する場合。
- 回答の深度よりもレイテンシが重要な場合。
- 例: FAQ応答、シンプルなドキュメント検索。
-
Agentic RAGを使用する場合:
- クエリが多段階の推論、複数ソースからの情報統合、自己修正を必要とする場合。
- より高いレイテンシとコストを許容できる場合。
- 例: 複雑なトラブルシューティング、データ分析、パーソナライズされたアシスタント。
- 推奨: まずは従来のRAGパイプラインを構築し、単一パスの検索がユーザーの実際のクエリで失敗しているという証拠がある場合にのみ、エージェントのオーケストレーションを追加します。
LLMエージェントの設計原則
- シンプルさを維持: エージェントの設計は可能な限りシンプルに保ち、理解、保守、スケーリングを容易にします。複雑なタスクでも、単純なサブタスクに分解することを心がけます。
- 透明性を優先: エージェントの計画ステップや思考プロセスを明示的に示すことで、デバッグや信頼性の向上に繋がります。LangSmithのようなツールで実行トレースを可視化します。
- エージェントとコンピュータのインターフェース(ACI)を慎重に作成: ツールは十分に文書化し、厳密にテストします。ツールの入力と出力の仕様は明確にし、LLMが正しく理解できるようにします。
- モジュール性: エージェントをより小さく独立したコンポーネント(ノード、ツール)に分割し、それぞれが特定の機能を実行するようにします。これにより、再利用性、テスト容易性、保守性が向上します。
LangGraphのベストプラクティス
-
状態設計: 状態オブジェクトは最小限に、明示的に、型付けされたものにします。
TypedDict、Pydantic、またはdataclassesを使用し、コードベース全体で一貫性を保ちます。状態は、その後のノードで必要な情報のみを保持するようにします。 - ノードの粒度: ノードは個別のステップとして設計し、レジリエンスと可観測性を考慮します。ノードの境界でチェックポイントが作成されるため、障害発生時にそこから再開できます。各ノードは単一の責任を持つべきです。
- エッジ設計: シンプルなエッジを好み、動作が分岐する場合にのみ条件付きエッジを追加します。複雑な条件ロジックはエッジ関数内にカプセル化し、読みやすさを保ちます。
- 状態は生のデータを保持し、プロンプトはオンデマンドでフォーマットする: 状態には生のデータ(例: 検索結果のテキスト、ユーザー入力)を保存し、プロンプトはノード内で必要なときにフォーマットします。これにより、異なるノードが同じデータを異なる方法でフォーマットでき、プロンプトテンプレートの変更が状態スキーマに影響を与えず、デバッグが容易になります。
- エラー処理: 重要なノードにはエラー処理を追加し、フォールバックメカニズムを提供します。詳細なエラー情報をログに記録し、問題発生時の原因究明を容易にします。
- 永続性: 本番環境では、エージェントの状態を永続化するためにPostgreSQLなどのチェックポインターを使用します。これにより、システムの信頼性と回復性が向上します。
- テスト: 関数だけでなく、グラフ全体を統合テストします。様々な入力パターンやエッジケースに対するエージェントの振る舞いを検証します。
- Human-in-the-Loop (HITL): 人間の判断が価値を追加する場所(例: 機密性の高いアクションの承認、重要な決定のレビュー)で中断(Human-in-the-Loop)を組み込みます。
スケーラビリティとレイテンシ
- 並列化: 複数のステップがあり、次のステップが前のステップの出力を必要としない場合、並列で実行できます。LangGraphは並列実行をサポートしています。
- ストリーミング: エージェントの実際のレイテンシをこれ以上削減できない場合、知覚されるレイテンシを改善するためにストリーミングを使用し、ユーザーに早期にフィードバックを返します。
-
ステートフル vs. ステートレスエージェント:
- ステートレスエージェント: テキスト抽出、要約、単一ターンの分類チャットボットなど、非常に特定のタスク指向のシンプルなパイプラインに適しています。アーキテクチャが軽量で、水平スケーリングが容易です。ただし、マルチターン会話では、フロントエンドがすべての新しいリクエストとともに会話履歴全体を再送信する必要があり、コンテキストウィンドウが肥大化し、トークン使用量が増加します。
- ステートフルエージェント: 長時間実行されるアシスタント、コーディングアシスタント、カスタマーサービスなどのマルチターンボットに適しています。エージェント自体が記憶の負担を負い、クライアントは最新のユーザープロンプトとセッションIDのみを送信します。LangGraphはステートフルエージェントの構築に最適です。
RAGの一般的な間違いと回避策
- 不適切なチャンキング: 固定トークン数や段落区切りなどのナイーブなアプローチではなく、セマンティックチャンキング、再帰チャンキング、オーバーラップウィンドウなどのベストプラクティスを採用し、各チャンクが「意味のあるまとまり」を表すようにします。
- データ品質の低さ: 「ゴミを入れればゴミが出る」の原則はRAGにも当てはまります。高品質でクリーンなデータを用意することが、RAGシステムの性能を決定づけます。
- 誤ったアーキテクチャの選択: 要件に合わせてアーキテクチャを選択し、トレンドに流されないようにします。シンプルなクエリには基本的なRAGから始め、必要に応じてAgentic RAGのような複雑なパターンを追加します。
- 評価の欠如: 定量的なメトリクスなしでは、コード変更やプロンプト調整がシステムを改善したのか、それとも静かに壊したのかを知る方法がありません。関連性、忠実性、回答の品質などを評価するベンチマークを設定し、継続的に評価を行います。
まとめと次の一歩
この記事では、従来のRAGの限界を突破し、LLMに自律推論能力をもたらすAgentic RAGの仕組みを深掘りしました。LLMエージェントが「計画」「記憶」「ツール利用」という3つの核心機能によって、いかに複雑なタスクを解決できるかを解説し、そのオーケストレーションに最適なLangGraphの活用方法とベストプラクティスを紹介しました。
Agentic RAGは、単なる情報の検索・生成を超え、LLMをよりインテリジェントで適応性の高いアシスタントへと進化させます。しかし、その強力さゆえに、設計やデバッグには注意が必要です。本記事で紹介したエラーと回避策、そして設計上のトレードオフを理解することで、より堅牢で信頼性の高いAgentic RAGシステムを構築できるでしょう。
次のステップとして、LangGraphの公式ドキュメントやLangChainのAgentic RAGに関するチュートリアルを参照し、実際に手を動かして複雑なエージェントを構築してみることをお勧めします。特に、LangSmithを活用したトレースとデバッグは、エージェントの内部動作を理解する上で非常に役立ちます。