GASでClaude APIの
プロンプトキャッシュでコスト削減する方法

// APIキーはスクリプトプロパティに保存する（コードに直書きしない）
// 「プロジェクトの設定」→「スクリプト プロパティ」で CLAUDE_API_KEY を登録
function getApiKey() {
  const key = PropertiesService
    .getScriptProperties()
    .getProperty("CLAUDE_API_KEY");
  if (!key) {
    throw new Error("CLAUDE_API_KEY が未設定です。スクリプトプロパティに登録してください。");
  }
  return key;
}

// キャッシュしたい「毎回まったく同じ」固定プロンプト
// ここに役割・出力形式・分類基準・お手本例などをまとめる（量が多いほど効果大）
const FIXED_SYSTEM = [
  "あなたは問い合わせを分類するアシスタントです。",
  "以下のカテゴリから必ず1つだけ選び、JSONで返してください。",
  "",
  "# カテゴリ一覧",
  "- 見積依頼 / サポート / クレーム / 営業 / その他",
  "",
  "# 判断基準（例）",
  "- 金額・納期・数量の相談 → 見積依頼",
  "- 不具合・使い方の質問 → サポート",
  "- 不満・謝罪要求 → クレーム",
  "- 売り込み・提携提案 → 営業",
  "",
  "# 出力形式（JSONのみ。前後に説明文を付けない）",
  '{"category":"サポート","reason":"根拠を一言で"}',
].join("\n");

// system を「文字列」ではなく「内容ブロックの配列」にして、
// 最後のブロックに cache_control を付けるとそこまでがキャッシュされる
function buildSystemBlocks() {
  return [
    {
      type: "text",
      text: FIXED_SYSTEM,
      cache_control: { type: "ephemeral" }, // ← これだけでキャッシュが有効になる
    },
  ];
}

// Claude API（Messages API）を呼び出す共通関数
// 固定部分は systemBlocks（キャッシュ対象）、可変部分は userText に渡す
function callClaude(systemBlocks, userText) {
  const url = "https://api.anthropic.com/v1/messages";
  const payload = {
    model: "claude-sonnet-4-5",
    max_tokens: 300,
    system: systemBlocks, // 配列を渡す
    messages: [{ role: "user", content: userText }],
  };

  const options = {
    method: "post",
    contentType: "application/json",
    headers: {
      "x-api-key": getApiKey(),
      "anthropic-version": "2023-06-01",
      // プロンプトキャッシュ専用のベータヘッダーは不要（正式機能）
    },
    payload: JSON.stringify(payload),
    muteHttpExceptions: true,
  };

  const res = UrlFetchApp.fetch(url, options);
  const code = res.getResponseCode();
  if (code !== 200) {
    throw new Error("Claude APIエラー: " + code + " / " + res.getContentText());
  }

  const body = JSON.parse(res.getContentText());
  // 本文と一緒に usage（トークン内訳）も返す
  return {
    text: body.content[0].text,
    usage: body.usage,
  };
}

// キャッシュが効いているかを usage で確認する
function checkCache() {
  const systemBlocks = buildSystemBlocks();

  // 1回目：キャッシュへの「書き込み」が発生する
  const first = callClaude(systemBlocks, "納期と単価を教えてください。");
  Logger.log("1回目 書き込み: " + first.usage.cache_creation_input_tokens);
  Logger.log("1回目 読み込み: " + first.usage.cache_read_input_tokens);

  // 2回目：同じ固定プロンプトなのでキャッシュから「読み込み」される
  const second = callClaude(systemBlocks, "ログインできません。対処法は？");
  Logger.log("2回目 書き込み: " + second.usage.cache_creation_input_tokens);
  Logger.log("2回目 読み込み: " + second.usage.cache_read_input_tokens);
}
// 期待するログ：
//   1回目 書き込み: 500前後 / 読み込み: 0
//   2回目 書き込み: 0      / 読み込み: 500前後  ← ヒットしている

// 問い合わせ列を1件ずつ分類し、結果を書き戻す
// systemBlocks は最初に1回だけ作り、毎回同じものを渡すのがポイント
function classifyInquiries() {
  const ss = SpreadsheetApp.getActive();
  const sheet = ss.getSheetByName("問い合わせ");
  const data = sheet.getDataRange().getValues();

  const systemBlocks = buildSystemBlocks(); // ← ループの外で1回だけ

  for (let i = 1; i < data.length; i++) {
    const text = String(data[i][0]).trim();
    const done = data[i][1]; // B列に分類済みなら入っている

    if (!text || done) continue; // 空行・処理済みはスキップ

    const result = callClaude(systemBlocks, "次の問い合わせを分類:\n" + text);
    const parsed = JSON.parse(result.text);

    sheet.getRange(i + 1, 2).setValue(parsed.category);
    sheet.getRange(i + 1, 3).setValue(parsed.reason);

    Utilities.sleep(300); // レート制限に配慮
  }
}
// 2件目以降はキャッシュヒットで固定部分の入力料金がほぼかからない。
// 5分以内に次の呼び出しが続けばキャッシュは延長され続ける。

// ❌ 悪い例：固定プロンプトに毎回変わる値を混ぜる
//   → プレフィックスが毎回変わり、キャッシュが一度もヒットしない
const badSystem = "現在時刻は " + new Date() + " です。カテゴリを選んでください…";

// ❌ 悪い例：オブジェクトを毎回バラバラの順序で文字列化する
//   → 同じ内容でも文字の並びが変わり、別物と判定される
const badMaster = JSON.stringify(masterObject); // キー順が不定

// ✅ 良い例：固定部分は完全に同じ文字列を使い回す。
//    日時やIDなどの可変値は userText（messages側）へ回す
const goodUser = "現在時刻: " + new Date() + "\n本文: " + text;

// ✅ 良い例：JSONを埋め込むならキー順を固定する
function stableJson(obj) {
  const keys = Object.keys(obj).sort();
  const sorted = {};
  keys.forEach((k) => (sorted[k] = obj[k]));
  return JSON.stringify(sorted);
}

// 長い間隔で処理する場合は 1 時間キャッシュ（ttl: "1h"）を指定できる
function buildSystemBlocks1h() {
  return [
    {
      type: "text",
      text: FIXED_SYSTEM,
      cache_control: { type: "ephemeral", ttl: "1h" },
    },
  ];
}
// 5分TTL：書き込みは通常入力の約1.25倍、読み込みは約0.1倍
// 1時間TTL：書き込みは約2倍だが、間隔が空いても消えにくい
// → 数分おきに回すなら既定の5分、1時間おきなら "1h" が目安