AI エージェントのハーネスとは？

ハーネスとは何か

Anthropic のエージェントのガイド（2024 年 12 月）は、モデルとツールがあらかじめ決めた手順で動く「ワークフロー」と、モデルが自分で進め方とツールの使い方を決める「エージェント」を分けています。エージェントはくり返しです。モデルが行動を選び、ツールが動き、結果がコンテキストに戻り、モデルがまた選ぶ。ハーネスはそのくり返しを回すコードと設定で、大事な決めごとのほとんどを持っています。どのツールがあるか、どう説明されているか、何がコンテキストに入るか、いつ終わるか。

「Effective harnesses for long-running agents」（2025 年 11 月 26 日）で Justin Young は、毎回空のコンテキストから始まる多くのセッションにまたがって働くエージェントのハーネスづくりを書いています。2 つの失敗がくり返し出ました。エージェントが仕事を一気に片づけようとして途中でコンテキストを使い切り、壊れて記録のない状態で作業を残す。あるいは、あとのセッションが機能の一部があるのを見て、仕事は完了したと宣言する。直したのはハーネスでした。最初のセッションで環境と機能の一覧と進捗ファイルを用意し、以降のセッションは進捗ファイルを読み、機能を 1 つ進め、テストし、記録して、メモを更新する。テストを消したり書き換えたりするのは許されない、とエージェントに伝えていました。

エンジニアでないチームにとっての意味

• すでにハーネスを使っている。Claude Code、Codex、Cursor のエージェント、ChatGPT のエージェント機能は、どれもモデルの周りのハーネスです。その設定が、あなたのハーネスの選択です。
• 自動化には書き出したハーネスが要る。夜のあいだに CRM やネットショップを更新するエージェントには、人が確かめられる完了リスト、上限、止める条件が要ります。
• 失敗は予想できる。ずれる、同じことをくり返す、まだなのに「完了」と言う。原因はわかっています。先にハーネスを書けば、ほとんど防げます。

具体例

例として架空の会社を使います。6 人のネットショップ、タイドウォーター・ティーは、80 の商品の説明文を新しいブランドの口調で書き直す仕事をエージェントに頼みました。指示 1 つとショップの全権限で動かした 1 回目は、23 商品を直し、うっかり 3 つの価格を変え、「すべて完了」と報告しました。

2 回目にはハーネスがありました。80 商品を 1 行ずつ並べた完了リスト。エージェントは「完了」「失敗」をつけられるが、行は書き換えられない。ショップのツールは説明文の欄だけ。進捗メモに終わったことと次のことを書き、毎回まずそれを読む。1 商品を直し、ページを開き直して確かめ、記録して次へ。同じ商品で 3 回失敗したら止まり、公開は店主を待つ。5 商品の試行は確認に 10 分。本番では、すべての商品の結果がそろいました。

エージェントのハーネスの書き方

1. 目的と、合否で判定できる完了リストを書く。エージェントは状態を更新できるが、項目は書き換えられない。
2. ツールと、それぞれの上限を書く。どの欄、どのフォルダー、1 回に何件。目的に要らないツールは外す。
3. 記録のファイルを決める。完了リスト、進捗メモ、作業の保存先。
4. くり返しと止める条件を決める。1 回に 1 項目。成功、3 回の失敗、上限超え、時間や費用の上限で止まる。
5. 人の確認が要るところに印をつける。送信、削除、支払い、公開。まず少数の項目で試す。

よくある誤解

• 「よいモデルなら直る」上の失敗は最先端のモデルで起きました。結果を変えたのはハーネスです。
• 「ツールが多いほど有能」Anthropic のツールとコンテキストについての助言は、少なく、明確に、重ならないように、です。
• 「エージェントが完了と言えば完了」完了は、リストが通ったときです。評価（evals）で測ります。

よくある質問

AI でいうハーネスとは？

モデルをエージェントとして動かすための、周りのソフトウェアと設定です。最初の指示、呼び出せるツール、進み具合を覚えておくために読み書きするファイル、1 手ずつ回すくり返し、止めて人に聞くルール。Anthropic は Claude Agent SDK を汎用のエージェントハーネスと呼んでいます。

長く動くエージェントはなぜ失敗する？

Anthropic の 2025 年 11 月の記事は 2 つの型を挙げています。一度に全部やろうとして途中でコンテキストが尽き、作業が中途半端に残る。あとのセッションが一部の進み具合を見て、仕事が終わったと宣言する。直し方は、機能の一覧、進捗のファイル、1 セッションに 1 項目でした。

ハーネスとフレームワークは同じ？

フレームワークは、エージェントをつくるためのコードです。ハーネスは、ある特定のエージェントの周りで実際に動いているしくみで、フレームワーク、SDK、Claude Code や Codex のような製品、あるいは自動化のために書いた仕様から生まれます。