本文へスキップ
高度なエージェントに戻る

高度なエージェント · 第9章(全10章)

ディープエージェントのハーネス

ディープエージェントはToDoリストで計画し、仮想ファイルにメモを残し、仕事の一部を新しいコンテキストのサブエージェントに任せ、指定したツールの前で一時停止します。

20分4個中0個の目標を達成

目標

  • 仕事を始め、エージェントがToDoリストを書いて更新するのを見ます。未完了
  • メモの書き込みを承認し、ファイルツリーが育つのを見ます。未完了
  • 3つのサブエージェントを並列に動かし、コンテキストの大きさを比べます。未完了
  • 確認問題に合格します。未完了

ステップ1/4: 本文

長い仕事のためのハーネス

ハーネスとは、モデルのループを囲むコードです:プロンプト、ツール、そして各呼び出しが見るものです。LangChainのオープンソースパッケージdeepagentsはその1つで、LangGraphの上に作られています。2025年の発表では4つの部品が挙げられました:詳しいプロンプト、計画ツール、サブエージェント、ファイルシステムです。

ToDoとファイル

write_todos({ todos })は毎回リスト全体を受け取り、各項目はpending、in_progress、completedのどれかで、リストをstate.todosに保存します。ほかには何もしません:利点は、モデルが呼び出しのたびに自分の計画を読み直すことです。1ターンに2回呼ぶと拒否されます。有効にするには、LangChainのtodoListMiddleware()をmiddlewareに加えます。

ファイルツール(ls、read_file、write_file、edit_file、glob、grep)は、グラフの状態の中にある仮想ファイルシステムstate.filesを操作します。サブエージェントはそこにあるメモを読めますし、メモは古いメッセージの要約よりも長く残ります。

サブエージェント

task({ description, subagent_type })は、新しいコンテキストでサブエージェントを始めます:自分のシステムプロンプトとdescriptionだけで、呼び出し元のメッセージは1つも含みません。呼び出し元のファイルから始め、書いたファイルは呼び出し元にマージされ、最後のメッセージだけがツールの結果として返ります。1ターンの中の呼び出しは並列に動きます。呼び出し元のツールを持つ汎用のサブエージェントが、最初から用意されています。

スキル、メモリー、承認

スキルはSKILL.mdファイルを入れたフォルダーです。skills: ['/skills/']を指定すると、プロンプトに各スキルの名前と説明が並び、エージェントはタスクに必要なときだけファイルを読みます。memoryオプションはAGENTS.mdファイルをプロンプトに読み込みます。interruptOnはチェックポインターと組み合わせて、人が各呼び出しを承認、編集、却下するまで実行を一時停止するツールを指定します。このページはブレークポイント(interruptBefore)で一時停止します。interrupt()にはAsyncLocalStorageが必要なためです。

足場は少なく

どの部品も、呼び出しのたびにトークンを使います。deepagents 1.12(2026-07-29)はToDoリストをオプトインにし、汎用のシステムプロンプトを空にしました:今のモデルは、それほど指示を必要としません。ハーネス設計についてのAnthropicの記事(2026-03-24)も同じ意見です:新しいモデルが出るたびに、もう必要のない部品を外します。

このラボでは

再現したハーネスが、架空のショップHaldenの返金クレームについてブリーフを書きます。deepagents 1.16とは違い、todos: trueでリストを有効にし、自分のスキル一覧を持たないresearcherにスキルを見せ、古い汎用のプロンプト行を残し、AGENTS.mdのメモリーはありません。リードはwrite_fileとtaskの前で一時停止するので、流れを追えます。自分のエージェントでは、エージェントの外の何かを変えるツールの前で一時停止しましょう。

ステップ2/4: 試す:調べものの仕事を1部分ずつ

調べものの仕事を1部分ずつ

仕事を始めてToDoリストを見て、リードにメモを書かせ、それから3つのサブエージェントを承認してコンテキストの大きさを比べます。

モード:本物再現シミュレーション本物:LangGraph.js 1.5.1がこのページでループを動かし、そのMemorySaverとinterruptBeforeのブレークポイントも本物です。再現:deepagents 1.16のハーネスを、そのツール名、デフォルト値、メッセージごとLangGraph.js 1.5.1上に作り直したものです。本物のパッケージは、このサイトのLangSmith 0.11と一緒にはインストールできないためです。AGENTS.mdのメモリーは再現しておらず、トークンは文字数 / 4で推定しています。シミュレーション:モデルの判断は台本どおりで、Haldenのチケットは架空です。

ステップ3/4: 確認問題

確認問題

コード
const lead = createDeepAgent({
  systemPrompt: 'You write briefs.',
  subagents: [{
    name: 'researcher',
    description: 'Researches a cause.',
    systemPrompt: 'Edit the note, then report.',
  }],
});

// The lead's model asks for:
task({
  subagent_type: 'researcher',
  description:
    'Late refunds: /notes/late-refund.md',
})
モデルがこの呼び出しをするとき、リードのコンテキストは約1,400トークンです。researcherはファイルを約600トークン読み、メモを編集し、40トークンの報告で終わります。リードの状態では何が変わりますか?

ステップ4/4: これでできること

これでできること

  • middlewareにtodoListMiddleware()を加えてディープエージェントのToDoリストを有効にし、state.todosから計画を読む。
  • ls、read_file、write_file、edit_file、glob、grepで、メモや下書きをstate.filesに置く。
  • まとまった仕事をtaskのサブエージェントに任せ、戻ってくる報告とファイルを使う。
  • interruptOnとチェックポインターで、選んだツールの前でディープエージェントを一時停止し、新しいモデルにもう必要のない足場を外す。