System Prompt と役割設定

System Prompt (システムプロンプト)

Claude API では、メッセージとは別に system prompt を指定できます。 ここには、Claude の役割・トーン・制約 を書きます。

client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system="あなたは親切な料理のプロです。家庭で作れるレシピだけを提案してください。",
    messages=[{"role": "user", "content": "夕食のアイデアをください"}],
)

役割 (Role) を与える効果

• 出力のトーン・専門性が安定する。
• 不適切なトピックを避けやすくなる。
• 出力フォーマットの一貫性が増す。

system / user / assistant

• system: 会話の前提・人格・ルールを定義 (会話の最初に 1 つ)。
• user: 個別のリクエスト。
• assistant: モデルの応答。マルチターン会話では履歴として渡す。

よくある system prompt のテンプレート

あなたは {role} です。

## タスク
{task}

## 出力フォーマット
{format}

## 制約
- {constraint_1}
- {constraint_2}

## 知らない場合
事実が分からない場合は「わかりません」と答えてください。推測しないでください。

system に置くと効くもの

Tip 1: 具体例を system に置いて Cache を効かせる

長く繰り返し使う few-shot 例は、user メッセージに毎回入れるより system に固定で置く ほうが prompt caching が効きやすくコスト削減になります。 これは第 4 章で詳しく扱います。

Tip 2: system は 1 回だけ 設計、user は毎回変わる

system は アプリケーションが固定する 文字列、 user は ユーザー入力が動的に入る 箇所と捉えると設計しやすいです。

同じユーザー質問でも system で答えが変わる

実際に system を変えて挙動の違いを見てみましょう。