GASでClaude APIの
システムプロンプトで役割と回答ルールを固定する方法

function askClaude() {
  const apiKey = PropertiesService.getScriptProperties().getProperty('CLAUDE_API_KEY');

  const payload = {
    model: 'claude-haiku-4-5',
    max_tokens: 1024,
    // system = AIの役割・前提。毎回の会話の土台になる
    system: 'あなたは自社ECサイトの丁寧なサポート担当です。常に敬体（です・ます）で答えます。',
    // messages = 今回の具体的な依頼
    messages: [
      { role: 'user', content: 'パスワードを忘れました。どうすればいいですか？' }
    ]
  };

  const res = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', {
    method: 'post',
    contentType: 'application/json',
    headers: {
      'x-api-key': apiKey,
      'anthropic-version': '2023-06-01'
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true
  });

  const json = JSON.parse(res.getContentText());
  Logger.log(json.content[0].text); // AIの回答テキスト
}

// 役割・口調・守ることを見出しと箇条書きで整理する
const SYSTEM_PROMPT = [
  '# 役割',
  'あなたは自社ECサイトのカスタマーサポート担当です。',
  '',
  '# 口調',
  '- 常に敬体（です・ます）で答える',
  '- 専門用語は避け、中学生にも分かる言葉にする',
  '',
  '# 守ること',
  '- 分からないことは推測せず「担当者に確認します」と答える',
  '- 返金や社内規定に関わる約束はしない',
  '- 回答は3文以内にまとめる'
].join('\n');

// systemとuserを分けて渡せる呼び出し関数
function callClaude(systemPrompt, userText) {
  const apiKey = PropertiesService.getScriptProperties().getProperty('CLAUDE_API_KEY');

  const res = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', {
    method: 'post',
    contentType: 'application/json',
    headers: { 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' },
    payload: JSON.stringify({
      model: 'claude-haiku-4-5',
      max_tokens: 1024,
      system: systemPrompt,                           // 変わらないルール
      messages: [{ role: 'user', content: userText }] // 都度の質問
    }),
    muteHttpExceptions: true
  });

  return JSON.parse(res.getContentText()).content[0].text;
}

function run() {
  const answer = callClaude(SYSTEM_PROMPT, '注文をキャンセルしたいです');
  Logger.log(answer);
}

// 手本（正解例）をmessagesに入れて出力の形を安定させる
function classifyInquiry(text) {
  const apiKey = PropertiesService.getScriptProperties().getProperty('CLAUDE_API_KEY');
  const system = '問い合わせを「配送」「返品」「その他」のいずれか1語で分類する。説明や記号は付けない。';

  const messages = [
    // ↓ ここが few-shot（手本）。2往復入れると形が固まる
    { role: 'user', content: '荷物がまだ届きません' },
    { role: 'assistant', content: '配送' },
    { role: 'user', content: 'サイズが合わないので交換したい' },
    { role: 'assistant', content: '返品' },
    // ↓ 実際に分類したい文
    { role: 'user', content: text }
  ];

  const res = UrlFetchApp.fetch('https://api.anthropic.com/v1/messages', {
    method: 'post',
    contentType: 'application/json',
    headers: { 'x-api-key': apiKey, 'anthropic-version': '2023-06-01' },
    payload: JSON.stringify({
      model: 'claude-haiku-4-5',
      max_tokens: 20,
      system: system,
      messages: messages
    }),
    muteHttpExceptions: true
  });

  return JSON.parse(res.getContentText()).content[0].text.trim();
}

// 長いsystemは配列にして cache_control を付けると使い回せる
const payload = {
  model: 'claude-haiku-4-5',
  max_tokens: 512,
  system: [
    {
      type: 'text',
      text: LONG_SYSTEM_PROMPT,            // 共通ルール・用語集・FAQなど長い前提
      cache_control: { type: 'ephemeral' } // ここまでをキャッシュ対象にする
    }
  ],
  messages: [{ role: 'user', content: userText }]
};
// 2回目以降、同じsystemを送るとキャッシュヒットで入力料金が下がる

// スプレッドシートの問い合わせに、同じルールで一括返信下書き
function replyDraftForRows() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const last = sheet.getLastRow();
  if (last < 2) return;
  const values = sheet.getRange(2, 1, last - 1, 2).getValues(); // A:本文 B:状態

  const system = [
    'あなたは丁寧な日本語のサポート担当です。',
    '敬体で、3文以内、謝意→対応→次の案内の順で返信文の下書きを書く。',
    '断定できない社内情報には触れない。'
  ].join('\n');

  values.forEach((row, i) => {
    const inquiry = row[0]; // A列: 問い合わせ本文
    const done = row[1];    // B列: 生成済みフラグ
    if (!inquiry || done) return; // 空行・処理済みはスキップ

    const draft = callClaude(system, inquiry); // 前掲のcallClaudeを再利用
    sheet.getRange(i + 2, 3).setValue(draft);  // C列に下書きを書き込み
    sheet.getRange(i + 2, 2).setValue('done'); // 二重生成を防ぐ
    Utilities.sleep(500); // レート制限対策に軽く間隔を空ける
  });
}