【今さら聞けない】ハーネスってなんだろう？

AIエージェントの話題で「ハーネス（harness）」という言葉を目にする機会が増えました。ところがこの言葉は、話し手によって指しているものが違います。モデルの外側を組み上げる作業を指すこともあれば、モデルを動かす製品そのものを指すこともあり、昔ながらのテスト用の仕組みを指すこともあります。本稿では、ハーネスという言葉がどのように使われているかを整理します。用語が多義的であることを知っておくだけで、記事や資料の読み違いをかなり減らせます。

Q. そもそもハーネスとは何ですか？

A. もともとは馬具、つまり馬を御者の制御下に置く器具を指す英単語です。ソフトウェア工学では「テストハーネス（test harness）」として長く使われてきました。本番の環境がなくても、代替品（スタブ）と実行を駆動する仕組み（ドライバ）を組み合わせて、コードを「制御でき、観察できる状態に繋ぎとめる」ための仕組みです（Wikipedia「Test harness」）。

「複雑な動力を、観察と制御の仕組みに繋ぐ」という比喩が、そのままAIエージェントの文脈に持ち込まれました。

Q. AIの文脈では、どの意味で使われていますか？

A. 大きく分けて、次のように使われています。

使われる文脈	意味
ソフトウェアテスト（従来）	テスト実行を補助するスタブ・ドライバの集合体
LLMエージェント全般	モデルを包む実行環境の総体（ツール・ループ・メモリ・制約）
利用企業・現場のエンジニア	自社の環境と目的に合わせて構築した、エージェントを精度高く動かすためのワークフロー／ループ設計（ルール文書・フック・権限・メモリ・停止条件）
モデル開発元・製品	Claude Code や Codex のように、モデルを包んで動かす実行系そのもの。モデルの挙動や評価スコアはハーネス次第で変わる
OpenAI ハーネスエンジニアリング（2026年2月）	エージェントが動く「世界」を設計するエンジニアリング実践そのもの
Anthropic ハーネス設計（2026年3月）	長期タスクを分解・専門化する複数エージェントのフレームワーク

OpenAI は2026年2月、公式ブログ「Harness engineering: leveraging Codex in an agent-first world」で、3〜7人のチームが100万行の本番コードを人手入力なしに出荷した事例を紹介しました。そこでエンジニアの主な仕事は「コードを書く」ことではなく、「エージェントが動く環境（ルール・フィードバックループ・ドキュメント構造・依存順序）を設計すること」だと述べています。

Anthropic は2026年3月24日付のエンジニアリングブログ「Harness design for long-running application development」で、ハーネスを「モデルが複雑なタスクを実行する際に機能する構造化フレームワーク」と定義し、Planner（計画）・Generator（生成）・Evaluator（評価）の3エージェント構成を例示しています。コンテキストのリセット、関心の分離、外部からの評価が設計原則として挙げられています。

LangChain はより端的に表現しています: "If you're not the model, you're the harness."（モデルでないものはすべてハーネスだ）

Q. 現場で言う「ハーネス」と、モデル開発元が言う「ハーネス」は同じものですか？

A. 指している層が違います。

現場のエンジニアや推進担当が「ハーネスを組む」「ハーネスを整える」と言うとき、多くは自社の環境と目的に合わせて構築したワークフローを指しています。エージェントに読ませるルール文書、作業の前後に自動で走らせる検査、触ってよいツールと権限の範囲、記憶の持たせ方、どこで止めるかというループの設計。これらを自社の業務に合わせて組み上げたものが、この文脈の「ハーネス」です。ハーネスエンジニアリングという言葉も、この意味で「モデル以外のすべて（記憶・ツール・権限・フック・観測）を設計する仕事」として広まっています。

一方、モデル開発元や製品開発の文脈では、モデルを包んで動かす実行系そのものを指します。Claude Code、Codex、Cursor といったツールは、それ自体が「Claude や GPT というモデルのハーネス」です。同じモデルでもハーネスが変わればエージェントとしての挙動や評価スコアが変わるため、開発元はモデルとハーネスを分けて語ります。「モデルの性能」と「ハーネスの性能」は別物として測られます。

つまり、前者は「製品の上に自分たちが組んだ設定と手順」、後者は「その製品そのもの」です。どちらも「モデルの外側」を指す点では同じですが、粒度が一段違います。解説記事や発表を読むときは、書き手がどちらの層の話をしているかを先に見分けると、内容がすっと入ってきます。

Q. 当社はどの意味で使っていますか？

A. 当社が企業のAI導入で「ハーネス」と言うときは、原則として前者、つまりその企業の業務と環境に合わせて組み上げるワークフローとループの設計を指します。どのモデルを使うかより、モデルの外側をどう組むかで成果が決まる、という考え方に基づくものです。製品そのものを指す場合や、複数エージェントの協調設計を指す場合は、その都度そう明記します。

社内で議論するときも、「ハーネス」という一語で通さず、「ルール文書のことか」「停止条件のことか」「製品のことか」と一段具体的な言葉に置き換えることをおすすめします。用語の意味を最初に揃えておくことは、技術的な深さがなくても誰でもできる工夫です。

参考

支援内容とご相談

課題整理からシステム実装、人材育成まで。AIXの支援内容をご紹介します。ご相談はお問い合わせフォームから受け付けています。

お問い合わせ ↗事業紹介を見る ↗