Harness Atlas

COURSE 01 · Harness Engineering

エージェントループを深く見る

ハーネスの心臓部は「考える・動く・観察する」の繰り返し。その一周で何が起きるか、なぜ止まらなくなるのか、どう止めるのかを、実装の視点で掘り下げる。

このレッスンは詳細編です。全体像は入口のハーネスとは何かから読むと分かりやすくなります。

一周をスローで見る

ハーネスの心臓部がエージェントループであることは、入口のレッスンで見ました。ここでは、その一周を遅回しで観察します。おおまかな流れはこうです。

  1. 考える(reason):いまのコンテキストを受け取り、モデルが次の一手を決めます。「このファイルを読む」「このコマンドを実行する」「もう答えを返す」などです。
  2. 動く(act):決めた一手がツール呼び出しなら、ハーネスがそのツールを実行します。
  3. 観察する(observe):ツールの結果(出力、エラー、終了コードなど)を受け取ります。
  4. 足して、戻る:観察した結果をコンテキストに追加し、1に戻ります。

この「考える、動く、観察する」を交互に挟む進め方は、よくReAct(Reason and Act)と呼ばれます。一歩考えて、一歩動いて、結果を見て、また考える。丸ごと計画してから実行するより、途中の結果を見て軌道修正できるぶん、こみ入ったタスクに強くなります。

考える reason 動く act 観察する observe 結果をコンテキストに足して、また考える 止まる条件 → 完了
考える・動く・観察するを繰り返し、結果を足して戻る。止まる条件を満たしたらループを抜ける。

なぜ「止まる条件」が要るのか

ループである以上、止まる条件を決めておかないと終わりません。主な停止条件はこうです。

  • 完了:モデルが「もう道具は要らない、これが最終的な答え」と判断したとき。
  • ステップ上限:決めた回数を超えたら止める。
  • コストや時間の上限:使った量が上限に達したら止める。
  • エラーや承認待ち:危ない操作で人の確認を待つ、など。

停止条件がないと、エージェントは同じ失敗を延々と繰り返すことがあります。うまくいかないAPIを、少しずつ引数を変えて何度も叩き続ける、といった具合です。人間なら「これは詰まっている」と気づけますが、ループはそれを自力で認識できません。だから、外側の仕組みで止めてあげる必要があります。この「止め方」の設計は、ハーネスエンジニアリングの中心的な仕事のひとつです。

一周ごとに、コンテキストは積み上がる

見落としがちですが、一周するたびにコンテキストは増えていきます。20回ツールを呼ぶタスクなら、20回分の「考えた内容・実行した操作・観察した結果」がコンテキストに積み重なります。

これは2つの問題につながります。ひとつは、コンテキストの窓には限りがあるので、長いタスクはいずれ入り切らなくなること。もうひとつは、積み上がった情報が多すぎると、モデルがいま本当に大事な部分を見失いやすくなることです。だからこそ、何を残し何を捨てるか(次のレッスンで扱うコンテキストの設計)や、会話を圧縮するしくみが要ります。Omnigentの /compact のような機能も、この積み上がりへの対処です。

ループの外にあるもの

ループ自体は単純ですが、実用にするには外側の工夫が要ります。

  • ドゥームループ(doom loop)の検知:同じ失敗の堂々巡りを見つけて抜け出す。
  • 並行と分割:重い部分をサブエージェントに切り出して、別のループで進める。
  • ゴールの明示:達成条件を機械が確認できる形で与え、ループがいつ終わるべきかをはっきりさせる。2026年には、停止や達成条件を扱う機能(ゴールや繰り返しの指定)が各ハーネスに入りました。

これらは「モデルを変えずに、ループの回し方を良くする」工夫で、まさにハーネスエンジニアリングの実例です(本サイトのHarness Engineeringとは何かも参照)。

まとめ

  • エージェントループは、考える・動く・観察するを止まる条件まで繰り返すしくみです。
  • 止まる条件がないと、同じ失敗を延々と繰り返すことがあります。設計で止めます。
  • 一周ごとにコンテキストが積み上がるため、残す・捨てる・圧縮するの設計が要ります。

次は、このループで最も結果を左右するコンテキストの設計を詳しく見ていきます。

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