GASで問い合わせ履歴から
AIでFAQを自動生成する方法

// APIキーはコードに直書きせず、スクリプトプロパティに保管する
// エディタ左の「プロジェクトの設定 > スクリプト プロパティ」で
// ANTHROPIC_API_KEY を登録しておく
function getApiKey() {
  const key = PropertiesService.getScriptProperties()
    .getProperty("ANTHROPIC_API_KEY");
  if (!key) throw new Error("APIキーが未設定です");
  return key;
}

// 「問い合わせログ」シートのB列（問い合わせ本文）を集める
// 前提: 1行目はヘッダー、B列に本文が入っている
function collectInquiries() {
  const sheet = SpreadsheetApp.getActive().getSheetByName("問い合わせログ");
  const values = sheet.getDataRange().getValues();
  const rows = values.slice(1); // ヘッダーを除く

  return rows
    .map(function (row) { return String(row[1]).trim(); })
    .filter(function (text) { return text.length > 0; });
}

// 問い合わせ一覧をまとめてAIに渡し、FAQ配列を受け取る
// items: 問い合わせ本文の配列（1バッチ分）
function generateFaqBatch(items) {
  // 1件ずつ番号を振って渡すと、AIが件数を数えやすい
  const list = items
    .map(function (t, i) { return (i + 1) + ". " + t; })
    .join("\n");

  const instruction =
    "あなたはカスタマーサポートのFAQ作成担当です。\n" +
    "次は、実際に届いた問い合わせの一覧です。\n" +
    "----\n" + list + "\n----\n" +
    "条件:\n" +
    "・意味が近い問い合わせは1つのFAQにまとめる。\n" +
    "・1つのFAQには、代表的な質問文をひとつだけ書く。\n" +
    "・question は検索されやすい自然な疑問文にする。\n" +
    "・answer は事実の断定を避け、下書きとして簡潔に書く。\n" +
    "・count は、そのFAQにまとめた問い合わせのおおよその件数。\n" +
    "・多く聞かれている順に並べる。\n" +
    "余計な説明は出力せず、JSON配列だけを返してください。\n" +
    '形式: [{"question": "質問文", "answer": "回答の下書き", "count": 件数}]';

  const payload = {
    model: "claude-sonnet-4-20250514",
    max_tokens: 2000,
    messages: [{ role: "user", content: instruction }],
  };

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

  if (res.getResponseCode() !== 200) {
    throw new Error("API error: " + res.getContentText());
  }

  const responseText = JSON.parse(res.getContentText()).content[0].text;
  return JSON.parse(extractJsonArray(responseText));
}

// レスポンスから [ ... ] の部分だけを取り出す（前後の余計な文字対策）
function extractJsonArray(text) {
  const start = text.indexOf("[");
  const end = text.lastIndexOf("]");
  return text.slice(start, end + 1);
}

// 全問い合わせを50件ずつに分けてAIに渡し、結果を統合する
const BATCH_SIZE = 50;

function buildFaqDrafts() {
  const inquiries = collectInquiries();
  let faqs = [];

  for (let i = 0; i < inquiries.length; i += BATCH_SIZE) {
    const batch = inquiries.slice(i, i + BATCH_SIZE);
    const result = callWithRetry(function () {
      return generateFaqBatch(batch);
    });
    faqs = faqs.concat(result);
    Utilities.sleep(1000); // 連続呼び出しの間隔をあける
  }
  return faqs;
}

// レート制限などで失敗したとき、少し待って再試行する
function callWithRetry(fn) {
  for (let attempt = 1; attempt <= 3; attempt++) {
    try {
      return fn();
    } catch (e) {
      if (attempt === 3) throw e;
      Utilities.sleep(2000 * attempt);
    }
  }
}

// FAQ下書きを「FAQ下書き」シートに書き出す
function writeFaqSheet(faqs) {
  const ss = SpreadsheetApp.getActive();
  let sheet = ss.getSheetByName("FAQ下書き");
  if (!sheet) sheet = ss.insertSheet("FAQ下書き");

  sheet.clearContents();
  sheet.getRange(1, 1, 1, 3).setValues([["質問", "回答（下書き）", "件数"]]);

  const rows = faqs.map(function (f) {
    return [f.question, f.answer, f.count || ""];
  });

  if (rows.length > 0) {
    sheet.getRange(2, 1, rows.length, 3).setValues(rows);
  }
}

// 実行のエントリーポイント
function runFaqGeneration() {
  const faqs = buildFaqDrafts();
  // 件数が多い順に並べ替えてから書き出す
  faqs.sort(function (a, b) { return (b.count || 0) - (a.count || 0); });
  writeFaqSheet(faqs);
}

// 毎週月曜の朝8時台にFAQを作り直すトリガーを作成する
function createWeeklyFaqTrigger() {
  ScriptApp.newTrigger("runFaqGeneration")
    .timeBased()
    .onWeekDay(ScriptApp.WeekDay.MONDAY)
    .atHour(8)
    .create();
}