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

AIエージェントに仕事を任せると、同じ指示でも出来がぶれ、一度直した失敗をまた繰り返すことがあります。モデルを替えても指示文を書き直しても収まらない。そこで2026年に入って広まったのが「ハーネスエンジニアリング」という言葉です。

ハーネスエンジニアリングとは、AIモデルの外側にある指示・道具・検証・権限などの仕組みを設計し、エージェントに安定した仕事をさせる考え方です。ハーネスはモデルを縛る道具ではなく、正しくやれる確率を上げ、間違いに自分で気づかせる仕組みです。本記事では、名付けの経緯と定義の違い、構成要素、プロンプト・コンテキストとの違い、小さな始め方を、2026年10月時点の一次情報で整理します。

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

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

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

ハーネスは英語で馬具や安全帯を指す言葉です。LangChainは2026年3月の解説で「エージェント＝モデル＋ハーネス」と表し、モデル以外のコード・設定・実行の仕組みはすべてハーネスだと定義しました。AIエージェントの仕組みや、LLMとの関係は、それぞれ別記事で解説しています。

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

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

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

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

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

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

なぜ今注目されるのか

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

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

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

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

権限を段階で渡す考え方は、別記事で解説しています。

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

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

Anthropicは2025年9月、コンテキストエンジニアリングをプロンプトエンジニアリングの自然な発展と位置づけました。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つ選び、指示で防ぐか、機械で止めるかを決めることです。

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

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

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

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

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

よくある質問

ハーネスとは何の訳？

英語で馬具や安全帯を指す言葉です。AIの文脈では、モデルを包んで仕事ができる形にする、外側の仕組み全体を指します。

ガードレールとの違いは？

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

開発者以外にも関係ある？

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

フレームワークを入れれば足りる？

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

最初に何を作ればいい？

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

まとめ

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

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