homula

エージェンティック・ハーネス設計ガイド — Part 7(最終回)

はじめ方と、足場の棚卸し

いきなり全部は要らない。ただし、飛ばしてはいけない順番がある。

15〜18分難易度 ★☆☆(初級〜中級)最終更新: 2026年8月

ここまで6回にわたって「どう作るか」を扱ってきました。最終回は「どの順で着手するか」と、「作ったものをどう畳んでいくか」です。そして最後に、まだ決着していないことを正直に並べます。

この記事は、原理原則12箇条のうち 01「まずワークフローを試し、エージェントは必要なときだけ使う」 の各論であり、シリーズ全体の締めにあたります。

1.Stage 00 — そもそも、エージェントが要るのか

最初に確かめるのは、作り方ではなく作るべきかどうかです。ここを飛ばして進めた案件は、後段の投資がまるごと無駄になります。

この仕事を、AIに任せたい手順は、事前に決まっているか?決まっている決まらない決定的なワークフローで書く速く・安く・確実。関数で書けるなら、それが答え合格条件を、検証できる形で書けるか?書けない書けるまだ着手しないエージェント化に進むテスト・ビルド・データベースの状態など、機械が判定できる合格条件があるか。
図1手順が事前に決まっているなら、決定的なワークフローのほうが速く安く確実。合格条件を検証できる形で書けないタスクは、まだエージェント化しない。

関数で書けるなら、それが答え

エージェントが向くのは、手順が事前に決まらず、柔軟な判断が要る仕事です。逆に言えば、決まった手順の繰り返しにエージェントを使うのは、速度・費用・確実性のすべてで損をします。判断が要る部分だけをエージェントに任せ、残りは決定的な処理に載せる——これがPart 4の「決定性が要るならスクリプト」と同じ判断です。

そして、進むと決めたなら評価タスクを先に20〜50件作ります。机上で理想を並べるのではなく、実際に起きた失敗から。採点できないものは改善もできないので、これは「準備」ではなく設計の一部です。詳しくはPart 6で扱いました。

2.Stage 01〜03 — 積み上げる順番

いきなり全部は要りません。ただし順番には意味があります。とくに隔離と予算上限は、後から足すのが難しい部類です。

STAGE 00作り始める前「本当に要るか」を確かめる要否の判断合格条件の定義評価タスクを先に 20〜50 件STAGE 01最小のハーネス動くものに「止まる仕組み」を付けるループと状態は自前ツールは 5〜10 個初日から隔離と通信制御予算上限とトレースSTAGE 02本番投入「毎回同じように動く」を担保する環境の状態で採点複数回試行して統計判定制約の固定注入チェックポイントと冪等キーSTAGE 03組織規模増える前提で統制を敷くエージェント台帳外部ツールの版固定失敗の自動昇格モデル差し替え時の再評価いきなり全部は要らない。ただし Stage 00 を飛ばすと、後段の投資がすべて無駄になる。
図2Stage 00 で要否と合格条件と評価セット、01 で止まる仕組みを付けた最小構成、02 で再現性、03 で組織規模の統制。
  • <b>Stage 01 の肝は「初日から隔離する」</b> — サンドボックスと通信制御は、動いてから足すと既存の挙動を壊す。最初から入れる。
  • <b>Stage 02 の肝は「複数回まわす」</b> — 1回の成功で本番に出さない。制約の固定注入とチェックポイントも、この段階で入る。
  • <b>Stage 03 の肝は「増える前提」</b> — 台帳、外部ツールの版固定、モデル差し替え時の再評価。1体だけなら要らないが、増えると急に効いてくる。

各段階の確認項目は、ホワイトペーパーにチェックリストの形でまとめています。

3.ベンチマーク値は、自社に移植されない

導入検討でよく起きるのが、公表スコアをそのまま自社の期待値にしてしまうことです。

スコアは、この4つの関数モデル×ハーネス×実行環境×採点器公表されたスコア4 つのうち 1 つでも違えば、その数値は自社には移植されないハーネスはモデルの一部として働く。モデルの差し替えは、静かな性能変化を伴うだから「モデルの評価」と「ハーネスの評価」は、分けて回帰テストする。
図3スコアはモデル単体の性質ではなく、モデル × ハーネス × 実行環境 × 採点器 の関数。1つでも違えば移植されない。

実務上の含意は3つです。

  • <b>他社の数値は、そのままは使えない</b> — 自社のハーネスで測り直す。
  • <b>モデルの差し替えは、静かな性能変化を伴う</b> — ハーネスはモデルの一部として働くため、入れ替えただけで挙動が変わる。
  • <b>「モデルの評価」と「ハーネスの評価」は分ける</b> — 両方をまとめて回すと、どちらが原因か切り分けられない。

関連して、ツールの定義の「形」も中立ではありません。広く使われている形と大きく違うスキーマを採ると、モデルが存在しない引数を補ってしまう現象が報告されています。奇をてらった設計より、一般的な形に寄せるほうが安全です。

4.足場は、増やすより減らす

ハーネスは作り込むほど良くなる、というものではありません。各部品は「その時点のモデルにできなかったこと」の記録だからです。

モデル世代 N のときに組んだ足場再試行の細工出力の整形手順の分解誘導プロンプト後処理モデルが上がる世代 N+1 で、外して試す再試行の細工もう要らない出力の整形もう要らない手順の分解まだ要る誘導プロンプトもう要らない後処理まだ要るハーネスの各部品は「当時のモデルにできなかったこと」の記録であるモデルが変われば前提も変わる。足場は作りっぱなしにせず、定期的に外して試す簡素化したほうが速く安くなった実験例も報告されている。増やす方向にだけ働く力に、意識して抗う。
図4モデル世代が上がると、以前は必須だった足場が不要になる。定期的に外して、まだ要るかを試す。

簡素化したほうが速く安くなったという実験例も報告されています。にもかかわらず、実務では足場は増える方向にしか働きません。不具合が出れば回避策を足し、足した回避策は誰も外さないためです。

運用に組み込む

モデル更新のたびに「この部品はまだ必要か」を試す。四半期程度の頻度で構成そのものを見直す。ハーネスには賞味期限がある、という前提で運用するのが現実的です。棚卸しの単位は、Part 1の7層がそのまま使えます。

5.正直に言うと、まだ決着していない

入門資料が「答え」だけを並べると、現場で例外に当たったときに動けなくなります。2026年8月時点で、実務家の間でも結論が割れている論点を挙げておきます。

両側に、それぞれ根拠がある一方の立場もう一方の立場エラーを残すか、消すか回復の学習材料になる自分の誤りが文脈にあると誤り率が上がる圧縮するか、入り直すか文脈を畳んで続ける捨てて引き継ぎ書で繋ぐ並列は効くのか広く浅い調査では大幅改善相互依存する作業では有害足場はどこまで薄くできるかモデルが上がれば剥がせる実務では増える方向に働く決着していない箇所は、そのまま「自社で測るべき箇所」の一覧になる。
図5どちらの立場にも根拠がある。決着していない箇所は、そのまま「自社で測るべき箇所」の一覧になる。
  • <b>エラーを残すか、消すか</b> — 「回復のための学習材料だから残せ」という実務側の主張と、「自分の誤りが文脈にあると以降の誤り率が上がる」という実験結果が併存する。両者を分離した検証はまだ無い。
  • <b>圧縮するか、入り直すか</b> — 圧縮する実装、区切りで意図的に要約する実装、セッションごとリセットして引き継ぐ実装、そもそもスレッドを伸ばさない実装。主要な作り手の方針が割れたままである。
  • <b>並列は効くのか</b> — 広く浅い調査系では大幅改善という報告と、相互依存する作業では有害という報告がある。前者はトークン消費が大きく増える条件付きで、コストを揃えた比較試験が無い。
  • <b>足場はどこまで薄くできるか</b> — モデルの進化速度に依存するため、来年の最適解は今年と違う。だからこそ棚卸しの対象になる。
  • <b>検索は、探索型か埋め込み型か</b> — 同じ条件で比較した統制実験が見当たらない。

これらは「まだ分かっていないから触れない」のではなく、自社で測る対象として設計に組み込むべき箇所です。片方を正解として実装を固めると、反例に当たったときに戻れなくなります。

6.数値の扱いについて

最後に、この分野の情報を扱ううえでの注意です。

機序は使い、数値は転載しない

2026年の知見には、プレプリント(一部は単著・査読前)やベンダーの自己申告が多く含まれ、追試が確立していないものがあります。なぜそうなるか(機序)は設計判断に使えますが、数値をそのまま提案書・SLA・外部資料に転載すると、後から根拠を問われたときに困ります。引用する場合は、原典と観測条件を確認してください。

本シリーズでも、この線引きに従っています。追試が確立していない数値は本文に載せず、機序だけを採りました。載せた数値は、発行元が本文で明示しているものに限っています。

Summary

この記事の要点

  1. 1作り方より先に、作るべきかを確かめる。手順が決まっているなら、決定的なワークフローのほうが速く安く確実。
  2. 2機械が判定できる合格条件を書けないタスクは、まだエージェント化しない。採点できないものは改善もできない。
  3. 3評価タスクは20〜50件、実際の失敗から先に作る。これは準備ではなく設計の一部。
  4. 4Stage 01 の肝は「初日から隔離する」。サンドボックスと通信制御は、後から足すと既存の挙動を壊す。
  5. 5Stage 02 の肝は「複数回まわす」。1回の成功で本番に出さない。
  6. 6Stage 03 の肝は「増える前提」。台帳・版固定・再評価は、1体だけなら要らないが増えると急に効く。
  7. 7ベンチマーク値は自社に移植されない。スコアは モデル×ハーネス×実行環境×採点器 の関数。
  8. 8モデルの差し替えは、静かな性能変化を伴う。モデルの評価とハーネスの評価は分けて回す。
  9. 9ハーネスの各部品は「当時のモデルにできなかったこと」の記録。モデル更新のたびに外して試す。
  10. 10足場は放っておくと増える方向にしか働かない。減らす側に、意識して力をかける。
  11. 11決着していない論点は、そのまま「自社で測るべき箇所」の一覧になる。片方を正解として固めない。
  12. 12機序は設計に使い、追試の確立していない数値は外部資料に転載しない。

Series complete

シリーズ全7回のまとめ

エージェンティック・ハーネスの設計を、定義から着手の順番まで7回で辿りました。全体像を確認したいときの索引としてお使いください。

FAQ

よくある質問

作り始める前に「本当にエージェントが要るか」を確かめることからです。手順が事前に決まっているなら、決定的なワークフローのほうが速く安く確実です。また、機械が判定できる合格条件(テスト・ビルド・データベースの状態など)を書けないタスクは、まだエージェント化しないほうが安全です。そのうえで、実際の失敗から評価タスクを20〜50件、先に作ります。

採点できないものは、改善もできないためです。評価が無いまま作り込むと、変更が良くなったのか悪くなったのか判断できず、後段の投資がすべて手探りになります。Stage 00 を飛ばして進めた場合、あとから評価を足そうとしても「何をもって合格とするか」の合意形成からやり直しになります。

なりません。スコアはモデル単体の性質ではなく、モデル × ハーネス × 実行環境 × 採点器の関数です。4つのうち1つでも違えば、その数値は移植されません。ハーネスはモデルの一部として働くため、モデルの差し替えは静かな性能変化を伴います。「モデルの評価」と「ハーネスの評価」は分けて回帰テストしてください。

いいえ。ハーネスの各部品は「その時点のモデルにできなかったこと」への回避策を含んでいます。モデル世代が上がると不要になったり、かえって足を引っ張ったりします。簡素化したほうが速く安くなった実験例も報告されています。足場は作りっぱなしにせず、モデル更新のたびに外して再テストし、四半期程度の頻度で構成を見直すのが現実的です。

決着しているのは、権限は環境で強制すること、成果で採点すること、状態を外に持って再開できるようにすることなど、本シリーズで扱った設計の骨格です。決着していないのは、エラーを履歴に残すか消すか、圧縮するか入り直すか、並列は効くのか、足場はどこまで薄くできるか、といった論点です。後者は「自社で測るべき箇所」の一覧として扱ってください。

避けたほうが安全です。この分野の知見にはプレプリント(一部は単著・査読前)やベンダーの自己申告が多く含まれ、追試が確立していないものがあります。機序(なぜそうなるか)は設計判断に使えますが、数値をそのまま外部資料やSLAに転載すると、後から根拠を問われたときに困ります。引用する場合は原典と観測条件を確認してください。

実行基盤を、自社で持ちたい方へ

homulaは、AIエージェント実行基盤の要件定義から設計・構築・運用までを支援しています。Stage 00 の要否判断と合格条件の整理から、ご一緒できます。