COURSE 01 · Harness Engineering
ハーネスとは何か
モデルだけではAIエージェントは安定して動かない。モデルを働かせる枠組み=ハーネスの役割と、その心臓部にあるエージェントループを理解する。
モデルだけでは足りない
大規模言語モデル(LLM)は、文章を生成します。質問に答え、コードを書き、手順を提案します。ですが、モデル単体ではファイルを読むことも、コマンドを実行することも、失敗したときに自分でやり直すこともできません。モデルは「考える」ことはできても、「動く」手足を持たないからです。
実際の仕事をこなすAIエージェントには、モデルを道具とつなぎ、動けるようにする仕組みが要ります。その仕組みをハーネス(harness)と呼びます。
ハーネスとは
ハーネスとは、モデルを包んで次のことを担う枠組みです。
- モデルに「いまの状況」を入力として渡す
- モデルの出力を解釈する(文章なのか、道具を呼ぶ指示なのか)
- 指示された道具を実行し、結果を受け取る
- その結果を次の入力に戻す
Claude Code、Codex、Cursor、Devin は、いずれもこのハーネスの一種です。見た目や得意分野は違っても、「モデルを働かせる枠組み」という点は共通しています。
心臓部は、短い繰り返し
ハーネスの中心にあるのは、驚くほど単純な繰り返しです。
- いまの状況(コンテキスト)をモデルに渡す
- モデルが次の一手を決める(文章を書く、または道具を呼ぶ)
- 道具を実行し、結果を得る
- 結果をコンテキストに足して、1に戻る
この「考える、動く、観察する」を、目的を達するまで回します。これをエージェントループと呼びます。エージェントが賢く見えるかどうかは、モデルの良さだけでなく、このループをどれだけ安定して回せるかで決まります。
ループの周りにあるもの
ループを実用的に回すには、周辺の要素が要ります。本コースで一つずつ扱う予定の、主な登場人物を先に挙げておきます。
- コンテキスト:モデルに渡す情報。多すぎても少なすぎても精度が落ちます。何を入れ、何を省くかの設計が、結果を大きく左右します。
- ツール:モデルが呼べる操作。ファイルの読み書き、コマンド実行、検索などです。
- ステート:会話や作業の途中経過。中断して後で再開するために保持します。
- スキル:特定の作業手順を、必要なときだけモデルに渡す仕組み。
- サンドボックス:安全に実行するための隔離された環境。
- Evals:うまくいっているかを測る仕組み。手応えではなく数字で確かめます。
「最小のハーネス」から始める
はじめから多機能なものを作る必要はありません。むしろ、最小のループに道具を1つだけつないだところから始め、必要に応じて足していくほうが、何がどう効いているかを理解しやすくなります。小さく作って、動かして、観察する。この姿勢は、エージェント自身の動き方と同じです。
まとめ
- モデルは頭、ハーネスは体です。信頼できるエージェントは、その両方の設計で決まります。
- ハーネスの心臓部はエージェントループ(考える、動く、観察するの繰り返し)です。
- ループの周りには、コンテキスト・ツール・ステート・サンドボックス・Evalsがあります。
次のレッスンでは、このハーネスを設計し、磨いていく営み(Harness Engineering)そのものを、生まれた背景と一次情報とあわせて見ていきます。