Harness Atlas

COURSE 01 · Harness Engineering

ハーネスとは何か

モデルだけではAIエージェントは安定して動かない。モデルを働かせる枠組み=ハーネスの役割と、その心臓部にあるエージェントループを理解する。

モデルだけでは足りない

大規模言語モデル(LLM)は、文章を生成します。質問に答え、コードを書き、手順を提案します。ですが、モデル単体ではファイルを読むことも、コマンドを実行することも、失敗したときに自分でやり直すこともできません。モデルは「考える」ことはできても、「動く」手足を持たないからです。

実際の仕事をこなすAIエージェントには、モデルを道具とつなぎ、動けるようにする仕組みが要ります。その仕組みをハーネス(harness)と呼びます。

ハーネスとは

ハーネスとは、モデルを包んで次のことを担う枠組みです。

  • モデルに「いまの状況」を入力として渡す
  • モデルの出力を解釈する(文章なのか、道具を呼ぶ指示なのか)
  • 指示された道具を実行し、結果を受け取る
  • その結果を次の入力に戻す

Claude Code、Codex、Cursor、Devin は、いずれもこのハーネスの一種です。見た目や得意分野は違っても、「モデルを働かせる枠組み」という点は共通しています。

心臓部は、短い繰り返し

ハーネスの中心にあるのは、驚くほど単純な繰り返しです。

  1. いまの状況(コンテキスト)をモデルに渡す
  2. モデルが次の一手を決める(文章を書く、または道具を呼ぶ)
  3. 道具を実行し、結果を得る
  4. 結果をコンテキストに足して、1に戻る

この「考える、動く、観察する」を、目的を達するまで回します。これをエージェントループと呼びます。エージェントが賢く見えるかどうかは、モデルの良さだけでなく、このループをどれだけ安定して回せるかで決まります。

ハーネス(体) モデル 頭脳 エージェントループで回す(渡す→動く→観察する→戻す) ループの周りの要素 コンテキスト ツール ステート サンドボックス Evals
ハーネスはモデルを包み、エージェントループで働かせる。ループの周りに、コンテキスト・ツール・ステート・サンドボックス・Evalsなどの要素がある。

ループの周りにあるもの

ループを実用的に回すには、周辺の要素が要ります。本コースで一つずつ扱う予定の、主な登場人物を先に挙げておきます。

  • コンテキスト:モデルに渡す情報。多すぎても少なすぎても精度が落ちます。何を入れ、何を省くかの設計が、結果を大きく左右します。
  • ツール:モデルが呼べる操作。ファイルの読み書き、コマンド実行、検索などです。
  • ステート:会話や作業の途中経過。中断して後で再開するために保持します。
  • スキル:特定の作業手順を、必要なときだけモデルに渡す仕組み。
  • サンドボックス:安全に実行するための隔離された環境。
  • Evals:うまくいっているかを測る仕組み。手応えではなく数字で確かめます。

「最小のハーネス」から始める

はじめから多機能なものを作る必要はありません。むしろ、最小のループに道具を1つだけつないだところから始め、必要に応じて足していくほうが、何がどう効いているかを理解しやすくなります。小さく作って、動かして、観察する。この姿勢は、エージェント自身の動き方と同じです。

まとめ

  • モデルは頭、ハーネスは体です。信頼できるエージェントは、その両方の設計で決まります。
  • ハーネスの心臓部はエージェントループ(考える、動く、観察するの繰り返し)です。
  • ループの周りには、コンテキスト・ツール・ステート・サンドボックス・Evalsがあります。

次のレッスンでは、このハーネスを設計し、磨いていく営み(Harness Engineering)そのものを、生まれた背景と一次情報とあわせて見ていきます。

実在するハーネスの違いはハーネス別ガイドで、束ねて使う考え方はハーネス比較で確かめられます。

コースへ戻る次のレッスン