まえがき
まえがき
本書が生まれたきっかけは、ある瞬間の体験です。おそらくあなたも、すでに同じ体験をしているのではないでしょうか。人間なら30分はかかりそうな仕事を、言語モデルに任せてみます。たとえば、ビルドが壊れた原因を突き止める、あるいは、乱雑なスプレッドシートをデータベースと突き合わせる、といった仕事です。すると、答えが返ってくる代わりに、モデルが作業する様子を目にすることになります。検索し、読み、何かを試し、エラーにぶつかり、自分で軌道を修正し、数分後には仕事を終えて戻ってきます。最初に湧いてくるのは喜びです。2つ目の感情は一拍遅れてやってきて、こちらのほうが長く残ります。すべてのステップを見ていたわけではない。これをどこまで信頼していいのだろうか。
この2つ目の感情こそが、本書の主題です。

本書は、現場のエンジニアに向けて書きました。ソフトウェアには慣れているけれども、機械学習に詳しいとは限らない人。エージェントを評価している最中か、エージェントを使った開発を始めたばかりで、過剰な期待も漠然とした恐れも通り越して、その下にあるエンジニアリングにたどり着きたいと考えている人です。本書に書いてあるのは、基本原理から組み立てた定義、エージェントが役に立つ仕事をしているあらゆる領域で繰り返し現れるパターン、平易な擬似コードによる例です。そして全体を通じて、何にどれだけコストがかかり、どのように失敗するのかにこだわっています。前提として必要なのは、エンジニアとしての一般的な素養だけです。専門用語が出てきたら、その場で、平易な言葉で定義します。
どの章も、2つの約束に沿って書かれています。この2つを合わせると、本書に何が書いてあり、何が書いていないのかがわかるので、ここではっきり述べておきます。
1つ目の約束は、本書が時代に依存しないことです。この分野は、何かを書き留めた人が気恥ずかしくなるほどの速さで進歩しています。本書の材料を集めている間にも、ほんの数か月前に取ったメモがもう古くなりはじめていました。製品は名前が変わり、ベンチマークの数値は塗り替えられていたのです。そこで私は、どんな内容も、書かれた時期に結びつけないことにしました。どのモデルが現時点で最も優れているか、今四半期のトークン単価がいくらか、今年のコンテキストウィンドウがどれほど大きいか。本書の主張に、こうしたことに依存するものは1つもありません。数値が出てくる場合は、例示であることを明記しています。目指したのは、数年後に読んでも今日と同じように読める本です。
2つ目の約束は、本書が特定の製品に依存しないことです。この分野で長持ちする知識は、概念とパターンの中にあります。ループ、ツールの契約、コンテキスト予算、評価スイートといったもので、これらはどのベンダーやフレームワークにもそのまま持ち込めます。一方、個々の製品の構文は持ち込めませんし、数か月で古びてしまいます。そこで本書ではパターンを教え、具体的なツールの名前は、あるカテゴリーの例であると断ったうえで、軽く触れるにとどめます。読み終えたときには、チームが採用したハーネス(エージェントがその中で動く、外殻にあたるソフトウェア)がどんなものであっても、あるいはハーネスがまったくなくても、腰を据えて取りかかり、何を作るべきかがわかるようになっているはずです。
本書には、あまりに何度も出てくるので、全体の主張と言ってよい考えが1つあります。ここで紹介しておきましょう。エージェントは、その働きを検証できるシグナルがある分だけしか信頼できない。言語モデルは、正しいときも間違っているときも、同じように流暢で自信に満ちた文章を生成します。その口調からは、当てにできることは何も読み取れません。したがって、エージェントに寄せる信頼は、モデルの外側のどこかから得るしかありません。通るテストスイート、検証に通るスキーマ、開いて確かめられる情報源、取り返しのつかないステップを承認する人間などです。そうしたシグナルがあるところでは、自律性を気前よく与えることができます。あとで見るように、エージェントが最初に元が取れるようになった領域がコーディングだった理由の大半は、そこにあります。コードには判定がもともと付いてくるからです。コンパイルして、テストを走らせればよいのです。シグナルがないところでは、自律性を与えることは根拠のない賭けであり、本書はそのことを繰り返し指摘していきます。この先の章に出てくる設計上の問いは、ほとんどどれも、同じ最初の一手に行き着きます。うまくいったことを教えてくれるシグナルは何か、と問うことです。
用語について一言。「エージェント」は、現代のソフトウェアで最も多くの意味を背負わされた言葉かもしれません。電話の自動応答メニューを台本どおりに読み上げるだけのボットにも、午後いっぱい単独で作業を任せられるシステムにも、同じように自信たっぷりに使われています。専門用語が役に立つのは、話し手と聞き手が定義を共有しているときだけです。そうでなければ、2人の人間がまったく別のものについて熱心に議論する、ということが起こりえます1 Simon Willison, “I think ‘agent’ may finally have a widely enough agreed upon definition to be useful jargon now,” simonwillison.net(2025年9月)。専門用語の共有についてのこの指摘と、本書が第1章で採用する実用上の定義は、同氏によるものです。。そこで最初の章では、用語をきちんと固定するという地味な作業を行い、以降の章はその定義を守ります。
読み方について。本書は7つの部に分かれ、講座のように順を追って並べてあります。第I部では、エージェントとは何か、そしてその下にあるエンジン、つまり言語モデルが実際にどう動くのかを押さえます。第II部と第III部では、エージェントを1つ作ります。ループ、ツール、再利用可能なスキル、そしてモデルの作業記憶の入念な管理です。第IV部はアーキテクチャを扱います。ワークフロー、マルチエージェントシステム、監督と自律の間のダイヤル、ハーネスの外側のループを書く技術、そして「うまくいく最もシンプルなもの」にそもそもエージェントが必要なのかを問う規律です。第V部と第VI部は、現実のエージェントエンジニアリングの大部分を占めることになるもの、すなわち評価、オブザーバビリティ、セキュリティ、信頼性、コスト、デプロイを取り上げます。第VII部では、応用と、この先も長く残りそうなものに目を向けます。付録には、注釈付きの擬似コードで書いた最小限のエージェント、用語集、さらに学ぶための読書案内を収めました。基礎を固めるなら、部の順に読んでください。全体像をつかんだあとは、リファレンスとして必要なところを拾い読みしてもかまいません。各章は互いに参照し合っていますが、それぞれ単独でも読めるように努めました。
このような本に何が約束できるのか、正直に述べておくべきでしょう。ここに書いた細部のいくつかは、いずれ古くなります。おそらく、私が望むよりも早く。私は、例が古びても残る部分だけを書くように努め、確信が持てないところではそう断るようにしました。本書が賭けているのは、原則は製品より長生きする、ということです。数年後、例は古めかしく感じられても、これを検証するシグナルは何か。うまくいく最もシンプルなものは何か。という問いが、あなたが変わらず立てている問いであるなら、本書は役目を果たしたことになります。
始める前に、ひとつお願いがあります。この本をどこで知ったのかを教えていただけるなら、そのためのページを用意しました。クリック1回で答えられ、匿名で、メールアドレスは求めません。aiagentsengineered.com/found。この種の本には宣伝部がありません。ですから、その答えが、本書の存在をほかのエンジニアに伝えるために使えるわずかな時間を、どこに振り向けるべきかを教えてくれます。