APEフレームワークとは
APEフレームワークは、大規模言語モデルに思考を分析・計画・実行へと分離させるプロンプトテンプレートです。 未分化な回答が1つ返ってくるのではなく、モデルが問題をどう理解したか、どう解決するつもりか、そして最終出力が見えます。各段階を検証できるため、信頼性が向上します。
APEは、複雑なタスクや高リスクのタスクで特に有効です。推論の道筋を明示的に示させることで、隠れた前提や近道が見えないまま残るリスクを減らせます。この3部構成のパターンはすべてのモデルで機能します。クラウドAPIでも、OllamaやLM Studio経由のローカルモデルでも同様に動作し、結果の一貫性を保ちます。
3つのステップ:分析・計画・実行
APEフレームワークの核心は、すべてのプロンプトがモデルに対して、まず問題を分析し、次に解決策を計画し、その後で初めて最終回答を実行するよう指示する点にあります。 この3ステップは人間が推論を進める方法に直接対応しており、明確なチェックポイントを提供します。
このセクションでは、典型的な内訳を示します。
- 分析:タスクを自分の言葉で言い換え、主要な制約を特定し、不足している情報を明らかにします。
- 計画:タスクを解決するために従う、短い段階的なアプローチを提案します。
- 実行:計画に従い、指定された構造とフォーマットで最終回答を生成します。
APEフレームワークを使うべき場面
タスクが十分に複雑で、最終出力だけでなくモデルの推論も気になる場合に、APEフレームワークを使ってください。 技術分析、複数段階のリサーチ、戦略的な文章作成、そしてエラーのコストが高いあらゆる状況が該当します。
典型的なユースケースは次のとおりです。
- プロダクト要件をユーザーストーリーと受け入れ基準に分解する。
- 生のメモと市場情報からコンテンツ戦略を設計する。
- トレードオフとリスクを説明しながらコードをレビュー・リファクタリングする。
- 構成が文言と同じくらい重要な長文レポートを企画・執筆する。
⚠️ 注意
APEはトークンのオーバーヘッドを追加します。分析と計画の段階が、最終的な実行の前に出力トークンを消費するためです。最終回答だけが必要で推論を検証しない大量処理の本番タスクでは、よりシンプルなシングルステップのプロンプトを使い、コストとレイテンシを抑えてください。
APEプロンプトの書き方
効果的なAPEプロンプトは、3つの段階を名前で明示し、各パートで期待する内容を指定します。分析メモ、段階的な計画、そして最終出力です。 これらはコンパクトに書けるため、単一のプロンプトとして成立します。
汎用パターンは次のとおりです。
「あなたは役割です。まず、主要な目標・制約・不足情報を列挙してタスクを分析してください。次に、アプローチを3〜5個の箇条書きで計画してください。最後に、計画に厳密に従って希望する出力形式を生成し、実行してください。」
この基本パターンには、対象読者、トーン、ファイル構成、引用要件といったドメイン固有の詳細を追加できます。一度定義すれば、目的とコンテキストを変えるだけで同じAPEプロンプトを複数のタスクに再利用できます。
🔍 プロのヒント
モデルが分析と計画を完了したら、実行結果を見る前にそれらを読んでください。分析が制約を見落としていたり、計画に誤ったステップがあれば、モデルに修正を指示します。応答全体を再生成するより安価かつ高速です。
実例:悪いAPEプロンプトと良いAPEプロンプト
構造化されていないプロンプトとAPEプロンプトの違いは、同じタスクで比較すると明確になります。 ここでは製品ローンチのメールを例に説明します。
悪いプロンプト
「新しい分析ダッシュボードを発表するメールを書いてください。」
良いプロンプト
「あなたはSaaSのプロダクトマーケターです。目的:既存顧客向けに、新しい分析ダッシュボードの発表メールを作成すること。APE構造:1)分析:ターゲット読者、その主な課題、このダッシュボードが解決する主要なメリットを簡潔に列挙してください。2)計画:メールの構成を3〜5個の箇条書きで示してください(フック、主要メリット、行動喚起など)。3)実行:明快でプロフェッショナルなトーンで最終メール(220語以内)を書いてください。件名、プレビューテキスト、本文を含めてください。」
APEフレームワークを使うと、モデルはメールを生成する前に問題の理解と計画を提示します。そのため、ズレを早い段階で発見しやすくなります。
PromptQuorumにおけるAPEフレームワークの実装
PromptQuorumはマルチモデルのAIディスパッチツールで、APEフレームワークを組み込みプロンプト構造の1つとして搭載しています。ワンクリックで分析・計画・実行のプロンプトを適用できます。 PromptQuorumでAPEオプションを選ぶと、アプリが目的とコンテキストの周囲に3ステップ構造を自動的に挿入します。
PromptQuorum内でのAPEフレームワークの働きは次のとおりです。
- 分析・計画・実行それぞれの期待値を記入するラベル付きセクションを提供するため、毎回パターンを覚えておく必要がありません。
- 同じAPE構造のプロンプトを複数モデルへ並列送信し、各段階でモデルごとの応答を比較しやすくします。
- コードレビュー、戦略メモ、リサーチブリーフなど、繰り返し使うワークフロー向けにテンプレートとして保存できます。
APEと他フレームワークの使い分け
明示的な推論ステップは欲しいが、多数のパラメータやセクションは不要という場合に、他のプロンプトフレームワークではなくAPEを選んでください。 APEは意図的にコンパクトです。3段階あれば、ユーザーに負担をかけずに明確さを高められることが多いためです。
実務上の使い分けは次のとおりです。
- 推論が重要で、かつ自己完結した複雑なタスクにはAPEを選びます。
- 出力形式が既に決まっており、よく指定された指示が1つあれば足りる場合はシングルステップ型のフレームワークを選びます。
- プロンプトに反映すべき厳格な社内標準がある場合にのみ、より詳細なフレームワーク(多数のセクションとパラメータを持つもの)を選びます。
フレームワーク | 段階/セクション数 | 適した用途 | 推論は可視化されるか |
|---|---|---|---|
| APE | 3(分析、計画、実行) | 推論の検証が必要な複雑なタスク | はい — 明示的な段階 |
| シングルステップ | 1(単一の指示) | シンプルで明確に定義されたタスク | いいえ |
| CRAFT | 5(Context, Role, Action, Format, Target) | 包括的なコンテキスト定義 | 任意 |
| CO-STAR | 6(Context, Objective, Style, Tone, Audience, Response) | マーケティングとコミュニケーション | いいえ |
| SPECS | 5(Situation, Problem, Examples, Constraints, Style) | 実例を用いた問題解決 | 任意 |
| Chain-of-Thought | 1(「ステップバイステップで考えて」を付加) | 数学、論理、単一パスの推論 | はい — ただし非構造的 |
🔍 豆知識
APEの3段階構造は、人間の専門家が複雑な問題に取り組む方法と直接対応しています。問題を理解し(分析)、アプローチを設計し(計画)、成果物を生成する(実行)という流れです。認知科学の研究では、この分離が人間とAIの双方で推論エラーを減らすことが示されています。
APEのもう1つの意味:Automatic Prompt Engineering(別概念)
補足:「APE」はAutomatic Prompt Engineeringを指す場合もあります。これは上記のAnalyze-Plan-Executeフレームワークとは別の技術です。Automatic Prompt Engineering(Zhou et al., 2022)はAIを使ってプロンプトの候補を自動生成・採点し、手作業の試行錯誤なしに最適な表現を見つけます。その手順は次のとおりです。
- 1タスク、成功指標、いくつかのシード例を定義します。 例:タスク=「顧客フィードバックの感情を分類する」。成功指標=「ラベル付き20件での正解率」。シード例=正しい感情ラベル付きの多様な顧客メッセージ3件。
- 2APEツールまたはChatGPTでプロンプト候補を自動生成します。 タスクと例を渡し、「このタスクを解けそうなプロンプトのバリエーションを5つ生成してください。指示スタイル、例、制約を変えてください」と依頼します。各候補をテストセットで評価します。
- 3各候補を成功指標で採点します。 すべての候補をホールドアウトした例で実行し、正解率、速度、コストを記録します。APEの狙いは、手作業の試行錯誤なしに最良のプロンプトを見つけることです。
- 4反復します:上位2つの候補を選び、オプティマイザにその変異版を生成させます。 候補3が正解率85%、候補5が82%だった場合、「候補3に近いが特定の調整を加えたバリエーションを生成して」と依頼します。段階的に洗練させていきます。
- 5強いプロンプトが得られたら、新しいデータでテストして汎化を確認します。 最適化したプロンプトはテストセットで良好でしたが、未知の新しい例でも機能するか検証してください。性能が落ちる場合、テストデータに過剰適合している可能性があります。
よくある質問
APEは何の略ですか?
APEはAnalyze(分析)、Plan(計画)、Execute(実行)の略です。複雑な推論を3つの明示的な段階に分割するプロンプトフレームワークです。問題の理解、アプローチの計画、解決策の実行という段階です。
モデルに単に答えを求めるのと、APEはどう違いますか?
APEを使うと、モデルの思考プロセスが見えるようになります。単一の回答ではなく、モデルがタスクをどう理解し、どの計画を選び、最終出力がどうなったかが分かります。そのためエラーを発見しやすく、結果の信頼性が高まります。
シングルステップ・プロンプト法ではなくAPEを使うべきなのはいつですか?
推論がタスクにとって重要な場合にAPEを使ってください。技術分析、コードレビュー、戦略立案、エラーのコストが高い状況などです。目的が最初から明確で、主に実行速度が必要な場合はシングルステップを使ってください。
OllamaやLM Studioのようなローカルモデルでも使えますか?
はい。APEはどのモデルでも機能します。OpenAI、Anthropic、Googleのフロンティアモデルでも、OllamaやLM Studio経由のローカルモデルでも同様です。同じ3ステップ構造がすべてのプラットフォームで適用できます。
APEプロンプトはどれくらいの長さが必要ですか?
APEプロンプトはコンパクトで構いません。分析・計画・実行に言及し、各段階で期待する内容を指定した1段落があれば十分です。このフレームワークが扱うのは構造であって、長さではありません。
APEプロンプトをPromptQuorumのテンプレートとして保存できますか?
はい。特定のワークフロー(コードレビュー、顧客要約など)でうまく機能するAPE構造のプロンプトを作成したら、PromptQuorumにテンプレートとして保存し、チームと共有できます。
タスクがAPEには単純すぎる場合はどうすればよいですか?
タスクが単純で可視化された推論を必要としないなら、シングルステップ・プロンプト法で十分でしょう。APEはオーバーヘッドを追加します。その価値は、モデルの推論を検証し洗練できる点にあります。
APEプロンプトがうまく機能しているかどうかは、どう判断しますか?
代表的な例3〜5件でAPEプロンプトを実行し、次を確認してください。(1)分析は本質的な課題を捉えているか。(2)計画は妥当で実行可能か。(3)実行は計画に従っているか。いずれかの段階が弱ければ、プロンプトを改善して再テストします。
APE(Analyze-Plan-Execute)とAPE(Automatic Prompt Engineering)の違いは何ですか?
頭字語は同じですが、まったく異なる技術です。APE(Analyze-Plan-Execute)は自分で書く手動のプロンプト構造です。APE(Automatic Prompt Engineering, Zhou et al. 2022)は、AIが自動的にプロンプト候補を生成・採点して最適な表現を見つける技術です。この記事は両方を扱っています。主なフレームワークはAnalyze-Plan-Executeで、自動プロンプト最適化は最終セクションで説明しています。
関連記事
- Chain-of-Thoughtプロンプティング — APEが3段階に形式化した推論技術
- どのプロンプトフレームワークを使うべきか? — APE、CRAFT、CO-STAR、SPECSの比較
- シングルステップ・プロンプト法 — APEの3段階が必要ではない場合
- すべてのプロンプトに必要な5つの構成要素 — APEの各段階が整理する普遍的な構成要素
- ペルソナ・プロンプティング — APEの役割定義と組み合わせて、専門領域の分析に活用
- プロンプトチェーン — 単一のAPEプロンプトには複雑すぎるタスクで、複数のAPEステップを連鎖させる
参考文献
- White et al. (2023). "A Prompt Pattern Catalog to Enhance Prompt Engineering with ChatGPT." arXiv:2302.11382 — 構造化推論パターンを含むプロンプトパターンの分類
- Zhou et al. (2022). "Large Language Models Are Human-Level Prompt Engineers." arXiv:2211.01910 — Automatic Prompt Engineering(APE)の原論文
- Anthropic. "Prompt Engineering Guide." docs.anthropic.com — 構造化プロンプティングのベストプラクティス
- OpenAI. "Prompt Engineering Guide." platform.openai.com — 段階的推論と構造化出力のガイダンス
