エージェントループ
エージェントループ(agent loop)とは、AI エージェントの中核にある繰り返しのサイクルです。モデルがツール呼び出しを求め、アプリケーションがそれを実行して結果を返し、モデルが次に何をするかを決めます。
別名: agentic loop, tool-use loop
執筆 Divya Sharma · 2026年11月15日確認 · レビューの方法
言語モデルは、それ自体ではコードを実行したり API を呼び出したりできません。生成できるのはテキストだけで、そこにはツールを使うための構造化されたリクエストも含まれます。エージェントループは、モデルの周りにあって、そうしたリクエストを実際の動作に変えるコードです。
仕組み
1. モデルにタスクとツールの一覧を送ります。 2. モデルは 1 つ以上のツール呼び出し、または最終的な回答を返します。 3. ツールを求められた場合、アプリケーションはそれを実行し、結果を会話に追加します。 4. 更新した会話を送り返し、手順 2 から繰り返します。
Claude API では、応答の stop reason が tool_use である間はループが続き、それ以外の stop reason で終了します。ツール呼び出しはそれぞれ 1 往復なので、10 回のツール呼び出しが必要なタスクには少なくとも 10 回のリクエストがかかります。各リクエストの詳細はツール呼び出しで説明しています。
ループを取り巻くもの
ループ自体は短いものです。エンジニアリングの大半はそれを包む部分にあります。ターン数の上限、ツールが失敗したときのエラー処理、危険な操作に対する承認の確認、結果が積み上がっても会話をコンテキストウィンドウに収める工夫などです。この包む部分は、しばしばエージェントハーネスと呼ばれます。
関連するパターン
ReAct パターンはループの組み立て方の 1 つで、推論のテキストと行動を交互に行います。
関連用語
- AI エージェント
- AI エージェント(AI agent)とは、言語モデルが次の手順を自分で決めるシステムです。固定の台本に従うのではなく、ツールを呼び出し、結果を読み、タスクが終わるまで繰り返します。
- ツール呼び出し
- ツール呼び出し(tool calling)は関数呼び出し(function calling)とも呼ばれ、モデル API の機能の 1 つです。スキーマで関数を記述すると、モデルはその 1 つを呼び出す構造化されたリクエストを返し、コードがそれを実行して結果を返します。
- エージェントハーネス
- エージェントハーネス(agent harness)とは、モデルを実際に動くエージェントにするための周辺ソフトウェアです。ループ、ツール、システムプロンプト、権限、コンテキスト管理、セッション間で進捗を引き継ぐためのファイルなどを含みます。
- コンテキストウィンドウ
- コンテキストウィンドウ(context window)とは、言語モデルが一度に考慮できるテキストの最大量で、トークン数で数えます。システムプロンプト、会話、文書、ツールの結果、モデルが書く応答が含まれます。
- ReAct(reasoning and acting)
- ReAct(reasoning and acting、推論と行動)とは、言語モデルが推論のステップを書くこと、検索やツール呼び出しなどの行動をとること、次のステップの前にその結果を読むことを交互に繰り返すプロンプトのパターンです。