Cover of Agent Harnesses, edition 2026.11.2, code ZZGV-NEGC Agent Harnesses ZZGV-NEGC 2 editions since Nov 2026 Rolling Edition 2026.11.2

エージェントハーネス

第2026.11.2版 2026年11月20日時点で例が通過 64 例中 64 例が合格 変更点

AIによる翻訳。英語版は人による検証済みである。 当社の書籍の作り方

英語版の書籍(版2026.11.2)から翻訳した。 原文を読む

信頼して実際のツールを任せられるエージェントを実現するモデルを軸にコードを組み立てる。小規模な Python ライブラリのメンテナンスエージェントを題材に、ループ、ツール、コンテキスト、権限、サンドボックス、サブエージェント、テストを扱う。

対象読者 モデルの API を呼び出し、デモ用のエージェントを作った経験があり、次に、人が各ステップを見守らなくても実際のツール上で動作するエージェントを作らなければならないエンジニアを対象とする。読者は Python を書くことができ、JSON と HTTP を理解しているものとする。モデルの内部構造や MCP に関する予備知識は必要ない。

読み始める
版の履歴2026年11月以降2 版各版と、その変更点
2026.11.12026.11.2
2026.11.2 · 2026年11月20日ライブラリの更新本文は変更なし、新しいバージョンでの5 例

目次

12 章、読了までおよそ7 時間 9 分、64 例を収録。

  1. 1モデルにツールとループを与える

    本章を終えると、モデルを3つのツールを持つループの中で実行できるようになる。

  2. 2完了したときか行き詰まったときにループを止める

    この章を読み終えると、ハーネスが記録する一語から、実行がなぜ止まったのかを説明できるようになる。

  3. 3モデルが誤用できないツールを与える

    この章を終えると、ツールが実行される前にハーネスが引数を検査するツールをモデルに与えられるようになり、モデルが対処できる拒否メッセージを書けるようになる。

  4. 4スクリプト化、再生、ローカル、ホスト型のモデルに共通する一つのインターフェース

    この章を読み終えると、スクリプト化したモデル、再生した実行、ローカルモデル、OpenAI 互換のエンドポイントのどれに対しても、ループを変更せずに同じループを実行できるようになる。

  5. 5タスクが長くなってもコンテキストを有用に保つ

    この章を読み終えると、実行(run)のプロンプトにどれだけの余裕があるかを求め、ハーネスが正確に数えられないときにプロンプトの大きさを見積もり、ツール呼び出しとその結果を切り離さずに、実行の古いステップを圧縮できるようになる。

  6. 6変更を加えるツールに関門を設ける

    この章を読み終えるころには、人が承認するまでエージェントの変更をエージェント自身のコピーの中にとどめ、その承認が人の読んだ変更そのものを対象としていることを確かめ、拒否をエージェントの実行が止まった理由として返せるようになる。

  7. 7エージェントのコードをサンドボックスで実行し、秘密情報をその参照範囲の外に置く

    この章を終えると、エージェントのためにコマンドを実行できるようになる。

  8. 8サブタスクを子に渡し、停止を返す

    この章を終えると、独自のステップ予算を持つ子ループにサブタスクを渡し、子の記録全体の代わりに、要約と停止理由を受け取れるようになる。

  9. 9ハーネスを MCP サーバーに接続する

    この章を終えると、他者が運用する MCP サーバーにハーネスを接続できる。

  10. 10エージェントをテストし、タスクセットで測定する

    この章を読み終えると、スクリプト化した応答でハーネスをテストし、完了を判定する一つの規則でタスクセット上のエージェントを採点し、その件数を範囲とともに示せるようになる。

  11. 11各実行をトレースし、そのコストを数える

    この章を終えると、次のことができるようになる。

  12. 12エージェントが誤った設計となるとき

    本章を読み終えると、このケースの任意のタスクを、固定パイプライン、単一のモデル呼び出し、ゲート付きエージェントのいずれかに分類し、記録された実行がそのタスクについて何を示しているかを述べられるようになる。

この節を引用する

形式

いずれの形式も、本訳書が従う英語版の書籍を出典として示す。

いずれの形式もこの版を明示している。そのリンクは現行版を開き、節の見出しには本文が最後に変更された日付が示される。アクセス日と取得日は、これを開いた日である。