エージェンティック・ハーネス設計ガイド — Part 7(最終回)
はじめ方と、
足場の棚卸し
いきなり全部は要らない。ただし、飛ばしてはいけない順番がある。
ここまで6回にわたって「どう作るか」を扱ってきました。最終回は「どの順で着手するか」と、「作ったものをどう畳んでいくか」です。そして最後に、まだ決着していないことを正直に並べます。
この記事は、原理原則12箇条のうち 01「まずワークフローを試し、エージェントは必要なときだけ使う」 の各論であり、シリーズ全体の締めにあたります。
1.Stage 00 — そもそも、エージェントが要るのか
最初に確かめるのは、作り方ではなく作るべきかどうかです。ここを飛ばして進めた案件は、後段の投資がまるごと無駄になります。
関数で書けるなら、それが答え
エージェントが向くのは、手順が事前に決まらず、柔軟な判断が要る仕事です。逆に言えば、決まった手順の繰り返しにエージェントを使うのは、速度・費用・確実性のすべてで損をします。判断が要る部分だけをエージェントに任せ、残りは決定的な処理に載せる——これがPart 4の「決定性が要るならスクリプト」と同じ判断です。
そして、進むと決めたなら評価タスクを先に20〜50件作ります。机上で理想を並べるのではなく、実際に起きた失敗から。採点できないものは改善もできないので、これは「準備」ではなく設計の一部です。詳しくはPart 6で扱いました。
2.Stage 01〜03 — 積み上げる順番
いきなり全部は要りません。ただし順番には意味があります。とくに隔離と予算上限は、後から足すのが難しい部類です。
- <b>Stage 01 の肝は「初日から隔離する」</b> — サンドボックスと通信制御は、動いてから足すと既存の挙動を壊す。最初から入れる。
- <b>Stage 02 の肝は「複数回まわす」</b> — 1回の成功で本番に出さない。制約の固定注入とチェックポイントも、この段階で入る。
- <b>Stage 03 の肝は「増える前提」</b> — 台帳、外部ツールの版固定、モデル差し替え時の再評価。1体だけなら要らないが、増えると急に効いてくる。
各段階の確認項目は、ホワイトペーパーにチェックリストの形でまとめています。
3.ベンチマーク値は、自社に移植されない
導入検討でよく起きるのが、公表スコアをそのまま自社の期待値にしてしまうことです。
実務上の含意は3つです。
- <b>他社の数値は、そのままは使えない</b> — 自社のハーネスで測り直す。
- <b>モデルの差し替えは、静かな性能変化を伴う</b> — ハーネスはモデルの一部として働くため、入れ替えただけで挙動が変わる。
- <b>「モデルの評価」と「ハーネスの評価」は分ける</b> — 両方をまとめて回すと、どちらが原因か切り分けられない。
関連して、ツールの定義の「形」も中立ではありません。広く使われている形と大きく違うスキーマを採ると、モデルが存在しない引数を補ってしまう現象が報告されています。奇をてらった設計より、一般的な形に寄せるほうが安全です。
4.足場は、増やすより減らす
ハーネスは作り込むほど良くなる、というものではありません。各部品は「その時点のモデルにできなかったこと」の記録だからです。
簡素化したほうが速く安くなったという実験例も報告されています。にもかかわらず、実務では足場は増える方向にしか働きません。不具合が出れば回避策を足し、足した回避策は誰も外さないためです。
運用に組み込む
モデル更新のたびに「この部品はまだ必要か」を試す。四半期程度の頻度で構成そのものを見直す。ハーネスには賞味期限がある、という前提で運用するのが現実的です。棚卸しの単位は、Part 1の7層がそのまま使えます。
5.正直に言うと、まだ決着していない
入門資料が「答え」だけを並べると、現場で例外に当たったときに動けなくなります。2026年8月時点で、実務家の間でも結論が割れている論点を挙げておきます。
- <b>エラーを残すか、消すか</b> — 「回復のための学習材料だから残せ」という実務側の主張と、「自分の誤りが文脈にあると以降の誤り率が上がる」という実験結果が併存する。両者を分離した検証はまだ無い。
- <b>圧縮するか、入り直すか</b> — 圧縮する実装、区切りで意図的に要約する実装、セッションごとリセットして引き継ぐ実装、そもそもスレッドを伸ばさない実装。主要な作り手の方針が割れたままである。
- <b>並列は効くのか</b> — 広く浅い調査系では大幅改善という報告と、相互依存する作業では有害という報告がある。前者はトークン消費が大きく増える条件付きで、コストを揃えた比較試験が無い。
- <b>足場はどこまで薄くできるか</b> — モデルの進化速度に依存するため、来年の最適解は今年と違う。だからこそ棚卸しの対象になる。
- <b>検索は、探索型か埋め込み型か</b> — 同じ条件で比較した統制実験が見当たらない。
これらは「まだ分かっていないから触れない」のではなく、自社で測る対象として設計に組み込むべき箇所です。片方を正解として実装を固めると、反例に当たったときに戻れなくなります。
6.数値の扱いについて
最後に、この分野の情報を扱ううえでの注意です。
機序は使い、数値は転載しない
2026年の知見には、プレプリント(一部は単著・査読前)やベンダーの自己申告が多く含まれ、追試が確立していないものがあります。なぜそうなるか(機序)は設計判断に使えますが、数値をそのまま提案書・SLA・外部資料に転載すると、後から根拠を問われたときに困ります。引用する場合は、原典と観測条件を確認してください。
本シリーズでも、この線引きに従っています。追試が確立していない数値は本文に載せず、機序だけを採りました。載せた数値は、発行元が本文で明示しているものに限っています。
Summary
この記事の要点
- 1作り方より先に、作るべきかを確かめる。手順が決まっているなら、決定的なワークフローのほうが速く安く確実。
- 2機械が判定できる合格条件を書けないタスクは、まだエージェント化しない。採点できないものは改善もできない。
- 3評価タスクは20〜50件、実際の失敗から先に作る。これは準備ではなく設計の一部。
- 4Stage 01 の肝は「初日から隔離する」。サンドボックスと通信制御は、後から足すと既存の挙動を壊す。
- 5Stage 02 の肝は「複数回まわす」。1回の成功で本番に出さない。
- 6Stage 03 の肝は「増える前提」。台帳・版固定・再評価は、1体だけなら要らないが増えると急に効く。
- 7ベンチマーク値は自社に移植されない。スコアは モデル×ハーネス×実行環境×採点器 の関数。
- 8モデルの差し替えは、静かな性能変化を伴う。モデルの評価とハーネスの評価は分けて回す。
- 9ハーネスの各部品は「当時のモデルにできなかったこと」の記録。モデル更新のたびに外して試す。
- 10足場は放っておくと増える方向にしか働かない。減らす側に、意識して力をかける。
- 11決着していない論点は、そのまま「自社で測るべき箇所」の一覧になる。片方を正解として固めない。
- 12機序は設計に使い、追試の確立していない数値は外部資料に転載しない。
Series complete
シリーズ全7回のまとめ
エージェンティック・ハーネスの設計を、定義から着手の順番まで7回で辿りました。全体像を確認したいときの索引としてお使いください。
Deeper
実装の視点で、さらに深く
この記事は製品に依存しない設計論として書いています。実装としてどう組んだかは、homula.ai の技術解説で扱っています。
Sources
出典・参考文献
本記事は、以下の一次資料をもとに整理しています。数値・仕様は各出典の公開時点のものです。
FAQ
よくある質問
作り始める前に「本当にエージェントが要るか」を確かめることからです。手順が事前に決まっているなら、決定的なワークフローのほうが速く安く確実です。また、機械が判定できる合格条件(テスト・ビルド・データベースの状態など)を書けないタスクは、まだエージェント化しないほうが安全です。そのうえで、実際の失敗から評価タスクを20〜50件、先に作ります。
採点できないものは、改善もできないためです。評価が無いまま作り込むと、変更が良くなったのか悪くなったのか判断できず、後段の投資がすべて手探りになります。Stage 00 を飛ばして進めた場合、あとから評価を足そうとしても「何をもって合格とするか」の合意形成からやり直しになります。
なりません。スコアはモデル単体の性質ではなく、モデル × ハーネス × 実行環境 × 採点器の関数です。4つのうち1つでも違えば、その数値は移植されません。ハーネスはモデルの一部として働くため、モデルの差し替えは静かな性能変化を伴います。「モデルの評価」と「ハーネスの評価」は分けて回帰テストしてください。
いいえ。ハーネスの各部品は「その時点のモデルにできなかったこと」への回避策を含んでいます。モデル世代が上がると不要になったり、かえって足を引っ張ったりします。簡素化したほうが速く安くなった実験例も報告されています。足場は作りっぱなしにせず、モデル更新のたびに外して再テストし、四半期程度の頻度で構成を見直すのが現実的です。
決着しているのは、権限は環境で強制すること、成果で採点すること、状態を外に持って再開できるようにすることなど、本シリーズで扱った設計の骨格です。決着していないのは、エラーを履歴に残すか消すか、圧縮するか入り直すか、並列は効くのか、足場はどこまで薄くできるか、といった論点です。後者は「自社で測るべき箇所」の一覧として扱ってください。
避けたほうが安全です。この分野の知見にはプレプリント(一部は単著・査読前)やベンダーの自己申告が多く含まれ、追試が確立していないものがあります。機序(なぜそうなるか)は設計判断に使えますが、数値をそのまま外部資料やSLAに転載すると、後から根拠を問われたときに困ります。引用する場合は原典と観測条件を確認してください。
Part 6
検証・評価 — できたと誰が確かめるか
応答文ではなく、環境の状態を採点する。
資料
ホワイトペーパー Vol.1 / Vol.2
英語圏の一次情報 約130件の調査にもとづく解説資料。段階別チェックリスト付き。
実行基盤を、自社で持ちたい方へ
homulaは、AIエージェント実行基盤の要件定義から設計・構築・運用までを支援しています。Stage 00 の要否判断と合格条件の整理から、ご一緒できます。