0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

GASでAI返信レビューのWIP上限を超えたら下書き生成を止める

0
Posted at

AIで問い合わせ返信の下書きを増やしても、人の確認速度を超えればレビュー待ちが積み上がります。そこで、Google SheetsとGoogle Apps Script(GAS)でレビュー中の件数に上限を設け、上限到達時は新しい下書きを作らず受付待ちへ戻します。

この記事では次の状態を作ります。

  • review_ready と reviewing をWIP(仕掛かり中)として数える
  • 上限未満の時だけAI下書き処理を呼ぶ
  • 上限到達時も問い合わせを捨てず waiting へ残す
  • 同時実行でも上限を超えないよう LockService で排他制御する
  • 緊急、苦情、契約、個人情報を含む案件は別の人間確認ルートへ戻す

この記事で作るもの

問い合わせ受付
  ├─ 停止条件に該当 → 人へ直接エスカレーション
  └─ 通常案件
       ├─ WIP上限以上 → waitingへ保持
       └─ WIP上限未満 → AI下書き → review_ready → 人が確認

問い合わせ受付から人間確認までのレビューゲート

AIは返信を送信しません。下書き生成と人間確認を分離し、価格、契約、期限、返金、苦情などの確定は人が行います。

シート構成

review_queue シートの1行を1件の問い合わせにします。

case_id,received_at,priority,status,reviewer,review_due_at,risk_level,decision_reason

status は次の値に限定します。

  • waiting: 受付済み、まだ下書きを作っていない
  • review_ready: AI下書き済み、人の確認待ち
  • reviewing: 人が確認中
  • done: 承認・返信などの処理が完了
  • stopped: 対象外または停止判断

WIPに含めるのは review_ready と reviewing です。受付前と判断完了後を含めないことで、人が現在抱えている確認負荷を測れます。

氏名、メールアドレス、電話番号、契約内容などが下書きに不要なら、AI処理の前に除外します。シート自体にも閲覧権限、保存期間、削除責任者を設定してください。

WIP上限をScript Propertiesへ置く

Apps Scriptの「プロジェクトの設定」から、スクリプト プロパティを追加します。

REVIEW_WIP_LIMIT=5

上限は「多く処理できそうな件数」ではなく、担当者が営業時間内に安全に確認できる件数から始めます。最初は小さく設定し、待ち時間、差し戻し率、期限超過を1〜2週間測って調整します。

現在のWIPを数える

const REVIEW_SHEET = "review_queue";
const STATUS_COLUMN = 4;
const WIP_STATUSES = new Set(["review_ready", "reviewing"]);

function getWipLimit() {
  const raw = PropertiesService
    .getScriptProperties()
    .getProperty("REVIEW_WIP_LIMIT");
  const limit = Number(raw);

  if (!Number.isInteger(limit) || limit < 1) {
    throw new Error("REVIEW_WIP_LIMITを1以上の整数で設定してください");
  }
  return limit;
}

function getReviewCapacity() {
  const sheet = SpreadsheetApp
    .getActive()
    .getSheetByName(REVIEW_SHEET);

  if (!sheet) {
    throw new Error("review_queueシートがありません");
  }

  const lastRow = sheet.getLastRow();
  const statuses = lastRow < 2
    ? []
    : sheet
        .getRange(2, STATUS_COLUMN, lastRow - 1, 1)
        .getDisplayValues()
        .flat();

  const current = statuses.filter(
    status => WIP_STATUSES.has(status)
  ).length;
  const limit = getWipLimit();

  return {
    current,
    limit,
    available: current < limit,
  };
}

空のシートでも0件を返し、設定値が欠けている時は安全側でエラーにします。

判定と追加を排他制御する

複数のフォーム送信が同時に動くと、どちらも「上限未満」と判断して上限を超える可能性があります。判定から行追加までを同じロック内で処理します。

function enqueueInquiry(input) {
  const lock = LockService.getScriptLock();

  if (!lock.tryLock(5000)) {
    saveAsWaiting(input, "queue_lock_timeout");
    return { accepted: false, reason: "queue_lock_timeout" };
  }

  try {
    const stopReason = detectStopReason(input);
    if (stopReason) {
      escalateToHuman(input, stopReason);
      return { accepted: false, reason: stopReason };
    }

    const capacity = getReviewCapacity();
    if (!capacity.available) {
      saveAsWaiting(input, "review_capacity_reached");
      return {
        accepted: false,
        reason: "review_capacity_reached",
        current: capacity.current,
        limit: capacity.limit,
      };
    }

    const safeInput = redactForDraft(input);
    const draft = createDraftWithApprovedProvider(safeInput);
    saveForReview(input, draft, "review_ready");

    return { accepted: true };
  } finally {
    lock.releaseLock();
  }
}

createDraftWithApprovedProvider は利用中のAIサービスへ置き換えます。APIキーをコードやシートへ直書きせず、利用サービスの安全な秘密情報管理を使います。

実運用では、外部AI呼び出し中ずっとロックを保持すると待ち時間が増えます。より堅牢にする場合は、ロック内で枠を reserved として予約し、ロック解除後に生成し、成功時に review_ready、失敗時に waiting へ戻します。

停止条件を先に判定する

WIPに空きがあっても、次の案件を通常のAI下書き対象にしません。

function detectStopReason(input) {
  if (input.riskLevel === "stop") return "risk_stop";
  if (input.category === "complaint") return "complaint";
  if (input.category === "contract") return "contract";
  if (input.category === "refund") return "refund";
  if (input.containsSensitiveData) return "sensitive_data";
  if (!input.summary) return "insufficient_input";
  return null;
}

これは完全な安全判定ではありません。キーワードや入力項目で保守的に候補を分け、最終判断は人が行います。法務、医療、税務など専門判断を求める内容も通常ルートから外します。

上限到達時は捨てずに残す

function saveAsWaiting(input, reason) {
  const sheet = SpreadsheetApp
    .getActive()
    .getSheetByName(REVIEW_SHEET);

  sheet.appendRow([
    input.caseId,
    new Date(),
    input.priority || "normal",
    "waiting",
    "",
    input.reviewDueAt || "",
    input.riskLevel || "normal",
    reason,
  ]);
}

review_capacity_reached と queue_lock_timeout を分けておくと、負荷超過と技術的な競合を別々に改善できます。再処理用の時刻トリガーは、古い問い合わせと期限の近い問い合わせを優先し、再度WIP判定を通します。

動作確認

本番データを使う前に、架空の問い合わせで確認します。

  1. REVIEW_WIP_LIMIT=2 にする
  2. review_ready を1件入れ、通常案件を追加すると下書き対象になることを確認する
  3. review_ready と reviewing を合計2件にし、追加案件が waiting になることを確認する
  4. 苦情または契約カテゴリが、空き件数に関係なく人へ戻ることを確認する
  5. AI呼び出し失敗時に、案件が消えず再処理可能な状態へ戻ることを確認する
  6. 同時実行を模擬し、上限を超えて review_ready が増えないことを確認する

導入チェックリスト

  • WIPに含める状態を文書化した
  • waiting、review_ready、reviewing、完了状態を分けた
  • WIP上限をScript Propertiesで管理した
  • 設定不足時は下書きを作らずエラーにした
  • 判定と枠確保を LockService で排他制御した
  • 上限到達時も問い合わせを失わず保持した
  • 緊急、苦情、契約、返金、機密情報を人へ戻した
  • AIへ渡さない情報を定義した
  • AI下書きから顧客への自動送信を分離した
  • 上限値、停止理由、変更日を判断ログへ残した

毎週見る指標

  • 受付からレビュー開始までの時間
  • レビュー所要時間
  • 差し戻し率
  • 停止件数と理由
  • 期限超過件数
  • 担当者別の仕掛かり件数

期限超過が増えた時は、すぐ上限を上げず、対象カテゴリを狭める、参照FAQを直す、受付項目を改善する、担当体制を見直す、の順に確認します。

まず直近5営業日の review_ready と reviewing を数え、人が安全に確認できる上限を1つ決めてください。Miraigentの無料診断でも、AIツールの選定より先に「誰が何件まで確認し、どの条件で人へ戻すか」を整理しています。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?