GASでClaude APIのCitationsで
根拠付き回答を作る方法

// Citationsを有効にした最小リクエスト
function askWithCitations() {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");

  const manual = [
    "第1条 有給休暇は入社6か月後から付与される。",
    "第2条 有給休暇の申請は取得日の3営業日前までに行うこと。",
    "第3条 慶弔休暇は有給休暇とは別に付与される。",
  ].join("\n");

  const payload = {
    model: "claude-opus-4-8",
    max_tokens: 1000,
    messages: [
      {
        role: "user",
        content: [
          {
            type: "document",
            // プレーンテキストの文書はこの形で渡す
            source: { type: "text", media_type: "text/plain", data: manual },
            title: "就業規則（休暇）",
            // これが引用機能のスイッチ。1リクエスト内では全文書で揃える
            citations: { enabled: true },
          },
          { type: "text", 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, // エラーでも例外にせずコードで判定する
  });

  if (res.getResponseCode() !== 200) {
    Logger.log("失敗: " + res.getResponseCode() + " / " + res.getContentText());
    return;
  }

  Logger.log(res.getContentText());
}

// レスポンスの構造（抜粋・イメージ）
{
  "content": [
    {
      "type": "text",
      "text": "有給休暇は入社から6か月後に付与されます。",
      "citations": [
        {
          "type": "char_location",          // テキスト文書なら文字位置
          "cited_text": "第1条 有給休暇は入社6か月後から付与される。",
          "document_index": 0,               // 何番目のdocumentブロックか
          "document_title": "就業規則（休暇）",
          "start_char_index": 0,
          "end_char_index": 28
        }
      ]
    },
    {
      "type": "text",
      "text": "なお申請期限は別途定められています。"
      // 根拠のない文にはcitationsが付かない
    }
  ]
}

// レスポンスを解析し、本文と引用リストに分けて取り出す
function parseCitations(json) {
  const body = [];      // 回答本文
  const citations = []; // 引用の一覧

  json.content.forEach(function (block) {
    if (block.type !== "text") return;
    body.push(block.text);

    // citationsは根拠のあるブロックにだけ付く。無い場合は undefined
    (block.citations || []).forEach(function (c) {
      citations.push({
        text: block.text,
        source: c.document_title || "文書" + c.document_index,
        quote: c.cited_text,
        // 位置情報の形はtypeで変わるので分岐する
        where:
          c.type === "page_location"
            ? "p." + c.start_page_number + "-" + c.end_page_number
            : c.type === "char_location"
            ? c.start_char_index + "〜" + c.end_char_index + "文字目"
            : "",
      });
    });
  });

  return { answer: body.join(""), citations: citations };
}

// 質問シートを読み、根拠付きで回答してシートに書き戻す
function answerQuestionsWithSources() {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");
  const ss = SpreadsheetApp.getActive();
  const docs = loadDocuments(ss.getSheetByName("社内文書"));
  const sheet = ss.getSheetByName("質問");

  const last = sheet.getLastRow();
  if (last < 2) return;

  // A列:質問 / B列:回答 / C列:出典 の想定
  const rows = sheet.getRange(2, 1, last - 1, 3).getValues();

  rows.forEach(function (row, i) {
    const question = String(row[0] || "").trim();
    if (!question || row[1]) return; // 未入力・回答済みは飛ばす

    const json = callClaudeWithDocs(apiKey, docs, question);
    if (!json) return;

    const parsed = parseCitations(json);

    // 出典は「文書名: 引用文（位置）」の形で1セルにまとめる
    const sources = parsed.citations
      .map(function (c) {
        return c.source + ": 「" + c.quote + "」(" + c.where + ")";
      })
      .join("\n");

    sheet.getRange(i + 2, 2).setValue(parsed.answer);
    sheet.getRange(i + 2, 3).setValue(sources || "根拠なし（要確認）");

    Utilities.sleep(500); // 連続呼び出しを少し緩める
  });
}

// 社内文書シート（A列:タイトル / B列:本文）をdocumentブロックの配列にする
function loadDocuments(sheet) {
  const last = sheet.getLastRow();
  if (last < 2) return [];

  return sheet
    .getRange(2, 1, last - 1, 2)
    .getValues()
    .filter(function (r) {
      return String(r[1] || "").trim() !== "";
    })
    .map(function (r) {
      return {
        type: "document",
        source: { type: "text", media_type: "text/plain", data: String(r[1]) },
        title: String(r[0] || "無題"),
        citations: { enabled: true },
      };
    });
}

function callClaudeWithDocs(apiKey, docs, question) {
  const payload = {
    model: "claude-opus-4-8",
    max_tokens: 1500,
    system:
      "あなたは社内規程の案内担当です。渡された文書に書かれている内容だけで回答し、" +
      "書かれていない場合は「文書に記載がありません」と答えてください。",
    messages: [
      {
        role: "user",
        // documentブロックを先に、質問テキストを後ろに置く
        content: docs.concat([{ type: "text", text: question }]),
      },
    ],
  };

  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 code = res.getResponseCode();
  if (code !== 200) {
    Logger.log("APIエラー " + code + ": " + res.getContentText());
    return null;
  }
  return JSON.parse(res.getContentText());
}

// 複数文書を渡し、document_indexで出典を突き止める
function askAcrossDocuments(question) {
  const apiKey = PropertiesService.getScriptProperties().getProperty("ANTHROPIC_API_KEY");

  // 配列の並び順がそのまま document_index（0始まり）になる
  const docs = [
    { title: "就業規則", body: "有給休暇は入社6か月後から付与される。" },
    { title: "経費規程", body: "交通費の申請は月末締め、翌月5日までに提出する。" },
    { title: "情報セキュリティ規程", body: "社外PCへの業務データ保存は禁止する。" },
  ];

  const payload = {
    model: "claude-opus-4-8",
    max_tokens: 1200,
    messages: [
      {
        role: "user",
        content: docs
          .map(function (d) {
            return {
              type: "document",
              source: { type: "text", media_type: "text/plain", data: d.body },
              title: d.title,
              citations: { enabled: true },
            };
          })
          .concat([{ type: "text", text: question }]),
      },
    ],
  };

  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,
  });
  if (res.getResponseCode() !== 200) return;

  const json = JSON.parse(res.getContentText());

  // どの規程が使われたかを集計する
  const used = {};
  json.content.forEach(function (block) {
    (block.citations || []).forEach(function (c) {
      const name = docs[c.document_index] ? docs[c.document_index].title : "不明";
      used[name] = (used[name] || 0) + 1;
    });
  });

  Logger.log(used); // 例: { 経費規程: 2 }
}

// 引用が付かない回答を検知して、人のチェックに回す
function needsHumanReview(json) {
  let hasText = false;
  let hasCitation = false;

  json.content.forEach(function (block) {
    if (block.type !== "text") return;
    if (block.text.trim()) hasText = true;
    if (block.citations && block.citations.length > 0) hasCitation = true;
  });

  // 文章はあるのに根拠がゼロ = 文書に無い内容を答えた可能性がある
  return hasText && !hasCitation;
}

function notifyIfUnsupported(json, question) {
  if (!needsHumanReview(json)) return;

  MailApp.sendEmail({
    to: "review@example.com",
    subject: "[要確認] 根拠なしのAI回答が発生しました",
    body: "質問: " + question + "\n\n社内文書に根拠が見つからない回答です。内容を確認してください。",
  });
}