# ハーネスエンジニアリングとは？AIエージェントを仕組みで安定させる設計を解説

- URL: https://www.waltsu.co.jp/magazine/ai/harness-engineering/
- カテゴリ: AI活用 > AIエージェント
- 執筆: 藤井 俊輔（代表取締役）
- 公開日: 2026-10-06 / 最終更新日: 2026-10-29
- 発行: waltsu株式会社（waltsu MAGAZINE）

## こんな人におすすめ

- AIエージェントを使い始めたが、出来が毎回ぶれる
- ハーネスエンジニアリングという言葉の出どころを正確に知りたい
- プロンプトやコンテキストとの違いを社内で説明したい

AIエージェントに仕事を任せると、同じ指示でも出来がぶれ、一度直した失敗をまた繰り返すことがあります。モデルを替えても指示文を書き直しても収まらない。そこで2026年に入って広まったのが「ハーネスエンジニアリング」という言葉です。 ハーネスエンジニアリングとは、AIモデルの外側にある指示・道具・検証・権限などの仕組みを設計し、エージェントに安定した仕事をさせる考え方です。ハーネスはモデルを縛る道具ではなく、正しくやれる確率を上げ、間違いに自分で気づかせる仕組みです。本記事では、名付けの経緯と定義の違い、構成要素、プロンプト・コンテキストとの違い、小さな始め方を、2026年10月時点の一次情報で整理します。

**この記事のゴール（読了目安 約8分）**：ハーネスエンジニアリングの定義の幅を説明でき、自社のAIエージェントに「同じ失敗を繰り返させない」最初の仕組みを1つ作れるようになる。

## この記事の結論

- ハーネスはモデル以外の仕組みで、2026年2月に今の名前が付いた
- 定義には「モデル以外の全部」と「利用者が足す工夫」の幅がある
- 先回りの指示と後からの検知を組で持ち、繰り返す失敗は機械で止める
- 物差しは成功率より、同じ失敗が再発するかどうか

## ハーネスエンジニアリングとは

LangChainの定義では、エージェントのうちモデル以外の仕組みはすべてハーネスです。続いて、2026年2月に今の名前が付いた経緯をたどります。

### モデル以外のすべてを設計する

ハーネスは英語で馬具や安全帯を指す言葉です。LangChainは[2026年3月の解説](https://www.langchain.com/blog/the-anatomy-of-an-agent-harness)で「エージェント＝モデル＋ハーネス」と表し、**モデル以外のコード・設定・実行の仕組みはすべてハーネス**だと定義しました。[AIエージェントの仕組み](https://www.waltsu.co.jp/magazine/ai/about-ai-agent/)や、[LLMとの関係](https://www.waltsu.co.jp/magazine/ai/ai-agent-llm/)は、それぞれ別記事で解説しています。

### 名付けられたのは2026年2月

この言葉に名前を与えたのは、[HashiCorp共同創業者](https://mitchellh.com/about)のミッチェル・ハシモト氏が[2026年2月5日に公開したブログ](https://mitchellh.com/writing/my-ai-adoption-journey)です。氏は「業界で定着した用語があるかは知らない」と断ったうえで、エージェントが間違えるたびに、二度と同じ間違いをしない仕組みを作ることを「ハーネスエンジニアリング」と呼びました。その6日後には、OpenAIも[同じ語を題名に掲げた記事](https://openai.com/ja-JP/index/harness-engineering/)を公開しています。

![左にモデルのカードを1枚、右にハーネスの部品である指示・道具・文脈と記憶・検証・権限と隔離・記録と観測の6枚のカードを横に並べ、エージェントはモデルとハーネスでできていると示した図](https://www.waltsu.co.jp/wp-content/uploads/2026/10/harness-engineering01.png)

## 定義は人によって幅がある

同じ「ハーネス」でも、指す範囲は書き手によって違います（日付順）。

- **Anthropic（2025年11月）**: [長時間動くエージェントの記事](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)で、自社の開発キットを「汎用のエージェントハーネス」と呼んだ
- **ハシモト氏（2026年2月）**: 間違いを二度起こさせない工夫。指示ファイルへの追記と、自動で確かめる道具の2つ
- **OpenAI（2026年2月）**: エンジニアの仕事を、環境の設計・意図の明確化・フィードバックの仕組みづくりへ移した実験の報告
- **LangChain（2026年3月）**: モデル以外のすべて
- **Thoughtworks（2026年4月）**: 利用者が[コーディングエージェントの外側に作るもの](https://martinfowler.com/articles/exploring-gen-ai/harness-engineering.html)に絞って整理

広い定義は「モデル以外の全部」、狭い定義は「利用者が足す工夫」です。**社内で使うときは、どちらの意味かを先にそろえる**と議論がかみ合います。

![2025年9月のAnthropicのコンテキストエンジニアリングの解説から、2026年2月5日のハシモト氏の命名、2月11日のOpenAI、3月のLangChain、4月のThoughtworksまで、ハーネスという言葉の使われ方を並べた年表](https://www.waltsu.co.jp/wp-content/uploads/2026/10/harness-engineering02.png)

## なぜ今注目されるのか

きっかけは、エージェントに長く大きな仕事を任せる実例が出てきたことです。OpenAIは、人が1行もコードを書かずに社内向けの製品を作る実験を報告しました。約5か月で約100万行、当初3名のエンジニアで約1,500件の変更をまとめています。

報告によると、初期の遅れの原因はモデルの能力ではなく、環境が十分に定義されていなかったことでした。Anthropicも、最先端のモデルでも大まかな指示だけで繰り返し動かすと、一度に全部作ろうとする、途中で完了と言ってしまう、といった失敗が出たと書いています。**出来を左右したのはモデルの外側**だった、という報告が続いたわけです。[AIで開発の進め方がどう変わるか](https://www.waltsu.co.jp/magazine/ai/ai-driven-development/)は、別記事で解説しています。

## ハーネスを構成する6つの要素

範囲を広く取ると、ハーネスは次の6つに分けられます。各社の文書が挙げる部品を、本記事でまとめ直したものです。

| 要素 | 設計するもの | 例 |
|---|---|---|
| 指示 | 守るべき作法と地図 | エージェント向けの指示ファイル、手順書 |
| 道具 | 使える操作 | 検索、ファイル操作、外部サービスとの接続 |
| 文脈と記憶 | 何を見せ、何を残すか | 進捗メモ、作業の履歴、要約 |
| 検証 | 正しくできたかの判定 | テスト、自動の書式チェック、AIによるレビュー |
| 権限と隔離 | 触ってよい範囲 | 読み取り専用の設定、隔離した作業環境 |
| 記録と観測 | 何が起きたかを見る仕組み | 操作の記録、ログ、画面の撮影 |

[権限を段階で渡す考え方](https://www.waltsu.co.jp/magazine/security/ai-agent-security/)は、別記事で解説しています。

## プロンプト・コンテキストとの違い

3つは置き換わる関係ではなく、内側に入れ子になる関係です。

| 項目 | プロンプト | コンテキスト | ハーネス |
|---|---|---|---|
| 対象 | 1回の指示文 | モデルに渡す情報全体 | モデルの外側の仕組み全体 |
| 問い | どう書けば伝わるか | 何を見せるか | どうすれば正しくやり続けるか |
| 主な手段 | 言い回し・例示・役割 | 検索・要約・記憶の出し入れ | 道具・検証・権限・記録 |

Anthropicは2025年9月、コンテキストエンジニアリングを[プロンプトエンジニアリングの自然な発展](https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents)と位置づけました。Thoughtworksの記事は、利用者が作るハーネスをコンテキストエンジニアリングの一形態としています。**指示文の工夫はハーネスの中に残り続けます**。

## 先回りの指示と後からの検知

Thoughtworksの整理では、ハーネスの働きは2つに分かれます。

- **先回りの指示**: 作業の前に方向を示し、最初から正しくやれる確率を上げる
- **後からの検知**: 作業の後に結果を確かめ、エージェント自身に直させる

片方だけでは足りません。検知だけなら同じ間違いを繰り返し、指示だけならルールが守られたかが分かりません。検知には、テストのように**速く毎回同じ結果を返す機械の判定**と、AIのレビューのように意味まで見られるが遅く揺れる判定があります。OpenAIは、自作のチェックの誤り表示に直し方を書き込み、エージェントに渡しています。

## よくある3つの誤解

- **OpenAIかAnthropicが提唱した**: 名前を付けたのはハシモト氏のブログ。Anthropicは前年から、製品や仕組みを指してハーネスと呼んでいた
- **ハーネスは安全装置のこと**: 縛るだけでなく、道具や記憶を与えて正しくやれる確率を上げる側も含む
- **賢いモデルなら要らない**: OpenAI自身、一連の作業を任せられたのはこのリポジトリの構造と道具に大きく依存し、同じ準備なしに一般化できないと書いている

## 小さく始める4つの手順

日々の失敗から1つずつ足していきます。

- **失敗を書き留める**: エージェントが間違えた内容と、そのときの指示を残す
- **指示に1行足す**: 誤ったコマンドや参照先など、単純な失敗は指示ファイルに書く
- **繰り返す失敗は機械で止める**: 2回目が出たら、テストや自動チェックで検出できないかを考える
- **人が見る場所を決める**: 公開・送信・削除など、戻せない操作の前だけは人が確かめる

ハシモト氏も、指示ファイルの各行がエージェントの悪い振る舞い1つずつに対応していると書いています。**ハーネスは設計図から作るより、失敗の記録から育てる**ほうが確実です。

## つまずきやすい失敗

- **指示ファイルを百科事典にする**: OpenAIは巨大な指示ファイルが大事な制約を埋もれさせたため、約100行の目次にして詳細を別の文書へ分けた
- **何でも縛る**: 守るべき境界だけを決め、内側のやり方は任せる
- **確かめるのが人の目だけ**: 生成量が増えると、人の確認が追いつかなくなる
- **後始末を先送りする**: OpenAIのチームは一時期、毎週金曜（週の20%）をAIが生んだ粗い成果物の片付けに使っていた

## 【プロの視点】成功率より再発を数える

エージェントの出来が悪いとき、議論は「どのモデルを使うか」「指示文をどう書くか」に向かいがちです。けれど、ハーネスの良し悪しを測る物差しは成功率ではありません。**一度見た失敗が、もう一度起きるかどうか**です。

モデルは確率で動くので、どれだけ整えても間違いはゼロになりません。見るべきは間違いの数より、同じ間違いの2回目です。2回目が起きたなら、それはモデルの限界ではなく、ハーネスに足りない部分が残っている合図です。Thoughtworksの記事も、同じ問題が何度も起きたら指示と検知を直す、という繰り返しを人の仕事に置いています。

最初は指示に1行足し、それでも起きるなら機械の判定に移します。OpenAIも、文書で足りないルールはコードに昇格させると書いています。**文章のルールは見落とされることがあり、機械の判定は毎回働く**からです。

明日やる最初の一歩は、直近でエージェントに2回言い直した指摘を1つ選び、指示で防ぐか、機械で止めるかを決めることです。

![失敗を見つける、記録する、指示に1行足す、繰り返すなら機械で止める、の4段階を左から右へ並べ、右端から左端へ戻る矢印で次の作業に生かす流れを示した図](https://www.waltsu.co.jp/wp-content/uploads/2026/10/harness-engineering03.png)

## 【waltsu視点】注意を確認から改善へ

waltsuが軸にしているのは、時短ではなく試行回数です。エージェントの試行回数を決めるのは、作る速さよりも人の注意の量です。OpenAIも、唯一の希少な資源は人の時間と注意だと書いています。

人が毎回の結果を確かめる方式では、注意は1回の試行ごとに消えます。ハーネスに足した1行は違い、OpenAIの言葉を借りれば、一度書き込めばあらゆる場所に同時に適用されます。**確認に使った注意はその1回で消え、改善に使った注意は以降の全部に役立ちます**。

だからハーネスへの投資は守りではなく、試せる回数の上限を引き上げる投資です。人の仕事は、結果を全部見ることから、同じ指摘を二度しないで済む仕組みを足すことへ移ります。

明日やる最初の一歩は、今週エージェントの結果を確かめた時間を書き出し、そのうち同じ指摘の繰り返しがどれだけあったかを数えることです。

![左に試行ごとに人の確認が1回ずつ要る並び、右に一度足した仕組みが以降のすべての試行に効く並びを置き、注意を確認から改善へ移すと試せる回数が増えることを示した左右比較の図](https://www.waltsu.co.jp/wp-content/uploads/2026/10/harness-engineering04.png)

## まとめ

ハーネスエンジニアリングは、AIエージェントのモデル以外の部分を設計し、正しくやれる確率を上げ、間違いに自分で気づかせる考え方です。言葉は新しくても、やることは失敗を記録し、指示と検知を1つずつ足していく地道な作業です。

エージェントに何を任せ、どこで止め、何を機械に確かめさせるかの線引きに迷う場面が出てきたら、waltsuが業務に合わせた仕組みづくりから運用までご支援します。

## よくある質問

**Q. ハーネスとは何の訳？**  
A. 英語で馬具や安全帯を指す言葉です。AIの文脈では、モデルを包んで仕事ができる形にする、外側の仕組み全体を指します。

**Q. ガードレールとの違いは？**  
A. ガードレールは危ない出力や操作を止める仕組みで、ハーネスの一部です。ハーネスはそれに加え、道具や記憶を与えて正しくやれる確率を上げる側も含みます。

**Q. 開発者以外にも関係ある？**  
A. あります。言葉はコーディングの現場で生まれましたが、記事作成や問い合わせ対応でも、指示・確認・権限を仕組みにする考え方はそのまま使えます。

**Q. フレームワークを入れれば足りる？**  
A. 足りません。フレームワークや開発キットは土台を提供しますが、自社の業務に合わせた指示や検証は利用者が足す必要があります。

**Q. 最初に何を作ればいい？**  
A. エージェント向けの指示ファイルを1つ作り、失敗が出るたびに1行ずつ足すことです。同じ失敗が2回出たら、機械で検出できないかを考えます。

## 執筆者

**藤井 俊輔**（代表取締役）ベンチャー企業の外部CMOや水族館のマーケティング担当などに従事。オンライン/オフライン問わず集客を中心としたマーケティング施策に強み。

プロフィール: https://www.waltsu.co.jp/magazine/supervisor/shunsuke-fujii/

この記事は waltsu 公式ブログの記事（https://www.waltsu.co.jp/blog/harness-engineering/）をもとに再編集したものです。