ハーネスエンジニアリングとは
最終更新: 2026年8月11日
この記事はAIエージェントの設計における「ハーネス」の話です。 同じ読みで自動車のワイヤーハーネス（配線）の設計を指す言葉もありますが、 そちらをお探しの場合はまったく別の分野になります。
ハーネスとは、AIモデルの外側にあるものすべてのことです。 使える道具、権限、動かす場所、記録、評価、人が確認する場所。 これらをまとめて設計するのが、ハーネスエンジニアリングです。
答えようとしている問いは、「この仕組みを、任せられる状態にするには何が要るか」。 「もっとうまく指示する方法」ではなく、 試して遊べる状態から、仕事を任せられる状態へ持っていくための設計です。
なぜ「モデルではなくハーネス」と言われるのか
2025年から2026年にかけて、この言い方をよく見るようになりました。 背景にあるのは、モデルを新しくしても期待したほど成果が変わらなかったという 経験の積み重ねです。
理由を分解すると、こうなります。
- 渡していない情報は、どんなモデルでも知らない。 社内の事情も、去年の経緯も、渡さなければ存在しません。
- 止め方を決めていなければ、賢いモデルほど長く粘る。 諦めが悪いぶん、費用がかさみます。
- 記録がなければ、失敗の理由がわからない。 推測で直すことになり、直ったのかも確かめられません。
- 評価がなければ、良くなったと言えない。 変えたあとに悪化していても気づけません。
どれもモデルの性能では埋まらない部分です。 「賢くすれば解決する」の範囲には限りがある—— これがハーネスという言い方が広まった理由だと考えています。
ハーネスを構成するもの（点検表）
「ハーネスを整える」と言われても漠然としているので、項目に分けました。 いまの環境がどこまで来ているかを確かめる用途で使えます。
| 要素 | 決めること | できていないと |
|---|---|---|
| ツール 何ができる状態にするか | 使える道具の一覧と、それぞれの説明。説明が曖昧だと、正しい道具を選べません。数を増やすほど選択を誤りやすくなるので、絞るのも設計のうちです。 | 道具が多すぎて、毎回違うものを選ぶ |
| 権限 何をさせないか | 読めるもの、書けるもの、外に出せるもの。取り返しのつかない操作（送信・支払い・削除・公開）は、はじめから触れない場所に置くのが確実です。 | 本番の環境に直接つながっていて、こわくて任せられない |
| 実行環境 どこで動かすか | 隔離された場所で動かすか、手元で動かすか。失敗しても巻き戻せる場所を用意しておくと、試せる回数が段違いに増えます。 | 失敗すると手作業で戻すことになるので、そもそも試せない |
| 記録 あとから何を追えるか | どんな指示で、何を渡し、どの道具をどう叩き、何が返ってきたか。これがないと、うまくいかない理由を推測するしかなくなります。 | 「なんかうまくいかない」で止まってしまう |
| 評価 良くなったと、どうやって言うか | 同じ課題を何度か流して結果を見る仕組み。数件でも用意しておけば、直したつもりで悪化したことに気づけます。 | 変更した結果が良くなったのか悪くなったのか、感想でしか言えない |
| 人が入る場所 どこで止めて確認するか | 全部を任せるか、全部を確認するかの二択ではありません。取り返しのつかない一歩の手前だけ止める、という設計ができます。 | 全部確認していて手間が減らない、または確認せずに事故る |
| 費用の見張り 暴走したときいくらで止まるか | 1回の実行にかかる上限を決めておく。ループが止まらない設計だと、気づいたときには請求が跳ねています。 | 使った量が事後にしかわからない |
順番をつけるなら
全部を一度に整えるのは無理なので、効く順に並べます。
- 記録を残す。 何を渡して何が返ってきたかが見えるだけで、直す速さが変わります。 いちばん地味で、いちばん効きます。
- 取り返しのつかない操作を、触れない場所に置く。 送信・支払い・削除・公開。ここを塞いでおけば、あとは安心して試せます。
- 失敗しても巻き戻せる場所を作る。 戻せるとわかっていると、試す回数が一気に増えます。
- 上限を決める。 試行回数と費用。決めていないと、暴走に気づくのが請求のときになります。
- 評価を数件つくる。 完璧な評価は要りません。「これができれば合格」を3つ書き出すだけでも、 変更のたびに確かめられるようになります。
- 人が入る場所を1か所決める。 全部確認するのでも、全部任せるのでもなく、 取り返しのつかない一歩の手前だけ止める。
よくある勘違い
「道具をたくさん持たせれば賢くなる」
逆のことが起きます。選択肢が増えるほど、選び間違いも増えます。 使う道具を絞り、説明を具体的に書くほうが、結果は安定します。
「全部自動でやらせるのがゴール」
ゴールは自動化そのものではなく、安心して任せられる範囲を広げることです。 人が確認する場所が1か所あるだけで、任せられる範囲は大きく広がります。 確認をゼロにしようとすると、かえって任せられる範囲が狭くなります。
「ハーネスを整えればプロンプトは適当でいい」
なりません。ハーネスはいちばん外側の層で、 その中ではプロンプト・コンテキスト・ループが動き続けています。 外側を整えても、中で出力が毎回ばらついていれば結果はばらつきます。
層として見る
ハーネスは、AIエージェントの設計を語る5つの層のいちばん外側にあたります。 内側から、プロンプト → コンテキスト → ループ → グラフ → ハーネス。 上の層は下の層の代わりになりません。
- AIエージェント設計の5階層マップ — 全体像と、症状からの切り分け
- グラフエンジニアリング — 処理のつなぎ方と、移行の目安
- コンテキストエンジニアリング — 何を渡すか。費用にも直結します
費用の見張りをするなら、トークン数の計算で1回あたりの量を、 AI導入の費用対効果で月あたりの元が取れているかを確かめられます。
本記事は2026年8月時点で見られる用語の使われ方を整理したものです。これらの言葉は新しく、定義や範囲は書き手によって異なります。特定のフレームワークやサービスを推奨するものではありません。