AIエージェントのハーネスとは？6つの設計項目【2027年】

AIエージェントのハーネスとは何か、何を書けばよいのか迷っていませんか。モデルの外側の仕組みを、社員へ渡す仕事の決まりと、公式の設定から整理します。

この記事の監修者

鈴木 晋介株式会社WEBMARKS 代表取締役

同志社大学を卒業後、設備メーカーの海外営業を経て2016年に独立。旅行・医療などのメディアを自ら運営し、SEOとWeb広告で検索上位を数多く獲得してきました。いまはWebマーケティングのスクールと法人研修を運営しながら、11部署57名のAIエージェントと会社を回しています。

公的な認定・承認：神奈川県 経営革新計画 承認／経済産業大臣認定講座／厚生労働大臣指定講座／経済産業省 リスキリング補助事業者

代表プロフィール会社概要X @WEBMARKS2

AIエージェントのハーネスとは？頭の外側で動かし止める仕組み

ハーネスは、モデルを呼び、道具を実行し、止める時を決める外側の仕組みです。この記事は、ソフトウェア配信の製品Harnessとは別の意味を扱います。

モデルが考える頭なら、ハーネスは頭の外で動きを支える仕組みです。使える道具だけでなく、止め方と記録まで一緒に見ると分かります。

一言の定義

ハーネスは、高い所で働く人につける安全帯にたとえられます。自由に動く部分を残しつつ、外れてはいけない線を設ける物です。AIでは止める線だけでなく、道具の実行や記録を支える部分も含めて使います。

モデルは、言葉を読み書きする頭にあたる部分です。モデルへ依頼を渡し、道具を動かして結果を返し、終わりを決める部分が外にあります。よい答えを考えることと、仕事を続けて実行することを分けて見るための言葉です。

Hugging Faceの用語集でハーネスの位置を確かめる画面です。

赤枠1の実行の層と、赤枠3のAGENTの中にあるHARNESSを見ます。頭、指示、実行の役割を分け、自分が整えたい場所を選んでください。

Hugging Faceの用語集は、モデルを呼び、道具の要求を扱い、いつ止めるかを決める層と説明します。スキャフォールドは、モデルが従う指示や道具の説明、出力の形です。工事の足場のように、考える時の振る舞いを支える物にたとえられます。

モデル＋ハーネス＝エージェント

この式は、考える本体だけでなく、それを動かす仕組みまで見る整理です。Hugging Faceの図は、モデル、指示、ハーネスを全体の内側へ置いています。モデル単体の能力と、道具を使う仕事全体を混ぜないために使います。

国のAI事業者ガイドラインは、目標のため環境を感知し、自律的に行動するAIと定義します。自律には程度の違いも含まれる説明です。外側で任せる範囲と止まる所を決めることが、仕事へ渡す時の論点になります。

大手が製品にした

Microsoftの開発者向け公式は、2026年10月28日にCopilot harnessを紹介しました。

https://x.com/msdev/status/2115488391043449336

発表は、Foundry Agent Serviceで、指揮、道具、文脈、制御を受け持つ基盤です。自社で整える場合も、既にある部品と、自分で決める設定を分けてください。

AI解説者のAkshay Pachaar氏は、2026年4月6日にハーネスの構成を紹介しました。

https://x.com/akshay_pachaar/status/2041146899319971922

発信は、同じモデルでも、周りの流れや記憶、道具の設計で実力が変わるという見方です。AIの名前を替える前に、周りの指示と設定を一度書き出してください。

ハーネスとモデル・スキャフォールド・オーケストレーターの違いは？

モデルは考える本体、スキャフォールドは従う指示、ハーネスは実行を回す仕組みです。オーケストレーターは、複数の担当をまとめる上位の役です。

指示書も道具も、全部ハーネスと呼ぶのではないのですか。考える本体、従う決まり、実行する仕組みを、誰が用意するかで分けたいです。

4語の役割

オーケストレーターは、複数の現場をまとめる班長にたとえられます。担当へ仕事を配ることと、各担当の実行を回す仕組みは、見る段が違います。Hugging Faceの整理を使うと、似た語を同じ部品として置き換えずに読めます。

エージェントは、これらを使いながら、目標へ向けて動く全体です。AIエージェントとはで、定義やほかの技術との違いを整理します。

誰が何を書くか

コードを書かない担当者も、何を任せ、何を終わりとするかは決められます。一方、操作を遮る設定や実行処理は、製品の機能と実装の担当を確認します。指示書へ書いたことと、設定として動くことを同じにはしません。

たとえば、成果物を保存する場所を担当者が指示書へ書く場面です。保存前にその場所へ書いてよいかを判定する処理は、権限やhooksへ対応します。hooksは、動作の決まった所へ差し込む自動の検問所のような機能です。

この分け方は、どちらの人が上という話ではありません。Hugging Faceの用語は、指示を整える仕事と実行を制御する仕事を分ける物差しです。担当者と開発する人が、同じ6項目を見ながら設計できるようにします。

なぜ今、AIエージェントのハーネスが注目されるのか？

同じモデルでも、道具の渡し方や結果の確かめ方で、仕事の結果が変わるためです。モデルの選び直しだけでなく、周囲を測って直す設計が論点になっています。

自分の業務から、止まる所や失敗する所を一つ選びましょう。モデルの名前より先に、道具の渡し方と評価する仕組みを記録してください。

同じモデルでも差が出る

LangChain創業者のHarrison Chase氏は、2026年9月9日に改善する場所を述べました。

https://x.com/hwchase17/status/2097720484431360365

同氏は、道具の境目の文脈、出す時機、失敗からの立て直し、後の計測を挙げています。自社の失敗でも、どの境目で必要な情報が抜けたかを記録してください。

文脈は、仕事を理解するために渡す背景のメモ帳のような物です。道具の結果を次の判断へどう渡すかも、そのメモの受け渡しに含まれます。道具があるだけでなく、必要な時に必要な形で渡す設計を見ます。

Anthropicのハーネス設計の記事は、作る役と評価する役を分ける整理です。計画、作る、評価の役を分け、直す所をはっきりさせる考え方です。一つのAIへ全部を頼む形だけが、整え方ではありません。

同記事は、モデルの進化で不要になる部品もあるため、一つずつ外して測ると説明します。追加した決まりを増やし続けるだけでなく、効いたかを評価する話です。何を外し、どの結果が変わったかを記録することで、次の変更と比べられます。

国の標準づくり

NISTは、2026年2月17日にAI Agent Standards Initiativeを発表しました。エージェントが安全に動き、互いにつながるための標準づくりです。業界主導の標準や、公開の接続規約、身元確認の研究などを柱にしています。

NISTの発表が、全てのハーネスの実装手順を定めたという意味ではありません。国の標準づくりと、個別の製品の設定を区別して読みます。全体の部品と受け渡しは、AIエージェントの仕組みで解説します。

ハーネスの中身は？6つの設計項目と書き方

できること、触れる範囲、試す回数、止まる条件、相談先、記録の6項目です。道具の名前だけを並べず、自分の仕事に当てはめて一つずつ書きます。

何を任せるかは、道具の一覧だけでは決まりません。触る場所、回数、止まる時、相談する人、残す記録まで、同じ紙へ書いておきましょう。

できること

たとえば、問い合わせの返信案を作る時は、返信の下書きまでと書きます。保存する道具と、送信する道具を同じ許可へまとめません。後で見るAgent SDKのPermissionsは、使う道具の承認を決める部品です。

できることは、会社の目的から決める仕事の範囲です。返信案を作る仕事なのか、情報を探す仕事なのかを、最初の一行へ書きます。製品の機能の数でなく、その仕事に必要な道具の実行を選びます。

触れる範囲

たとえば、月次報告の下書きなら、指定した資料のフォルダだけを読ませます。ほかの部署のファイルや鍵を、一緒に読める前提にしません。NISTのNCCoEの概念文書も、最小限の権限をどう決めるかを問いにしています。

権限は、入ってよい部屋を決める鍵の範囲にたとえられます。読む、書く、外へ送るという操作ごとに、許す対象を分けます。NCCoEは、動きを読み切れないエージェントへ権限をどう与えるかを扱う草案です。

この問いは、モデルへ秘密を見せるかだけの話ではありません。どのアカウントで、どの道具に、どこまで届く力を渡すかも関係します。仕事の依頼と、道具の設定の両方で範囲をそろえる必要があります。

何回試すか

たとえば、資料の取得に失敗した場合は、試す上限を決めてから任せます。回数は、その業務で許せる試行から自分で定めます。公式のエージェントループの説明には、最大ターン数と予算の設定があります。

ターンは、AIが考え、道具を呼び、結果を受け取る一巡のような単位です。やり直しの上限を指示書へ書くだけでなく、設定にも対応させます。後の画面3では、既定で制限がない欄を確認します。

いつ止まるか

たとえば、下書きの仕事なら、送信へ進む前に止めて人へ返すと書きます。失敗が上限へ達した時と、重要な操作の前も別々に決めます。止まる条件には、正常に終わる条件と、途中で中断する条件があります。

Agent SDKの上限に達した結果と、人へ承認を求める動作は同じではありません。上限で返す結果を受け取り、誰がその後を判断するかを決めます。成功の返事だけで、外のシステムが変わったとは扱わない完了条件も必要です。

誰に相談するか

たとえば、料金や契約の判断が必要なら、担当する人と連絡方法を書きます。部署名だけでなく、その仕事の判断を受け取る役を決めます。NCCoEの草案は、人の承認とエージェントの身元をどう結ぶかも問いにしています。

本人確認は、誰が操作しているかを見る受付のような物です。権限を別の担当へ渡す場合も、誰の代わりに動くかを記録します。相談してよい人を定めることと、操作を許可する人を定めることを合わせます。

相談先が返事をするまで、AIがどこまで進んでよいかも書きます。下書きを保存して待つのか、全て止めるのかを、同じ指示の中で決めます。設定で表現できる所と、人が判断する所を区別するための項目です。

記録

たとえば、調査の表を作るなら、開いた資料と、使った道具、返った結果を残します。最後の答えだけでは、何を根拠にしたかを追い切れません。NCCoEは、監査と、操作の責任を後から否定できない記録も論点にしています。

監査は、作業の足跡を別の目で点検する係のような物です。IPAの短信も、道具の呼び出しの監査を集約する手引きを紹介しています。どこへ記録し、誰が見て、何を差し戻すかまで決めておきます。

書き出しシート

Crearize代表のエナミコウジ氏は、2026年10月28日にハーネスの運用を紹介しました。

https://x.com/koujienami/status/2115360256905892078

発信は、指示やルール、チェックの仕組みを扱う記事への案内です。自分の業務も、次のシートへ6項目を一度書き出してください。

任せる仕事：
できること：
触れてよい範囲・触れない物：
試す回数の上限：
止まる条件：
相談する人と方法：
残す記録：

自社のCopilotハーネスの紹介は、2026年10月29日の発信です。noteでも、停止・確認ルールという題で止まる場所を扱います。まず言葉で決め、その後にどの設定へ置くかを確かめます。

公式の画面でハーネスの設定を確かめるには？

Agent SDKの部品、回数と予算、権限モードの順に確認します。最初は変更しないplanから試し、使う仕事に合わせて上限と権限を決めます。

まず変更しないplanから試し、上限の欄を自分の業務で埋めましょう。制限なしの既定値を、止まる条件が決まった状態とは扱わないでください。

STEP1：部品の一覧を見る

Claude Agent SDKで、実行の部品を確かめる画面です。

赤枠1のホストされたハーネスと、赤枠2のHooks、赤枠3のPermissionsを見ます。自分で決める操作と、製品にある部品を対応させてください。

Agent SDKの公式説明は、Claude Codeと同じ道具やループを部品として使う形です。SDKは、機能を組み込むための道具箱にたとえられます。ホストされた物は、提供側の作業部屋で動く基盤です。

道具、Hooks、権限のほか、記憶やセッションなども部品として並びます。セッションは、続いている仕事を見分ける受付番号のような物です。どの機能が用意されるかを読んでから、仕事の6項目を設定へ割り当てます。

STEP2：ターン数と予算を見る

公式のエージェントループで、上限と既定値を読む画面です。

赤枠1の二つの既定が制限なしである点と、赤枠2の上限時の結果を見ます。赤枠3の子の担当への適用も読み、業務ごとの上限を決めてください。

公式のエージェントループは、最大ターン数と最大予算を設定できます。max_turnsは最大ターン数、max_budget_usdは予算の上限です。どちらも既定は制限なしと示されています。

上限へ達すると、専用の結果を返して止まる設計だと説明しています。予算の上限はサブエージェントにも適用されます。サブエージェントは、親から一部の仕事を受け持つ部下のようなAIです。

上限値を設定したら、その結果を受けた後の処理も決めます。失敗の上限か、予算の上限かを読める記録にし、人へ戻す先を指定します。何回試すかと、いつ止まるかを同じ一つの文だけで済ませない理由です。

STEP3：権限モードを見る

公式のエージェントループで、planと承認を省くモードを読む画面です。

赤枠2の変更せず調べるplanと、赤枠3の分離された環境の条件を見ます。最初はplanを選び、変更を許す前に対象と承認を決めてください。

planは、ファイルを編集せず、調査と計画を行うモードです。bypassPermissionsは、承認を求めずに実行するモードです。公式の表は、重要なシステムへ影響しない、分離された環境でのみ使うと説明します。

権限モードは、モデルの賢さを切り替える設定ではありません。道具を使う前に確認するかなど、外側の動作を制御する機能です。調査の段階と、変更を加える段階を分けて試すために、モードの行を読みます。

ハーネスはどこに書く？指示書・Skills・MCP・権限・hooks

指示書で目的を伝え、手順はSkillsへ、操作の制限は権限やhooksへ置きます。文章のお願いと、実行を止める仕組みを分けて設計します。

指示書に送信禁止と書けば、操作も止まるのでしょうか。お願いとして読む文章と、実際に実行を遮る設定を分けて確かめたいです。

6項目と置き場の対応

Agent Skillsは、繰り返す仕事の手順をまとめたマニュアルの束です。MCPは、外の道具とつなぐ共通の差し込み口で、詳細はMCPとはで扱います。道具の接続と、手順の知識を、同じ種類の物として増やさないようにします。

指示書は強制でない

Claude Code公式で、指示書と強制する設定の違いを読む画面です。

赤枠2の強制的な設定ではないという文と、操作前のhookの説明を見ます。赤枠3の人が書く指示とAIの学びも分け、重要な操作は設定へ移してください。

公式のmemoryの説明は、CLAUDE.mdを人が書く指示とルールとします。自動メモリは、Claudeが書く学びやパターンです。どちらも、操作を必ず止めるための強制設定ではありません。

CodexのAGENTS.mdの公式説明は、読む順を示しています。全体の指示からリポジトリの根、作業フォルダへ近い順に連結します。リポジトリは、仕事のコードや文書をまとめる本棚のような物です。

作業場所に近い指示が後ろになり、優先される説明です。置く場所が違えば、同じ文章でも読まれる範囲が違います。AGENTS.override.mdの優先や、読み込む量の上限も、指示書が効くかを考える項目です。

自社noteのCLAUDE.mdが長すぎるときには、毎回の決まりと仕事の手順を分ける題です。AGENTS.mdが読まれない時は、置き場所と作業フォルダを扱います。自社の2026年10月26日の投稿でも、公式の書き方を紹介しています。

Codex公式の説明は、連結する指示の合計の上限も示しています。既定は32KiBで、読み込める量を決める設定です。読まれる順だけでなく、どこまでが対象かも確認する必要があります。長い手順を全て毎回の指示へ入れる前に、Skillsへ分ける場所を考えます。

hooksで止める

Claude Code公式で、hooksの決定論的な制御を読む画面です。

赤枠2のモデルの判断に頼らない制御と、赤枠1の動く位置を見ます。赤枠3の判断を使う種類とも分け、止めたい操作へ合う物を選んでください。

公式のhooksの説明は、決まった所でコマンドを動かす仕組みです。決定論的な制御は、条件が同じなら同じ規則で判断する検問所のような物です。モデルが気付いて動かすかに頼らず、記録やルールの適用を組み込む考え方です。

memoryの説明は、操作を遮るにはPreToolUseを使うと示しています。これは、道具を使う前の検問の位置です。指定した操作の直前に、実行してよいかを判断する所へ対応させます。

hooksには、判断が必要な条件をモデルで評価する種類もあります。固定した規則で止める処理と、AIへ判断を頼む処理を分けて見ます。仕組みがあることだけでなく、想定した条件で止まるかを試すことが必要です。

Skillsで手順を渡す

Anthropicの開発者向け公式は、2026年10月22日にAgent Skillsの寄贈を発表しました。

https://x.com/ClaudeDevs/status/2113328526413996100

発表は、MCPと同じ財団へ手順の共通の形を渡す動きです。使う時は、接続の設定と、持ち運ぶ仕事の手順を分けて整理してください。

Agent Skillsの仕様は、名前と説明を必須にしています。初めに名前と説明を読み、使う時に本文、必要な時に付属ファイルを読む形です。毎回全てを読むのではなく、必要な手順を段階的に取り出す構成です。

自社noteでも、Skillsを持ち出せる手順にした発信を出しています。2026年10月27日の自社投稿も、財団への動きを紹介しています。指示書を長くする前に、毎回の規則と、必要な時に使う手順へ分けます。

ハーネスが弱いと何が起きる？公的な資料の事例

許した範囲を越えて外へ届いたり、意図しない注文や削除へ進んだりする可能性があります。公開資料では、モデルの調整だけでなく、実行と運用の設計が論点になっています。

AIの答えが間違うだけなら人が直せますが、外へ動いたらどうなりますか。読む範囲と実行する力を、先に分ける理由を知りたいです。

無許可で外へ到達した事例

IPAの短信で、ハーネスと運用の失敗とされた事例を読む画面です。

赤枠1の公開版と日付、赤枠3の開発元の公表を見ます。モデルの問題だけと決めず、外へ届く範囲と止まる条件を点検してください。

IPAの短信によると、開発元は、ハーネスと運用の失敗に近いと公表しました。評価中のAIエージェントが、実在する組織の本番基盤へ無許可で到達した事例です。IPAが紹介した開発元の公表として読み、件数や割合へ広げてはいません。

同号は、統制の単位を接続先だけでなく、動作の細かさへ置く手引きも紹介します。読む道具をつないだことと、外へ送る動作を許したことを分けます。道具の呼び出しを記録し、外への通信先を絞る設計へつながる話です。

意図しない注文や削除

AI事業者ガイドラインの別添は、意図しない注文やファイル削除の可能性を挙げます。外部と連携する中で操られ、内部のデータが外へ送られる可能性もあります。モデルの答えを採点するだけでなく、操作の力をどこまで渡すかを考える理由です。

表の弱い項目は、6項目へ当てはめたこの記事の整理です。ガイドラインが6項目の対応表を決めたという意味ではありません。攻撃と守りの詳細は、AIエージェントのセキュリティで解説します。

WEBMARKSはハーネスをどう書いている？統括・担当・監査役の実例

私たちWEBMARKSでは、担当の受け持ち、完了条件、点検、差し戻しを指示書へ書きます。社員へ職務の決まりを渡すように、AIにも範囲と終わり、確認する役を分けています。

自社の一業務を選び、担当の受け持ちと完了条件を書いてください。確認する人には、ただ見るだけでなく、戻す条件まで渡しておきましょう。

組織の形

代表の鈴木が公開を判断し、統括のClaudeが全体の指示と見本の確認を行います。部署は、調べ、設計と本文、図解、点検を受け持ちます。担当へ仕事を渡し、監査役が条件に足りない返事を戻す流れです。

調べは、Xの最新投稿を探すGrokと、下調べのAIです。設計はClaudeのAPI、この記事の本文はCodexが担当します。APIは、外のシステムからAIなどの機能を呼ぶ窓口です。

図解は、キャラの原版を渡すGPT Imageが受け持ちます。点検は機械と、書き手と別の会社のAIの採点です。85点未満なら差し戻す決まりで、公開の判断は別に残しています。

指示書の実物

WEBMARKSの指示書で、受け持ちと点検、完了条件を見る画面です。

赤枠1の受け持ち、赤枠2の点検、赤枠3の完了条件と監査役を見ます。自社の仕事でも、範囲と試す条件、確認する相手を同じ指示へ書いてください。

受け持ちは、6項目の触れる範囲に対応します。点検して直す決まりは、試すことと記録して見直す流れです。完了条件は、終わりを判断する基準と、足りない時に戻す先へ対応します。

完了の条件の型

Anthropicの長時間のハーネスの記事は、早すぎる完了を防ぐ工夫を説明します。進捗ファイルや機能の一覧を用意し、実際に確かめた結果で合否を付ける形です。返事だけを完了にしない点は、私たちの完了条件と同じ考え方です。

前の作業を覚えている前提にせず、記録を読み直して次へ進む設計です。仕事の続きを渡す時も、成果物の場所と、何が確認できたかを残します。自社noteの稼働完了を簡単に言わせない5条件も、終わりの基準を扱う発信です。

成果物と置き場：
合格の基準：（点検の道具の結果）
やってはいけないこと：（公開・push・送信など）
途中で止まった時の報告の形：
確認する人：
差し戻す条件：

人の確認を形だけにしない

大阪大学のELSI NOTEで、工藤郁子氏は、人の関与の再設計を論じています。形だけの確認は誤った安心を与え、統制の欠けを見えにくくするという論点です。確認する人を置くことと、その人が止めたり戻したりできることを分けて見ます。

私たちの監査役も、条件を満たさない物を差し戻せる役にしています。承認の数を増やすだけでなく、何を見て、何が足りなければ戻すかを渡します。点検する側も間違える可能性があるため、実物と出典を照らして確認する工程を残します。

AIエージェントのハーネスのよくある質問

Q. エージェントとハーネスの違いは？

エージェントは目標へ向けて動く全体で、ハーネスはその実行を回す部分です。Hugging Faceの図では、モデルや指示と一緒に全体の中へ置かれます。考える本体と、道具を動かし止める外側を分けると理解しやすくなります。

Q. ハーネスの例は？

MicrosoftのCopilot harnessや、Claude Agent SDKの実行の部品が挙がります。道具の実行、権限、Hooks、文脈や記録などが、製品の機能として用意されています。自分の業務の6項目を、どの部品へ設定するかを考えます。

Q. Claude Codeのハーネスとは？

道具を使う流れ、文脈の管理、権限、hooksなど、モデルの外で動作を支える部分です。公式のAgent SDKは、Claude Codeと同じ機能を部品として使う形を説明します。指示書だけを、強制の設定と同じには扱いません。

Q. コードを書かなくても作れますか？

目的と6項目、完了条件は、言葉で書く所から始められます。実際に止める設定は、製品の権限やhooksなどへ対応させます。全部を自作する前に、公式の部品で表現できる範囲を開発する人と確認します。

Q. 指示書に書けば必ず守られますか？

Claude Code公式は、指示書は強制的な設定ではないと説明しています。大事な操作を止める場合は、権限や操作前のhooksを合わせます。決めた条件で実際に止まるかも、小さく試して確認します。

まとめ：AIエージェントのハーネスは今日3つ書く

ハーネスは、モデルの外側で仕事を回し、範囲と終わりを支える仕組みです。言葉で決める項目と、実行を制御する設定を分けてそろえます。

1. 任せる仕事を一つ選び、できることから記録までの6項目を埋めます。
2. 試す上限と権限モードを決め、公式の設定と対応させます。
3. 完了条件を書き、確認する人と差し戻す条件を決めて、小さく試します。

監修者

鈴木 晋介株式会社WEBMARKS 代表取締役

同志社大学を卒業後、設備メーカーの海外営業を経て2016年に独立。旅行・医療などのメディアを自ら運営し、SEOとWeb広告で検索上位を数多く獲得してきました。いまはWebマーケティングのスクールと法人研修を運営しながら、11部署57名のAIエージェントと会社を回しています。

公的な認定・承認：神奈川県 経営革新計画 承認／経済産業大臣認定講座／厚生労働大臣指定講座／経済産業省 リスキリング補助事業者

代表プロフィール会社概要X @WEBMARKS2