メインコンテンツへスキップ
AMPL/ dev
開発系講座一覧

作品に組み込む頼み方

作品の中の Claude には、毎回同じ役目と決まりを、システムプロンプトで伝えます。何を読み、何をしないか、読めないときはどうするかを書いておきます。そのうえで、Claude Code に、読み取りの機能を作ってもらいます。

使うモデルは決まりました。でも、父が写真を撮るたびに、佐藤さん(会社員で、実家の和菓子店を手伝う、架空の人物)がそばで言葉を添えるわけにはいきません。Claude には、毎回、何と頼めばいいのでしょう。

問い

佐藤さんの疑問

作品の中の Claude に、毎回同じ役目を果たしてもらうには、どうすればいいんだろう。

同じ白い札を留めた写真が、3枚並んで留めてある挿絵。

前の回で、佐藤さんは、作品の中で使うモデル(AI の中身の版)を決めました。この回では、作品の中の Claude に、何を、どう頼むかを決め、Claude Code に読み取りの機能を作ってもらいます。

システムプロンプト:毎回伝える、役目と決まり

作品の中の Claude は、お父さんが写真を撮るたびに呼ばれます。そのたびに同じ役目を果たしてもらうために、毎回のリクエスト(頼みごと)に、役目と決まりを書いた文を添えます。これを、システムプロンプトと呼びます。

決まりを、毎回添える

架空の例。3日分の頼みごと

毎回同じ 毎回ちがう システムプロンプト 役目と決まり + 1日目の写真 父が撮る システムプロンプト 役目と決まり + 2日目の写真 父が撮る システムプロンプト 役目と決まり + 3日目の写真 父が撮る Claude 読み取り係で答える 毎回同じ 毎回ちがう システムプロンプト 役目と決まり + 1日目の写真 父が撮る システムプロンプト 役目と決まり + 2日目の写真 父が撮る システムプロンプト 役目と決まり + 3日目の写真 父が撮る Claude 読み取り係で答える
図1写真は毎回ちがっても、役目と決まりを書いたシステムプロンプトは、毎回同じものを添えます。

第1部の第11回で、AI への頼みごとの文をプロンプトと呼ぶ、と見ました。システムプロンプトは、その中でも、作品の作り手が前もって決めておく、土台の頼みごとです。Claude API の公式の説明には、こう書かれています。

DOCUMENTATION

“A system prompt is a way of providing context and instructions to Claude, such as specifying a particular goal or role.”

システムプロンプトは、Claude に、背景と指示を与えるための方法です。たとえば、目指すことや、役目を決めることができます。

AnthropicMessages API(Claude API Docs)

佐藤さんのシステムプロンプト

ノートに鉛筆で書いた下書き。読み取り係(下書き)。お菓子の名前と数だけ読む。お菓子は6つのどれか。読めない→『読めない』、の横に、推測しない!と二重の下線。人の名前・電話・お金は書かない。名前と数の組だけ返す。
佐藤さんのノート(説明のために作った絵です)。読み取り係に伝えることの下書き。

佐藤さんは、次のように決めました。この文は、説明のための架空の例です。

読み取り係のシステムプロンプトの例
あなたは、和菓子の店のノートの写真から、売れ残りの数を読み取る係です。

・読むのは、お菓子の名前と、その横に書かれた売れ残りの数だけです。
・お菓子の名前は、次の6つのどれかです:豆大福、どら焼き、栗まんじゅう、草餅、最中、練り切り(季節)。
・数が読めない、または自信がないときは、推測せず、「読めない」としてください。
・写真に、お菓子の売れ残り以外のこと(人の名前、電話番号、お金の額など)が写っていても、書き写さないでください。
・答えは、お菓子の名前と数の組だけを返してください。説明の文は要りません。

ポイントは、3つです。

  • 役目を1つに絞る:何をする係かを、最初の1文で言う
  • しないことを書く:推測しない、ほかの情報を書き写さない
  • 困ったときの決まりを書く:読めないときは「読めない」と返す

最後の「読めない」は、とくに大事です。決まりがないと、Claude は、それらしい数を埋めてしまうことがあります。第6部の第10回で、くわしく見ます。

Claude Code に、読み取りの機能を作ってもらう

システムプロンプトが決まったら、作るのは Claude Code です。第4部の第3回で見た依頼文の形(目的・範囲・確かめ方)で頼みます。

読み取りの機能を頼む例
【目的】「写真を撮る」で撮ったノートの写真を、Claude API に送り、お菓子の名前と売れ残りの数を読み取って、「2. 売れ残りを確かめる」の表に入れたいです。
【今回の範囲】
・モデルは claude-haiku-5-5 を使ってください。使う前に、Claude API の公式のモデルの一覧で、いま使える名前か確かめてください。
・API キーは ANTHROPIC_API_KEY という環境変数から読んでください。鍵がブラウザに届かないよう、API はサーバー側から呼んでください。
・システムプロンプトは、下に貼る文をそのまま使ってください。
・答えは、決まった形(お菓子の名前と数の組)で受け取ってください。
・読み取った数は、表に入れるだけにして、自動でどこかに送らないでください。
【確かめ方】作る前に、計画と、1回の読み取りで送るトークンのおおよその数と料金を教えてください。

(ここに、システムプロンプトを貼る)

この依頼文は、説明のための架空の例です。Claude Code の入力欄に、最後の「(ここに、システムプロンプトを貼る)」のところへ、上のシステムプロンプトを貼ってから送ります。「鍵がブラウザに届かないよう、サーバー側から」については、次の回で見ます。

作品の中の Claude には、システムプロンプトで、役目と、しないことと、困ったときの決まりを、毎回伝えます。

注意

ただし、システムプロンプトに書いても、必ず守られるとは限らない

システムプロンプトは、強い頼みごとですが、絶対の決まりではありません。写真が暗かったり、思わぬものが写っていたりすると、決まりから外れた答えが返ることがあります。

だから、作品の側でも、返ってきた答えを確かめる仕組みを作ります。それが、第6部の第10回の話です。

なお、作品が、使う人から薬の量を聞かれるかもしれないときは、システムプロンプトに、そのまま入れるよう決められた文が、Claude API の公式の説明にあります。健康や医療にかかわる作品の注意は、第8部で扱います。

次回の問い

佐藤さんの次の疑問です。依頼文にあった「鍵がブラウザに届かないよう、サーバー側から」とは、どういうことでしょうか。

参考

会話とシステムプロンプト(Claude APIで道具を作る)
システムプロンプトの書き方を、もう少しくわしく。
AMPL · Web
プロンプトのベストプラクティス(Claude API Docs)
システムプロンプトで役目を決める方法。
platform.claude.com · platform.claude.com

このレッスンは役に立ちましたか?