GASでClaude APIの構造化出力で
壊れないJSONを受け取る方法

const ENDPOINT = "https://api.anthropic.com/v1/messages";

function askStructured() {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");

  const payload = {
    model: "claude-opus-4-8",
    max_tokens: 1024,
    // 出力を必ずこのJSON構造に従わせる
    output_config: {
      format: {
        type: "json_schema",
        schema: {
          type: "object",
          properties: {
            category: { type: "string", enum: ["見積依頼", "クレーム", "その他"] },
            urgency: { type: "integer" },
          },
          required: ["category", "urgency"],
          additionalProperties: false,
        },
      },
    },
    messages: [
      { role: "user", content: "次の問い合わせを分類して: 納期に間に合わないので至急連絡ください" },
    ],
  };

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

  const body = JSON.parse(res.getContentText());
  // content[0].text は必ずスキーマ通りのJSON文字列になる
  const data = JSON.parse(body.content[0].text);
  Logger.log(data.category); // 例: クレーム
  Logger.log(data.urgency);  // 例: 90
}

function parseStructured(res) {
  const body = JSON.parse(res.getContentText());

  // 1. APIエラー(401/400など)は content が無い
  if (body.type === "error") {
    throw new Error("APIエラー: " + body.error.message);
  }
  // 2. 出力が途中で切れると JSON が壊れる
  if (body.stop_reason === "max_tokens") {
    throw new Error("max_tokensに達しました。値を大きくしてください");
  }
  // 3. 安全上の拒否では構造が保証されない
  if (body.stop_reason === "refusal") {
    throw new Error("モデルが応答を拒否しました");
  }

  return JSON.parse(body.content[0].text); // ここは失敗しない前提で書ける
}

// スプレッドシートの問い合わせを崩れず一括分類する
function classifyInquiries() {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");
  const sheet = SpreadsheetApp.getActive().getSheetByName("問い合わせ");
  const lastRow = sheet.getLastRow();
  if (lastRow < 2) return;

  // A列:本文 / B列:分類 / C列:理由
  const rows = sheet.getRange(2, 1, lastRow - 1, 3).getValues();

  const schema = {
    type: "object",
    properties: {
      category: { type: "string", enum: ["見積依頼", "サポート", "クレーム", "営業", "その他"] },
      reason: { type: "string" },
    },
    required: ["category", "reason"],
    additionalProperties: false,
  };

  rows.forEach((row, i) => {
    const text = row[0];
    if (!text || row[1]) return; // 空行・分類済みはスキップ

    const result = classifyOne(apiKey, schema, text);
    sheet.getRange(i + 2, 2).setValue(result.category);
    sheet.getRange(i + 2, 3).setValue(result.reason);
    Utilities.sleep(300); // レート制限対策に少し待つ
  });
}

function classifyOne(apiKey, schema, text) {
  const payload = {
    model: "claude-opus-4-8",
    max_tokens: 512,
    output_config: { format: { type: "json_schema", schema: schema } },
    messages: [{ role: "user", content: "次の問い合わせを分類してください:\n" + 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(payload),
    muteHttpExceptions: true,
  });
  return parseStructured(res); // 前セクションのガード関数を再利用
}

// 1回の呼び出しで複数の明細を配列として受け取る
const schema = {
  type: "object",
  properties: {
    items: {
      type: "array",
      items: {
        type: "object",
        properties: {
          name: { type: "string" },
          price: { type: "integer" },
          taxable: { type: "boolean" },
        },
        required: ["name", "price", "taxable"],
        additionalProperties: false,
      },
    },
    total: { type: "integer" },
  },
  required: ["items", "total"],
  additionalProperties: false,
};

// 受け取り側は配列としてそのまま扱える
// const data = parseStructured(res);
// data.items.forEach(item => Logger.log(item.name + " / " + item.price));