03｜接入 Gemini

/** 愛智理- AI 助理免費安裝服務：LINE × Gemini 十步教學 */
function cfg_(name) {
  return PropertiesService.getScriptProperties().getProperty(name);
}

/** 秘密只留在自己的指令碼屬性，不寫進程式碼或執行紀錄。 */
function importSetup_() {
  var props = PropertiesService.getScriptProperties();
  var raw = props.getProperty('SETUP_INPUT');
  if (!raw) return;
  var data;
  try { data = JSON.parse(raw); } catch (_) { throw new Error('設定格式不完整：回第6步重新複製整份設定'); }
  if (!data || typeof data !== 'object' || Array.isArray(data)) throw new Error('設定格式錯誤');
  var required = ['LINE_CHANNEL_ID', 'LINE_CHANNEL_SECRET', 'GEMINI_API_KEY', 'KNOWLEDGE'];
  var allowed = required.concat(['PROMPT', 'GEMINI_MODEL']);
  if (Object.keys(data).some(function(k) { return allowed.indexOf(k) < 0; })) throw new Error('設定含未知欄位');
  required.forEach(function(k) {
    if (typeof data[k] !== 'string' || !data[k].trim()) throw new Error('缺少設定：' + k);
  });
  if (!/^\d+$/.test(data.LINE_CHANNEL_ID.trim())) throw new Error('Channel ID 應只有數字');
  var clean = {};
  allowed.forEach(function(k) {
    if (data[k] !== undefined && typeof data[k] !== 'string') throw new Error('設定型態錯誤：' + k);
    clean[k] = (data[k] || '').trim();
  });
  props.setProperties(clean, false);
  props.deleteProperty('SETUP_INPUT');
  console.log('設定已匯入；暫存設定已清除');
}

/** 只快取到到期前60秒。快取遺失時重發，不沿用失效憑證。 */
function lineToken_() {
  var id = cfg_('LINE_CHANNEL_ID');
  var secret = cfg_('LINE_CHANNEL_SECRET');
  if (!id || !secret) throw new Error('LINE 設定缺少 Channel ID 或 Channel secret');
  var digest = Utilities.computeDigest(Utilities.DigestAlgorithm.SHA_256, id + '\n' + secret);
  var key = 'fs_line_' + Utilities.base64EncodeWebSafe(digest);
  var cache = CacheService.getScriptCache();
  var token = cache.get(key);
  if (token) return token;
  var res;
  try {
    res = UrlFetchApp.fetch('https://api.line.me/oauth2/v3/token', {
      method: 'post', contentType: 'application/x-www-form-urlencoded',
      payload: { grant_type: 'client_credentials', client_id: id, client_secret: secret },
      muteHttpExceptions: true
    });
  } catch (_) { throw new Error('LINE 權杖連線失敗'); }
  if (res.getResponseCode() !== 200) throw new Error('LINE 權杖 HTTP ' + res.getResponseCode());
  var data;
  try { data = JSON.parse(res.getContentText()); } catch (_) { throw new Error('LINE 權杖回應格式錯誤'); }
  if (!data.access_token || typeof data.access_token !== 'string' || !isFinite(data.expires_in) || Number(data.expires_in) <= 60)
    throw new Error('LINE 權杖回應不完整');
  cache.put(key, data.access_token, Math.min(840, Math.floor(Number(data.expires_in) - 60)));
  return data.access_token;
}

function ok_() {
  return ContentService.createTextOutput(JSON.stringify({ ok: true })).setMimeType(ContentService.MimeType.JSON);
}

function doPost(e) {
  try {
    if (!e || !e.postData || !e.postData.contents) return ok_();
    var body;
    try { body = JSON.parse(e.postData.contents); } catch (_) { throw new Error('Webhook 內容格式錯誤'); }
    var events = body.events || [];
    if (!Array.isArray(events)) throw new Error('Webhook events 格式錯誤');
    events.forEach(function(ev) {
      if (ev.type !== 'message' || !ev.message || ev.message.type !== 'text' || !ev.replyToken) return;
      var answer;
      try { answer = askGemini_(ev.message.text); }
      catch (err) {
        console.error('Gemini 失敗：' + err.message);
        answer = '抱歉，我這邊暫時有點問題，請稍等一下由真人回覆你。';
      }
      replyToLine_(ev.replyToken, answer);
    });
  } catch (err) { console.error('doPost 失敗：' + err.message); }
  return ok_();
}

function askGemini_(userText) {
  var key = cfg_('GEMINI_API_KEY');
  if (!key) throw new Error('Gemini 設定缺少 API Key');
  var model = cfg_('GEMINI_MODEL') || 'gemini-3.5-flash-lite';
  var persona = cfg_('PROMPT') || '你是這家店的客服助理。用繁體中文，簡短、有禮貌地回答。';
  var facts = cfg_('KNOWLEDGE') || '';
  var systemText = '【你可以依據的資料】\n' + (facts || '（目前沒有提供資料）') +
    '\n\n【預設風格；下面你的身分可以修改風格】\n回答控制在三句話以內。\n' +
    '\n【你的身分與說話方式】\n' + persona +
    '\n\n【安全底線；請最優先遵守】\n' +
    '1. 只根據上面的資料回答；資料裡沒有的，就說你不知道。\n' +
    '2. 遇到價格變動、退款、客訴，或你不確定的事，回答「這部分我幫你轉給真人確認」。\n' +
    '3. 不要承諾我們做不到的事。';
  var res;
  try {
    res = UrlFetchApp.fetch('https://generativelanguage.googleapis.com/v1beta/models/' + encodeURIComponent(model) + ':generateContent', {
      method: 'post', contentType: 'application/json', headers: { 'x-goog-api-key': key },
      payload: JSON.stringify({systemInstruction: {parts: [{text: systemText}]},
        contents: [{role: 'user', parts: [{text: userText}]}], generationConfig: {maxOutputTokens: 1024}}),
      muteHttpExceptions: true
    });
  } catch (_) { throw new Error('Gemini 連線失敗'); }
  if (res.getResponseCode() !== 200) throw new Error('Gemini HTTP ' + res.getResponseCode());
  var data;
  try { data = JSON.parse(res.getContentText()); } catch (_) { throw new Error('Gemini 回應格式錯誤'); }
  var parts = data.candidates && data.candidates[0] && data.candidates[0].content && data.candidates[0].content.parts;
  var out = parts && parts.filter(function(p) { return p.text && !p.thought; }).map(function(p) { return p.text; }).join('');
  if (!out) throw new Error('Gemini 沒有文字回覆：請檢查模型與安全限制');
  return out;
}

function replyToLine_(replyToken, text) {
  var res;
  var token = lineToken_();
  try {
    res = UrlFetchApp.fetch('https://api.line.me/v2/bot/message/reply', {
      method: 'post', contentType: 'application/json', headers: {Authorization: 'Bearer ' + token},
      payload: JSON.stringify({replyToken: replyToken, messages: [{type: 'text', text: String(text).slice(0, 4900)}]}),
      muteHttpExceptions: true
    });
  } catch (_) { throw new Error('LINE 回覆連線失敗'); }
  if (res.getResponseCode() !== 200) throw new Error('LINE 回覆 HTTP ' + res.getResponseCode());
}

/** 先檢查設定，再驗證 LINE 與 Gemini；失敗即停，不印秘密或模型回覆。 */
function checkSetup() {
  importSetup_();
  ['LINE_CHANNEL_ID', 'LINE_CHANNEL_SECRET', 'GEMINI_API_KEY', 'KNOWLEDGE'].forEach(function(k) {
    if (!cfg_(k)) throw new Error('缺少設定：' + k + '，回第6步');
  });
  console.log('設定：完整');
  var token = lineToken_();
  var res;
  try {
    res = UrlFetchApp.fetch('https://api.line.me/v2/bot/info', {headers: {Authorization: 'Bearer ' + token}, muteHttpExceptions: true});
  } catch (_) { throw new Error('LINE 帳號檢查連線失敗'); }
  if (res.getResponseCode() !== 200) throw new Error('LINE 帳號檢查 HTTP ' + res.getResponseCode());
  console.log('LINE：連線成功');
  askGemini_('請問你們幾點開？');
  console.log('Gemini：連線成功');
  console.log('下一步：部署並用手機收第一個 AI 回覆；本檢查尚未驗證 Webhook 回程');
}

使用的模型供應商：Gemini
使用的執行環境：自己的 Google Apps Script
秘密保存位置：指令碼屬性
Webhook 開關狀態：
建立日期：
最後一次驗證日期：