エージェントハーネス
信頼して実際のツールを任せられるエージェントを実現するモデルを軸にコードを組み立てる。小規模な Python ライブラリのメンテナンスエージェントを題材に、ループ、ツール、コンテキスト、権限、サンドボックス、サブエージェント、テストを扱う。
対象読者 モデルの API を呼び出し、デモ用のエージェントを作った経験があり、次に、人が各ステップを見守らなくても実際のツール上で動作するエージェントを作らなければならないエンジニアを対象とする。読者は Python を書くことができ、JSON と HTTP を理解しているものとする。モデルの内部構造や MCP に関する予備知識は必要ない。
Kindleまたは任意の電子書籍リーダーで読む
EPUB は Apple Books、Kobo、そのほとんどの電子書籍リーダーでも利用できる。
Kindleに送る
この版のEPUBを送信します。 日本語.
-
当社のアドレスを承認する
Amazonは、承認済みのアドレスからのものに限ってKindleへ配信する。配信するサービスごとに一度ずつ承認が必要である。当社のアドレスを、承認済みのパーソナルドキュメント用メールアドレスの一覧に追加する。
books@rollingedition.comAmazonのパーソナルドキュメント設定を開く. Amazonでは、「コンテンツと端末の管理」、「環境設定」、「パーソナルドキュメント設定」の順に進む。
送信しました。数分後に Kindle のライブラリに表示されます。
届かない場合、ほとんどは手順1の承認が原因である。books@rollingedition.comが承認済みのパーソナルドキュメント用メールアドレスの一覧に入っているかを確認する。
保存した書籍の新しい版も、同じくKindleに届く。
Kindle のアドレスではない。アドレスは @kindle.com で終わる。Amazon の「パーソナル ドキュメント設定」で確認できる。
本日すでに {count} 冊を送信しており、これは1アカウントが1日に送信できる上限である。明日再度試すこと。
本日送信できる冊数の上限に達した。明日再度試すこと。
書籍を送信できなかった。数分後に再度試すこと。
この版は大きすぎて電子メールで送信できない。
Kindleへの送信はLabsに含まれる。
Kindle のアドレスではない。アドレスは @kindle.com で終わる。Amazon の「パーソナル ドキュメント設定」で確認できる。
書籍を送信できなかった。数分後に再度試すこと。
または、EPUBをダウンロードし、AmazonのSend to Kindleページにドロップする。
Kindle is a trademark of Amazon.com, Inc.
目次
12 章、読了までおよそ7 時間 9 分、64 例を収録。
-
1モデルにツールとループを与える
本章を終えると、モデルを3つのツールを持つループの中で実行できるようになる。
-
2完了したときか行き詰まったときにループを止める
この章を読み終えると、ハーネスが記録する一語から、実行がなぜ止まったのかを説明できるようになる。
-
3モデルが誤用できないツールを与える
この章を終えると、ツールが実行される前にハーネスが引数を検査するツールをモデルに与えられるようになり、モデルが対処できる拒否メッセージを書けるようになる。
-
4スクリプト化、再生、ローカル、ホスト型のモデルに共通する一つのインターフェース
この章を読み終えると、スクリプト化したモデル、再生した実行、ローカルモデル、OpenAI 互換のエンドポイントのどれに対しても、ループを変更せずに同じループを実行できるようになる。
-
5タスクが長くなってもコンテキストを有用に保つ
この章を読み終えると、実行(run)のプロンプトにどれだけの余裕があるかを求め、ハーネスが正確に数えられないときにプロンプトの大きさを見積もり、ツール呼び出しとその結果を切り離さずに、実行の古いステップを圧縮できるようになる。
-
6変更を加えるツールに関門を設ける
この章を読み終えるころには、人が承認するまでエージェントの変更をエージェント自身のコピーの中にとどめ、その承認が人の読んだ変更そのものを対象としていることを確かめ、拒否をエージェントの実行が止まった理由として返せるようになる。
-
7エージェントのコードをサンドボックスで実行し、秘密情報をその参照範囲の外に置く
この章を終えると、エージェントのためにコマンドを実行できるようになる。
-
8サブタスクを子に渡し、停止を返す
この章を終えると、独自のステップ予算を持つ子ループにサブタスクを渡し、子の記録全体の代わりに、要約と停止理由を受け取れるようになる。
-
9ハーネスを MCP サーバーに接続する
この章を終えると、他者が運用する MCP サーバーにハーネスを接続できる。
-
10エージェントをテストし、タスクセットで測定する
この章を読み終えると、スクリプト化した応答でハーネスをテストし、完了を判定する一つの規則でタスクセット上のエージェントを採点し、その件数を範囲とともに示せるようになる。
-
11各実行をトレースし、そのコストを数える
この章を終えると、次のことができるようになる。
-
12エージェントが誤った設計となるとき
本章を読み終えると、このケースの任意のタスクを、固定パイプライン、単一のモデル呼び出し、ゲート付きエージェントのいずれかに分類し、記録された実行がそのタスクについて何を示しているかを述べられるようになる。