Architect Professional ドメイン2: Claude のモデル・プロンプト・コンテキストエンジニアリング(13%)
この章で学ぶこと: トレードオフにもとづくモデルの選び方とモデルの組み合わせ、システムプロンプト・テンプレート・ガードレールの設計、zero-shot / few-shot / chain-of-thought の使い分け、コンテキストウィンドウとトークンの管理、プロンプトの再利用(キャッシュ、モジュール化、Skills)。
| タスク(試験ガイド) | この章の節 |
|---|---|
| トレードオフに基づいて適切な Claude モデルを選ぶ | 第1節 |
| システムプロンプト、テンプレート、ガードレールを設計する | 第2節 |
| プロンプト手法を使う(zero-shot、few-shot、chain-of-thought) | 第3節 |
| コンテキストウィンドウを最適化し、トークン使用量を管理する | 第4節 |
| プロンプト再利用の戦略を実装する(キャッシュ、モジュール化したプロンプト、Skills) | 第5節 |
本番の63問のうち約8問です。
基礎はここで復習してください:
- 今のモデルの一覧、料金、effort、fast mode、破壊的な変化 → Developer F ドメイン5
- プロンプトの書き方、few-shot、context editing、圧縮 → Developer F ドメイン6
- プロンプトキャッシュの書き方と料金 → Developer F ドメイン2 第3.7節
- Skills の段階的な読み込み → Developer F ドメイン8 第3節
- few-shot、構造化出力、バッチ → Architect F ドメイン4
- 長いコンテキストの管理と信頼性 → Architect F ドメイン5
1. トレードオフでモデルを選ぶ
1.1 今のモデルの位置づけ(2026年11月時点)
数字は Developer F ドメイン5 第3.1節 の表をもとにしています。モデル名と料金はよく変わるので、本番前に公式の Models overview で確かめてください。
| モデル | 位置づけ | 料金(入力 / 出力、100万トークンあたり) |
|---|---|---|
| Claude Fable 5.1 | いちばん能力が高い。データの30日保持が必要(第1.4節) | $10 / $50 |
| Claude Opus 5.5 | 高い能力。複雑な推論、エージェントのリード | $4 / $20 |
| Claude Sonnet 5.5 | 能力と速さのバランス | $2 / $10 |
| Claude Haiku 5.5 | いちばん速く安い。大量の単純作業、サブエージェント | $0.10〜 / $0.50〜 |
1.2 選ぶ軸
| 軸 | 見るもの | 打ち手 |
|---|---|---|
| 品質 | 自分の評価セットでの正答率 | 上位モデル、高い effort |
| 遅延 | TTFT、出力の速さ、p95 | 小さいモデル、低い effort、ストリーミング、fast mode、キャッシュ |
| コスト | 1件あたりのトークン × 単価 | 小さいモデル、キャッシュ、バッチ(50%)、トークン削減 |
| データの扱い | 保持の要件(ZDR、HIPAA)、利用できる提供経路 | 要件に合うモデルと経路を選ぶ(ドメイン5) |
| 機能 | ツール検索、fast mode、画像などに対応しているか | 対応表を確かめる |
公式の考え方(Developer F ドメイン5 第3.2節): 「効率から始める」(Haiku で作り、足りないときだけ上げる)と「能力から始める」(Opus で作り、あとで effort を下げたり小さいモデルにしたりする)の2つがあります。どちらでも、最後は自分の評価で決めます。
1.3 1つに決めない: 組み合わせる
| 組み合わせ | しくみ | 効果 |
|---|---|---|
| ルーティング | 分類器(小さいモデルやルール)が、簡単な依頼を Haiku、難しい依頼を上位モデルへ | 平均のコストと遅延を下げる |
| リードとワーカー | 上位モデルが計画、小さいモデルが大量の検索や抽出 | 品質を保ちつつコストを下げる |
| 段階で変える | 前処理(分類・抽出)は Haiku、最終の生成は Sonnet | 段ごとに必要な能力だけ払う |
| フォールバック | 混雑(529)や対応外の機能のとき、別のモデルや経路へ | 可用性の SLA を守る |
1.4 データ保持の要件がモデル選択を決めることがある
公式の API and data retention によると、Claude Fable 5.1、Mythos 5.1、Fable 5、Mythos 5 は「Covered Models」で、30日のデータ保持が必要です。Anthropic が特に認めない限り ZDR では使えません。ZDR の組織でこれらを使うには、特定のワークスペースだけで30日保持を有効にします(既定のワークスペースは組織の設定に従うので別のワークスペースを使う)。
試験での使い方: 「ZDR が必須の組織で、いちばん能力の高いモデルを使いたい」→ そのまま使えるとは限らない。要件と機能の対応表を確かめる。
2. システムプロンプト、テンプレート、ガードレール
2.1 システムプロンプトの部品
| 部品 | 中身 | 置き場所 |
|---|---|---|
| 役割と目的 | 誰のために何をするか、なぜか | system の先頭 |
| 守る決まり | やってはいけないこと、断り方、エスカレーションの条件 | system |
| 背景の知識 | 方針文書、用語集 | system(長くて固定ならキャッシュ) |
| 出力の形 | スキーマ、長さ、口調 | system または構造化出力 |
| 例 | よい例・悪い例 | system の中の <examples> など |
| その時の入力 | ユーザーの質問、検索結果 | user のメッセージ(毎回変わるので後ろ) |
2.2 テンプレート化
テンプレートは、変わらない部分と変わる部分(変数)を分けたプロンプトです。
| 良い点 | 例 |
|---|---|
| バージョン管理と比較ができる | support_v3.txt を Git で管理し、評価結果と結びつける |
| キャッシュしやすい | 変わらない部分を先頭にまとめる |
| 安全 | 変数に入るユーザー入力をタグで囲み、「指示ではなくデータ」と明示する |
2.3 ガードレールを何重にも
プロンプトだけに頼るのはガードレールとして弱い、が試験の定番です。
| 層 | 例 | 強さ |
|---|---|---|
| 権限 | 不要なツールを外す、読み取り専用の資格情報 | 強い(できないことは起きない) |
| プログラムの検査 | フック(PreToolUse)、スキーマ検証、金額の上限 | 強い(毎回確実) |
| 入力・出力の分類 | 軽いモデルで有害な入力や出力を判定 | 中 |
| プロンプトの指示 | 「〜してはいけない」 | 弱め(確率的) |
| 人の確認 | 影響の大きい操作の前に承認 | 強いが遅い(ドメイン5) |
3. プロンプト手法の使い分け
| 手法 | しくみ | 向いている | 注意 |
|---|---|---|---|
| zero-shot | 指示だけ | 簡単でよくある仕事。まずここから | 形式がぶれやすい |
| few-shot(multi-shot) | 例を3〜5個ほど見せる | 形式・口調・判断の境目をそろえたい | 例が似すぎると、その形に引きずられる。多様な例と境目の例を入れる |
| chain-of-thought(CoT) | 答える前に考えさせる | 多段階の推論、計算、判断の根拠が要る | トークンと遅延が増える |
3.1 今のモデルでの chain-of-thought
今の Claude のモデルは、thinking(考える過程)を API の機能として持っています(多くのモデルは適応型で、effort で考える量を調整)。そのため、
- 推論の量は、プロンプトで「段階的に考えて」と書くより、まず effort で調整する
- thinking を使わない場面でも、考える部分と答えの部分をタグ(例:
<thinking>と<answer>)で分けさせると、答えだけを取り出せる - 考えた過程をそのまま利用者に見せない。ログやデバッグには役立つ
注意: プロンプトでの CoT と API の thinking の関係の説明は、この教材の整理です。公式の最新の書き方は Prompting best practices を見てください。
3.2 選び方の流れ
- zero-shot で試す → 評価する
- 形式や判断の境目がぶれる → few-shot を足す
- 多段階の推論で間違える → thinking / effort を上げる、または CoT を足す
- それでも足りない → 仕事を分ける(プロンプトチェーン)、モデルを上げる
4. コンテキストウィンドウとトークン
4.1 「入るから全部入れる」は悪手
今のモデルはコンテキストウィンドウが 1M トークンですが、多く入れるほど、
- コストと遅延が増える
- 関係ない情報に気を取られ、精度が下がることがある(Anthropic の Contextual Retrieval の記事も「情報が多いと気が散る」と書いている)
4.2 管理の打ち手
| 打ち手 | 何をするか | 詳しく |
|---|---|---|
| 必要な情報だけ入れる | 検索で絞る、ツールの出力の項目を削る | ドメイン3 |
| 段階的に見せる | ツールや知識を必要なときだけ読み込む(ツール検索、Skills) | ドメイン3 第8節 |
| 古い結果を消す | context editing でツールの結果を消す | Developer F ドメイン6 第1.3節 |
| 要約して続ける | compaction | Developer F ドメイン6 第1.4節 |
| サブエージェントに任せる | 細かい探索は別のコンテキストで、要約だけ返す | ドメイン1 第4節 |
| 送る前に数える | トークン数を数える API | Developer F ドメイン5 第4.3節 |
| 出力の上限 | max_tokens、短い出力形式 |
4.3 新しいトークナイザーに注意
Developer F ドメイン5 によると、Claude 4.7 以降のモデルは新しいトークナイザーを使い、同じ文章でも約30%多くトークンになります。モデルを移行するときは、トークン数・コスト・コンテキストの予算を数え直します。
5. プロンプトの再利用
5.1 3つの方法の比較
| 方法 | しくみ | 主な効果 | 向いている |
|---|---|---|---|
| プロンプトキャッシュ | 毎回同じ先頭部分をキャッシュして再利用 | コスト(読み込みは入力の0.1倍)と TTFT の両方を下げる | 長いシステムプロンプト、方針文書、ツール定義、長い会話 |
| モジュール化したプロンプト | 部品(役割、決まり、出力形式、例)に分け、組み合わせる | 保守しやすい、チーム間で共有、部品ごとに評価 | 多くのアプリで同じ決まりを使う |
| Skills | 指示・スクリプト・資料のフォルダー。必要なときだけ読み込む | 使わない知識はほぼトークンを使わない(メタデータ約100トークン) | くり返す手順、専門の作業 |
5.2 キャッシュの設計(試験のサンプル問題2と同じ論点)
毎回同じ 8,000 トークンのシステムプロンプトと方針文書を送り、後ろに短いユーザーの質問がつくアプリ → 変わらない部分を前に置き、プロンプトキャッシュを有効にします。文書を短く切る、むやみに小さいモデルにする、few-shot に移す、はどれも両方(遅延とコスト)に効く打ち手ではありません。
| 設計の決まり | 理由 |
|---|---|
| 変わらないものを前、変わるものを後ろ | キャッシュは先頭からの一致。tools → system → messages の順 |
| 先頭にタイムスタンプやユーザー名を入れない | 毎回変わる値があると、その後ろがすべてキャッシュされない |
| 会話の途中で effort やツール定義を変えない | キャッシュが無効になる |
| 最小の長さを超えているか確かめる | 短いとエラーなしでキャッシュされない。usage.cache_read_input_tokens で確認 |
| 呼び出しの間隔が5分を超えるなら1時間 TTL も検討 | 書き込みは2倍になるが、毎回書き直すより安いことがある |
5.3 モジュール化の例(考え方)
[共通] 会社の決まり(全アプリで同じ) ← キャッシュの先頭
[共通] 出力の形式
[アプリ別] サポート用の役割と例
[毎回] 検索結果とユーザーの質問 ← 後ろ
共通部分を前に置くと、アプリをまたいでも同じ順番になり、キャッシュが効きやすくなります(キャッシュは組織やワークスペースの単位で共有されるかなどの細かい条件は、公式の Prompt caching で確かめてください)。
6. 試験に向けたまとめ
- モデルは評価で決める。ルーティングやリード・ワーカーで組み合わせる
- データ保持の要件(ZDR、Covered Models の30日保持)がモデルの選択を縛ることがある
- ガードレールは何重にも。権限とプログラムの検査が強く、プロンプトの指示は弱い
- zero-shot → few-shot → thinking / CoT → 分解 → 上位モデル、の順に試す
- コンテキストは「入るだけ入れる」ではなく「必要なものだけ」
- 同じ長い先頭部分 → 前に置いてキャッシュ。毎回変わる値を先頭に入れない
- くり返す専門の手順 → Skills(段階的に読み込む)
7. 用語集
| 用語 | 意味 |
|---|---|
| Covered Models | 30日のデータ保持が必要なモデル(Fable 5.1 など) |
| テンプレート | 固定部分と変数を分けたプロンプト |
| chain-of-thought | 答える前に考える過程を書かせる手法 |
| TTFT | 最初のトークンが出るまでの時間 |
| モジュール化したプロンプト | 部品に分けて組み合わせるプロンプト |
出典
- Models overview(Claude Platform Docs): 今のモデルと料金(数字は Developer F ドメイン5 の表を使用)
- API and data retention(Claude Platform Docs): Covered Models の30日保持、ZDR、ワークスペース単位の設定
- Prompt caching(Claude Platform Docs): 順番、TTL、料金、最小の長さ
- Prompt engineering overview / Prompting best practices(Claude Platform Docs): 例、XML のタグ、thinking、プロンプトチェーンなどは best practices が最新の参考
- Agent Skills(Claude Platform Docs): 段階的な読み込み
- Introducing Contextual Retrieval(Anthropic): 情報が多いとモデルが気を取られることがある
- 試験ガイド サンプル問題2
注意: 第2.3節の「強さ」の評価、第3.1節の CoT と thinking の関係、第5.3節のモジュールの並べ方は、この教材の整理です。モデル名・料金・対応機能は変わりやすい情報です。