校園資訊組 LINE Bot AI 智慧小幫手

用 Google 試算表當資料庫，結合 Gemini API 與 Google Apps Script，打造能回答校園網路、帳號、研習、平板與設備問題的 24 小時 AI 助手。

適用於中小型國小、國中、高中職的資訊組長、資訊行政人員與校務數位推動教師。
因為沒有採用付費方案，大型學校使用時，免費額度可能無法支應。

更新日期：2026 年 8 月 28 日

文章較長，閱讀前請先準備一杯茶，算是我的實作筆記。

「Wi-Fi 帳號、密碼是什麼？」「公務帳號是多少？為什麼登不進去？」「印表機要如何安裝？」
每天的固定行程真的很耗時，老師們也常常需要排隊等候。

剛好在 Facebook 上看到一位強者分享學校使用的開源 LINE Bot，便試著玩玩看，希望能減輕行政負擔，也減少老師們等待回覆的時間。

核心概念：
Google 試算表負責儲存學校資料，Google Apps Script 負責串接服務， Gemini 負責整理答案，LINE 負責讓老師用熟悉的聊天室提問。

一、完成後，會得到什麼？

📚 學校專屬知識庫 將校內 Wi-Fi、帳號、設備、研習與行政流程整理在 Google 試算表中。

🤖 LINE AI 小幫手 教師可以直接在 LINE 詢問，Bot 會依據學校資料回覆。

🛠️ 知識庫管理後台 管理者可登入網頁新增、修改、刪除知識庫內容。

二、整體運作流程

老師在 LINE 提問 → LINE Webhook → Google Apps Script → Google 試算表知識庫 → Gemini → LINE 回覆

三、開始前請先準備

可以登入 Google AI Studio 的 Google 帳號。

可以建立 Google 試算表與 Apps Script 的 Google 帳號。

一個 LINE 官方帳號，並能進入 LINE Official Account Manager。

一個可以測試 Bot 的 LINE 個人帳號。

講師或文章提供的完整 Code.gs 與 index.html 程式碼。

資安提醒：
LINE Channel access token、Gemini API Key、管理者密碼都屬於機密資料。請不要貼到公開文章、公開簡報、GitHub、群組或社群貼文中。本文中的設定值都請替換成您自己的資料。

建立 LINE 官方帳號並啟用 Messaging API

約 5～10 分鐘完成

我已完成

流程提醒：
現在請先建立 LINE 官方帳號，再從官方帳號管理後台啟用 Messaging API。

不再是直接到 LINE Developers Console 建立 Messaging API Channel。

進入 LINE Official Account Manager，使用您的 LINE 帳號或 Business ID 登入。
https://tw.linebiz.com/login/
建立新的 LINE 官方帳號。建議名稱可以是：校園資訊組 AI 小幫手
填寫官方帳號基本資料，例如：
- 帳號名稱：校園資訊組 AI 小幫手
- 帳號簡介：協助全校同仁查詢校園網路、帳號、研習、設備與平板借用資訊
- 組織名稱：學校名稱或資訊組名稱
建立完成後，進入官方帳號管理後台：
設定 → Messaging API → 啟用 Messaging API
如果畫面要求選擇 Provider，請選擇學校資訊組預計長期管理的 Provider。
啟用完成後，進入 LINE Developers Console，選擇剛才使用的 Provider，再選擇 Messaging API Channel。

Provider 選擇請特別小心：
LINE 官方帳號指定 Provider 後，未來不能任意更換或取消指定。如果是學校長期使用，建議使用學校資訊組或學校專用的 Provider，不要隨意放在個人或外部服務商的 Provider 底下。

我已建立 LINE 官方帳號。

我已從官方帳號管理後台啟用 Messaging API。

我已在 LINE Developers Console 找到正確的 Channel。

取得 LINE Channel access token

約 2～5 分鐘完成

我已完成

在 LINE Developers Console 中進入：
https://developers.line.biz/en/
Provider → Messaging API Channel → Messaging API
找到： Channel access token
依畫面選擇產生 Token 的方式。如果使用具有期限的 Token，請注意未來需要在到期前更新。
複製產生的長串英文與數字，稍後填入 Apps Script。

LINE_ACCESS_TOKEN: '請貼上您自己的 LINE Channel access token'

絕對不要把 Token 放在：

公開網頁的前端 JavaScript。
Google Blog 或公開簡報。
GitHub 或其他公開程式碼平台。
LINE 回覆訊息或網址參數中。

我已取得 LINE Channel access token。

我已將 Token 暫存在安全位置，沒有公開分享。

取得 Gemini API Key

約 3～5 分鐘完成

我已完成

進入 Google AI Studio，使用 Google 帳號登入。
開啟 API Key 管理頁面，選擇： Create API key
如果系統要求選擇 Google Cloud Project，請選擇您要使用的專案。
複製產生的 Gemini API Key。常見的舊格式可能以 AIzaSy 開頭，但請以目前 Google AI Studio 顯示的格式為準。

配額與計費提醒：
Gemini API 的可用模型、速率限制、免費配額與是否需要計費設定，會依 Google 帳號、專案與當時政策而不同。請以 Google AI Studio 與 Google Cloud 專案頁面顯示的資訊為準，不要把「一定免費」或「不限額度」寫入正式教學。

建議保留多模型備援

為避免單一模型暫時忙碌、配額限制或模型下架，可以在 CONFIG 中保留多個模型。程式會依序嘗試，前一個失敗就換下一個。

GEMINI_MODELS: [
  'gemini-3.7-flash',
  'gemini-3.6-flash',
  'gemini-3.5-flash',
  'gemini-3.1-flash-lite',
  'gemini-2.5-flash',
  'gemini-2.5-flash-lite'
]

實際可使用的模型請以 Google Gemini API 官方 Models 頁面或 Models API 回傳結果為準。 Preview 或已停止服務的模型，不建議放在正式環境的主要順位。

我已建立 Gemini API Key。

我已確認 API Key 沒有公開外流。

我已在程式中保留多模型備援設定。

建立 Google 試算表知識庫

約 2 分鐘完成

我已完成

開啟 Google 試算表，建立新的空白試算表。
建議將試算表命名為：校園資訊組智慧小幫手知識庫
下方預設的「工作表1」可以先保留。程式第一次執行初始化函式時，會自動建立知識庫工作表。
複製試算表網址中的純 ID。試算表網址通常長這樣：

https://docs.google.com/spreadsheets/d/這一段就是試算表ID/edit

設定時建議填入純 ID：

SPREADSHEET_ID: '請貼上試算表ID'

不要包含：

/edit
?gid=123456789
#gid=123456789

程式會使用的工作表

工作表名稱	用途
資訊組AI小幫手知識庫	存放分類、標題、詳細內容、狀態與更新時間。
對話紀錄	記錄使用者問題、AI 回覆與必要的識別資訊。

初始化函式的重要提醒：
如果知識庫工作表已經有正式資料，請不要再次執行 initKnowledgeBaseSheet。某些初始化版本會清除同名工作表，再重新建立範例資料。

我已建立 Google 試算表。

我已複製正確的 Spreadsheet ID。

我已確認工作表名稱與程式設定完全相同。

建立 Apps Script，貼上 Code.gs 與 index.html

約 5～10 分鐘完成

我已完成

在剛才建立的 Google 試算表上方選單點選：
擴充功能 → Apps Script
進入 Apps Script 編輯器後，將原本預設的 myFunction 刪除。
建立或使用預設的： Code.gs
將下方收闔選單中的完整後端程式碼複製到 Code.gs。
在 CONFIG 中填入自己的設定。

CONFIG 基本設定範例

const CONFIG = {
  SPREADSHEET_ID: '請貼上Google試算表ID',
  GEMINI_API_KEY: '請貼上Gemini API Key',
  LINE_ACCESS_TOKEN: '請貼上LINE Channel access token',
  ADMIN_PASSWORD: '請設定管理者密碼',
  GEMINI_MODELS: [
    'gemini-3.7-flash',
    'gemini-3.6-flash',
    'gemini-3.5-flash',
    'gemini-3.1-flash-lite',
    'gemini-2.5-flash',
    'gemini-2.5-flash-lite'
  ],
  SHEET_NAME: '資訊組AI小幫手知識庫',
  LOG_SHEET_NAME: '對話紀錄'
};

上方只是設定範例。請依照實際使用的完整程式碼與服務設定進行修改。

📄 展開／收起 Code.gs 後端程式碼

請展開後查看完整 Code.gs，按下「一鍵複製」即可複製全部內容。

          
          /**
 * 校園資訊組長 AI 智慧小幫手
 * LINE Bot + Google Apps Script + Gemini RAG
 *
 * 主要功能：
 * 1. LINE Webhook 接收訊息
 * 2. Gemini 多模型自動備援
 * 3. Google 試算表知識庫
 * 4. LINE 管理指令：#查詢、#記住
 * 5. 瀏覽器管理後台：密碼驗證後查看、新增、修改、刪除
 * 6. 對話紀錄
 */

// ==========================================================
// 一、基本設定
// ==========================================================
/**
 * 校園資訊組長 AI 智慧小幫手 (LINE Bot + Google Apps Script + Gemini RAG 後端)
 * 適用對象：中小學資訊組長、資訊行政團隊、全校教職員
 */
const CONFIG = {
  // Google 試算表 ID
  SPREADSHEET_ID: '這裡填入你的試算表 ID',

  // Gemini API Key
  GEMINI_API_KEY: '這裡填入你的API Key',

  // LINE Developers 的 Channel access token
  LINE_ACCESS_TOKEN: '這裡填入你的Channel access token',

  /*
   * Gemini 多模型備援清單。
   *
   * 程式會從第一個模型開始嘗試；
   * 若模型不可用、暫時忙碌或配額限制，
   * 就自動改用下一個模型。
   */
  GEMINI_MODELS: [
    'gemini-3.1-flash-lite',
    'gemini-2.5-flash',
    'gemini-2.5-flash-lite'
  ],

  // 資訊組長專屬人設
  SYSTEM_INSTRUCTION: `你是一位專業、親切且有效率的「校園資訊組智慧小幫手」（學校資訊組長的 AI 分身）。
你的任務是協助學校的全體教職員工快速解答校園網路、帳號開通、數位研習、生生用平板、教學軟體授權、教室設備故障排除與校園資安等常見問題。

：
1. 一律使用繁體中文（台灣習慣用語，如：影片、軟體、預設、網路、帳號、研習）。
2. 條理分明、結論先行，涉及操作或排查步驟時請用 1. 2. 3. 清楚列出。
3. 嚴格依據提供的「校園資訊組知識庫」回答。
4. 不可以自行捏造知識庫沒有提供的校內規定、網址、密碼、電話或時程。
5. 若知識庫查無特定資訊，請回答：「小幫手目前沒有這項特定資料，建議您可以至找資訊組長，或撥打校內分機詢問喔！」
6. 提醒老師時保持溫暖、熱心且支持的語氣。
7. 輸出適合手機閱讀的文字，每一行盡量簡單
8. 不要使用 Markdown 語法
9. 可使用全形冒號「：」與換行，但不要使用過多特殊符號。`,

  // 管理後台密碼
  ADMIN_PASSWORD: '在這裡設定密碼',

  // 工作表名稱
  SHEET_NAME: '資訊組AI小幫手知識庫',
  LOG_SHEET_NAME: '對話紀錄',

  // 內容長度限制
  MAX_CONTEXT_CHARS: 50000,
  MAX_LINE_MESSAGE_CHARS: 4900
};

// ==========================================================
// 二、設定值與試算表工具
// ==========================================================

/**
 * 取得設定值。
 *
 * 優先順序：
 * 1. Script Properties
 * 2. CONFIG
 */
function getConfigValue_(key) {
  try {
    const valueFromProperties =
      PropertiesService.getScriptProperties().getProperty(key);

    if (valueFromProperties !== null &&
        valueFromProperties !== undefined &&
        String(valueFromProperties).trim() !== '') {
      return String(valueFromProperties).trim();
    }
  } catch (err) {
    console.warn('讀取 Script Properties 失敗：' + err);
  }

  const valueFromConfig = CONFIG[key];

  if (valueFromConfig === null ||
      valueFromConfig === undefined) {
    return '';
  }

  return String(valueFromConfig).trim();
}


/**
 * 將完整試算表網址轉換成純 Spreadsheet ID。
 *
 * 支援：
 * https://docs.google.com/spreadsheets/d/xxxxx/edit
 * xxxxx
 * xxxxx/edit?gid=...
 */
function extractSpreadsheetId_(value) {
  const raw = String(value || '').trim();

  if (!raw) {
    throw new Error('SPREADSHEET_ID 尚未設定');
  }

  /*
   * 標準 Google 試算表網址：
   * /spreadsheets/d/{ID}/edit
   */
  const urlMatch = raw.match(
    /\/spreadsheets\/d\/([a-zA-Z0-9_-]+)/
  );

  if (urlMatch && urlMatch[1]) {
    return urlMatch[1];
  }

  /*
   * 如果使用者貼的是：
   * ID/edit?gid=xxx#gid=xxx
   */
  const idMatch = raw.match(
    /^([a-zA-Z0-9_-]+)/
  );

  if (idMatch && idMatch[1]) {
    return idMatch[1];
  }

  throw new Error(
    '無法辨識試算表 ID。請貼上 Google 試算表網址或純 ID。'
  );
}


/**
 * 開啟指定的 Google 試算表。
 */
function getSpreadsheet_() {
  const rawValue = getConfigValue_('SPREADSHEET_ID');
  const spreadsheetId = extractSpreadsheetId_(rawValue);

  try {
    return SpreadsheetApp.openById(spreadsheetId);
  } catch (err) {
    throw new Error(
      '無法開啟 Google 試算表，請確認：\n' +
      '1. SPREADSHEET_ID 是否正確\n' +
      '2. Apps Script 執行帳號是否有試算表權限\n' +
      '3. 是否貼到其他檔案的 ID\n' +
      '原始錯誤：' + err.message
    );
  }
}


/**
 * 取得或建立知識庫工作表。
 */
function ensureKnowledgeBaseSheet_() {
  const ss = getSpreadsheet_();
  let sheet = ss.getSheetByName(CONFIG.SHEET_NAME);

  if (!sheet) {
    sheet = ss.insertSheet(CONFIG.SHEET_NAME);
    sheet.appendRow([
      '分類',
      '標題 / 業務項目',
      '詳細內容與設定步驟',
      '狀態',
      '更新時間'
    ]);

    sheet
      .getRange('A1:E1')
      .setBackground('#0f766e')
      .setFontColor('#ffffff')
      .setFontWeight('bold');
  }

  return sheet;
}


/**
 * 取得或建立對話紀錄工作表。
 *
 * 新欄位格式：
 * A：時間
 * B：提問者名稱
 * C：提問者 ID
 * D：提問內容
 * E：AI 回覆
 */
function ensureLogSheet_() {
  const ss =
    getSpreadsheet_();

  let sheet =
    ss.getSheetByName(CONFIG.LOG_SHEET_NAME);

  if (!sheet) {
    sheet =
      ss.insertSheet(CONFIG.LOG_SHEET_NAME);

    sheet.appendRow([
      '時間',
      '提問者名稱',
      '提問者 ID',
      '提問內容',
      'AI 回覆'
    ]);

    return sheet;
  }

  /*
   * 如果目前是舊格式：
   * A：時間
   * B：提問者 ID
   * C：提問內容
   * D：AI 回覆
   *
   * 就在 B 欄後面新增「提問者名稱」欄位。
   */
  const lastColumn =
    Math.max(sheet.getLastColumn(), 4);

  const headers =
    sheet
      .getRange(1, 1, 1, lastColumn)
      .getDisplayValues()[0];

  const secondHeader =
    String(headers[1] || '').trim();

  const isOldFormat =
    secondHeader === '提問者 ID' ||
    secondHeader === '提問者ID' ||
    secondHeader === '提問者';

  const isNewFormat =
    secondHeader === '提問者名稱';

  if (isOldFormat && !isNewFormat) {
    sheet.insertColumnAfter(2);
  }

  /*
   * 統一設定正確表頭。
   */
  sheet
    .getRange(1, 1, 1, 5)
    .setValues([[
      '時間',
      '提問者名稱',
      '提問者 ID',
      '提問內容',
      'AI 回覆'
    ]]);

  return sheet;
}


// ==========================================================
// 三、Web App 入口與 LINE Webhook
// ==========================================================

/**
 * 開啟瀏覽器時顯示 index.html。
 *
 * LINE Webhook 使用的是 POST，
 * 瀏覽器管理頁面使用的是 GET。
 */
function doGet(e) {
  return HtmlService
    .createHtmlOutputFromFile('index')
    .setTitle('校園資訊組 AI 智慧小幫手 - 知識庫管理')
    .addMetaTag('viewport', 'width=device-width, initial-scale=1');
}


/**
 * LINE Webhook 接收入口。
 *
 * LINE 會用 POST 將事件送到此函式。
 */
function doPost(e) {
  const result = {
    status: 'success',
    processed: 0
  };

  try {
    if (!e ||
        !e.postData ||
        !e.postData.contents) {
      return createJsonOutput_({
        status: 'no body'
      });
    }

    const data = JSON.parse(e.postData.contents);
    const events = data.events || [];

    if (events.length === 0) {
      return createJsonOutput_({
        status: 'no event'
      });
    }

    /*
     * 不只處理 events[0]，
     * 避免 LINE 一次送來多個事件時遺漏。
     */
    for (let i = 0; i < events.length; i++) {
      try {
        processLineEvent_(events[i]);
        result.processed++;
      } catch (eventError) {
        console.error(
          '處理 LINE 事件失敗：' + eventError.stack
        );

        /*
         * 若尚未成功回覆，嘗試傳送簡短錯誤訊息。
         */
        const replyToken = events[i] && events[i].replyToken;

        if (replyToken) {
          try {
            sendLineReply_(
              replyToken,
              '抱歉，小幫手目前暫時忙碌中，請稍後再試一次。'
            );
          } catch (replyError) {
            console.error(
              '錯誤訊息也無法回覆：' + replyError.stack
            );
          }
        }
      }
    }

    return createJsonOutput_(result);

  } catch (err) {
    console.error('doPost 失敗：' + err.stack);

    return createJsonOutput_({
      status: 'error'
    });
  }
}


/**
 * 處理單一 LINE 事件。
 */
function processLineEvent_(event) {
  if (!event) {
    return;
  }

  /*
   * 目前只處理文字訊息。
   */
  if (event.type !== 'message' ||
      !event.message ||
      event.message.type !== 'text') {
    return;
  }

  const replyToken = event.replyToken;
  const originalMessage = String(event.message.text || '').trim();

  if (!originalMessage) {
    return;
  }

  const source = event.source || {};
  const sourceType = source.type || '';

  const isGroup =
    sourceType === 'group' ||
    sourceType === 'room';

  /*
   * 群組內只有：
   * 1. 提到小幫手
   * 2. 以 # 開頭的管理指令
   * 才回覆。
   */
  if (isGroup &&
      !isBotMentioned_(event) &&
      !originalMessage.startsWith('#')) {
    return;
  }

  /*
   * 管理指令。
   */
  if (originalMessage.startsWith('#')) {
    const adminReply = handleAdminCommand_(originalMessage);
    sendLineReply_(replyToken, adminReply);
    return;
  }

  /*
   * 移除常見的稱呼文字。
   */
  const cleanQuery = originalMessage
    .replace(/(@小幫手|資訊小幫手|資訊組長|小幫手)/gi, '')
    .trim();

  if (!cleanQuery) {
    sendLineReply_(
      replyToken,
      '您好，請問需要查詢哪一項校園資訊呢？'
    );
    return;
  }

  const aiReply = generateAiResponse_(cleanQuery);

  sendLineReply_(replyToken, aiReply);

const userId =
  source.userId ||
  source.groupId ||
  source.roomId ||
  'unknown';

const displayName =
  getLineDisplayName_(source);

logConversation_(
  cleanQuery,
  aiReply,
  userId,
  displayName
);
}


/**
 * 判斷群組訊息是否提到小幫手。
 */
function isBotMentioned_(event) {
  const text = String(
    event &&
    event.message &&
    event.message.text || ''
  );

  if (/(@小幫手|資訊小幫手|資訊組長|小幫手)/i.test(text)) {
    return true;
  }

  /*
   * LINE 可能將 mention 放在 mention.mentionees。
   */
  if (event &&
      event.message &&
      event.message.mention &&
      event.message.mention.mentionees &&
      event.message.mention.mentionees.length > 0) {
    return true;
  }

  return false;
}


/**
 * 建立 JSON 回應。
 */
function createJsonOutput_(object) {
  return ContentService
    .createTextOutput(JSON.stringify(object))
    .setMimeType(ContentService.MimeType.JSON);
}


// ==========================================================
// 四、Gemini 多模型呼叫
// ==========================================================

/**
 * 產生 AI 回覆。
 */
/**
 * 產生 AI 回覆。
 *
 * 只使用狀態不是「停用」的知識庫資料。
 */
function generateAiResponse_(userQuery) {
  const query = String(userQuery || '').trim();

  if (!query) {
    return '您好，請問需要查詢哪一項校園資訊呢？';
  }

  /*
   * false 代表只讀取啟用中的資料。
   */
  const kbData = getKnowledgeBaseDataInternal_(false);

  /*
   * 將每筆知識庫資料真正組合成文字，
   * 送給 Gemini 參考。
   */
  let contextText = kbData
    .map(function(item) {
      return (
        '【分類】' + String(item.category || '') + '\n' +
        '【項目】' + String(item.title || '') + '\n' +
        '【內容】\n' + String(item.content || '')
      );
    })
    .join('\n\n------------------------------\n\n');

  if (!contextText) {
    contextText = '目前知識庫沒有可用資料。';
  }

  /*
   * 避免知識庫過長造成 API 請求過大。
   */
  const maxChars =
    Number(CONFIG.MAX_CONTEXT_CHARS || 50000);

  if (contextText.length > maxChars) {
    contextText =
      contextText.substring(0, maxChars) +
      '\n\n（知識庫內容較多，以上為部分資料）';
  }

  const prompt =
    '以下是「校園資訊組」的專屬業務知識庫：\n\n' +
    '========================================\n' +
    contextText +
    '\n========================================\n\n' +
    '老師或同仁的提問是：\n' +
    '「' + query + '」\n\n' +
    '請依照以下規則回答：\n' +
    '1. 優先從知識庫中找出與問題最相關的資料。\n' +
    '2. 即使使用者用詞與知識庫不同，也請判斷同義詞，例如 WiFi、Wi-Fi、無線網路、校園網路可能是同一類問題。\n' +
    '3. 如果知識庫有相關資料，請直接整理成清楚的繁體中文步驟。\n' +
    '4. 只有在知識庫完全沒有相關內容時，才回答：「小幫手目前沒有這項特定資料，建議您可以至資訊組找資訊組長，或撥打校內分機詢問喔！」\n' +
    '5. 不可以自行捏造知識庫沒有提供的校內規定、網址、密碼、電話或時程。';

  console.log(
    '知識庫資料筆數：' + kbData.length
  );

  console.log(
    '送給 Gemini 的知識庫字數：' + contextText.length
  );

  console.log(
    '使用者問題：' + query
  );

  return callGeminiWithFallback_(prompt, false);
}


/**
 * Gemini API 多模型備援。
 */
function callGeminiWithFallback_(prompt, expectJson) {
  const apiKey = getConfigValue_('GEMINI_API_KEY');

  if (!apiKey ||
      apiKey.indexOf('請填入') >= 0) {
    throw new Error('GEMINI_API_KEY 尚未設定');
  }

  /*
   * 確認 GEMINI_MODELS 確實是陣列。
   */
  const models = Array.isArray(CONFIG.GEMINI_MODELS)
    ? CONFIG.GEMINI_MODELS
    : [];

  if (models.length === 0) {
    throw new Error(
      'GEMINI_MODELS 沒有設定，請在 CONFIG 中加入模型陣列。'
    );
  }

  const errors = [];

  for (let i = 0; i < models.length; i++) {
    const model = String(models[i]).trim();

    if (!model) {
      continue;
    }

    try {
      const url =
        'https://generativelanguage.googleapis.com/v1beta/models/' +
        encodeURIComponent(model) +
        ':generateContent';

      const generationConfig = {
        maxOutputTokens: expectJson ? 300 : 1000
      };

      /*
       * 2.5 系列使用 temperature。
       * Gemini 3 系列先不送 temperature，
       * 增加不同模型之間的相容性。
       */
      if (model.indexOf('gemini-2.') === 0) {
        generationConfig.temperature = expectJson ? 0.1 : 0.2;
      }

      /*
       * 分類命名時要求 JSON。
       */
      if (expectJson) {
        generationConfig.responseMimeType = 'application/json';
      }

      const payload = {
        systemInstruction: {
          parts: [
            {
              text: CONFIG.SYSTEM_INSTRUCTION
            }
          ]
        },

        contents: [
          {
            role: 'user',
            parts: [
              {
                text: prompt
              }
            ]
          }
        ],

        generationConfig: generationConfig
      };

      const response = UrlFetchApp.fetch(url, {
        method: 'post',
        contentType: 'application/json',
        headers: {
          'x-goog-api-key': apiKey
        },
        payload: JSON.stringify(payload),
        muteHttpExceptions: true
      });

      const statusCode = response.getResponseCode();
      const bodyText = response.getContentText();

      console.log(
        'Gemini 模型：' + model +
        '\nHTTP 狀態：' + statusCode
      );

      if (statusCode >= 200 && statusCode < 300) {
        const responseJson = JSON.parse(bodyText);
        const text = extractGeminiText_(responseJson);

        if (text) {
          console.log('Gemini 成功使用模型：' + model);
          return text.trim();
        }

        errors.push(
          model + '：回應沒有文字內容'
        );
        continue;
      }

      /*
       * 401、403 通常代表 API Key 或權限問題。
       * 換模型也沒有用，因此直接停止。
       */
      if (statusCode === 401 || statusCode === 403) {
        throw new Error(
          'Gemini API Key 無效或沒有權限。\n' +
          '模型：' + model + '\n' +
          'HTTP：' + statusCode + '\n' +
          '內容：' + bodyText.substring(0, 1000)
        );
      }

      /*
       * 400、404、429 等錯誤，
       * 繼續嘗試下一個模型。
       */
      errors.push(
        model +
        '：HTTP ' +
        statusCode +
        '：' +
        bodyText.substring(0, 500)
      );

    } catch (err) {
      const errorMessage =
        model + '：' + err.message;

      errors.push(errorMessage);

      /*
       * API Key 權限錯誤，不再嘗試其他模型。
       */
      if (
        String(err.message).indexOf('HTTP：401') >= 0 ||
        String(err.message).indexOf('HTTP：403') >= 0 ||
        String(err.message).indexOf('無效或沒有權限') >= 0
      ) {
        throw err;
      }

      console.warn(
        'Gemini 模型 ' + model +
        ' 失敗，改用下一個模型。'
      );
    }
  }

  console.error(
    '所有 Gemini 模型皆失敗：\n' +
    errors.join('\n')
  );

  throw new Error(
    '所有 Gemini 模型皆無法使用，請查看執行紀錄中的詳細錯誤。'
  );
}


/**
 * 從 Gemini 回應中取出文字。
 */
function extractGeminiText_(json) {
  if (!json ||
      !json.candidates ||
      !json.candidates.length) {
    return '';
  }

  const candidate = json.candidates[0];

  if (!candidate.content ||
      !candidate.content.parts) {
    return '';
  }

  const texts = [];

  for (let i = 0; i < candidate.content.parts.length; i++) {
    const part = candidate.content.parts[i];

    if (part.text) {
      texts.push(String(part.text));
    }
  }

  return texts.join('\n').trim();
}


// ==========================================================
// 五、LINE 回覆
// ==========================================================

/**
 * 使用 LINE Reply API 回覆。
 */
function sendLineReply_(replyToken, messageText) {
  const accessToken = getConfigValue_('LINE_ACCESS_TOKEN');

  if (!accessToken ||
      accessToken.indexOf('請填入') >= 0) {
    throw new Error('LINE_ACCESS_TOKEN 尚未設定');
  }

  if (!replyToken) {
    throw new Error('LINE Webhook 沒有提供 replyToken');
  }

  let text = String(messageText || '').trim();

  if (!text) {
    text = '抱歉，目前沒有可回覆的內容。';
  }

  if (text.length > CONFIG.MAX_LINE_MESSAGE_CHARS) {
    text =
      text.substring(0, CONFIG.MAX_LINE_MESSAGE_CHARS) +
      '\n\n（內容較長，以上為摘要）';
  }

  const response = UrlFetchApp.fetch(
    'https://api.line.me/v2/bot/message/reply',
    {
      method: 'post',
      contentType: 'application/json',
      headers: {
        Authorization: 'Bearer ' + accessToken
      },
      payload: JSON.stringify({
        replyToken: replyToken,
        messages: [
          {
            type: 'text',
            text: text
          }
        ]
      }),
      muteHttpExceptions: true
    }
  );

  const statusCode = response.getResponseCode();
  const responseText = response.getContentText();

  console.log(
    'LINE Reply HTTP ' +
    statusCode +
    '：' +
    responseText
  );

  if (statusCode < 200 || statusCode >= 300) {
    throw new Error(
      'LINE 回覆失敗，HTTP ' +
      statusCode +
      '：' +
      responseText
    );
  }
}


// ==========================================================
// 六、Google 試算表知識庫
// ==========================================================

/**
 * 讀取知識庫。
 *
 * includeInactive = true：
 * 管理後台使用，包含停用資料。
 *
 * includeInactive = false：
 * LINE AI 使用，只讀取啟用資料。
 */
/**
 * 讀取知識庫資料。
 *
 * 使用 getDisplayValues()，
 * 避免日期物件造成 HTML Service 傳遞失敗。
 */
function getKnowledgeBaseDataInternal_(includeInactive) {
  const sheet = ensureKnowledgeBaseSheet_();
  const lastRow = sheet.getLastRow();

  if (lastRow <= 1) {
    return [];
  }

  /*
   * A:E：
   * A 分類
   * B 標題
   * C 詳細內容
   * D 狀態
   * E 更新時間
   *
   * 使用 getDisplayValues() 會全部轉成文字，
   * 比 getValues() 更適合傳給 index.html。
   */
  const values = sheet
    .getRange(2, 1, lastRow - 1, 5)
    .getDisplayValues();

  const list = [];

  for (let i = 0; i < values.length; i++) {
    const row = values[i];

    const category = String(row[0] || '').trim();
    const title = String(row[1] || '').trim();
    const content = String(row[2] || '').trim();
    const status = String(row[3] || '啟用').trim();
    const updatedAt = String(row[4] || '').trim();

    /*
     * 空白列不列入知識庫。
     */
    if (!category && !title && !content) {
      continue;
    }

    /*
     * AI 使用時排除停用資料。
     * 管理後台使用時可包含停用資料。
     */
    if (!includeInactive && status === '停用') {
      continue;
    }

    list.push({
      id: i + 2,
      rowNumber: i + 2,
      category: category,
      title: title,
      content: content,
      status: status || '啟用',
      updatedAt: updatedAt
    });
  }

  console.log(
    'getKnowledgeBaseDataInternal_ 回傳資料筆數：' +
    list.length
  );

  return list;
}



/**
 * 提供 index.html 使用。
 *
 * 必須通過管理密碼才能讀取後台資料。
 */
function getKnowledgeBaseData(password) {
  requireAdminPassword_(password);

  const data = getKnowledgeBaseDataInternal_(true);

  console.log(
    '管理後台取得知識庫筆數：' + data.length
  );

  return data;
}


/**
 * 管理員密碼驗證。
 */
function verifyAdminPassword(password) {
  try {
    requireAdminPassword_(password);
    return {
      ok: true,
      message: '驗證成功'
    };
  } catch (err) {
    return {
      ok: false,
      message: '密碼錯誤或尚未設定管理密碼'
    };
  }
}


/**
 * 伺服器端驗證管理密碼。
 */
function requireAdminPassword_(password) {
  const expected = getConfigValue_('ADMIN_PASSWORD');

  if (!expected ||
      expected.indexOf('請設定') >= 0) {
    throw new Error(
      'ADMIN_PASSWORD 尚未設定，管理功能已停用。'
    );
  }

  if (!password ||
      String(password) !== expected) {
    throw new Error('管理密碼錯誤');
  }

  return true;
}


/**
 * LINE 管理指令。
 *
 * 格式：
 * #查詢 管理密碼 關鍵字
 * #記住 管理密碼 要記住的內容
 */
function handleAdminCommand_(text) {
  const parts = String(text || '')
    .trim()
    .split(/\s+/);

  const command = parts.shift();

  if (command !== '#查詢' &&
      command !== '#記住') {
    return (
      '💡 管理指令格式：\n' +
      '• #查詢 管理密碼 關鍵字\n' +
      '• #記住 管理密碼 要記住的內容'
    );
  }

  const password = parts.shift() || '';

  try {
    requireAdminPassword_(password);
  } catch (err) {
    return '❌ 管理密碼錯誤，無法執行此指令。';
  }

  if (command === '#查詢') {
    const keyword = parts.join(' ').trim();

    if (!keyword) {
      return '❌ 請輸入查詢關鍵字。';
    }

    const list = getKnowledgeBaseDataInternal_(true)
      .filter(function(item) {
        return (
          item.category.indexOf(keyword) >= 0 ||
          item.title.indexOf(keyword) >= 0 ||
          item.content.indexOf(keyword) >= 0
        );
      });

    if (list.length === 0) {
      return '🔍 查無包含「' + keyword + '」的資料。';
    }

    const result = list
      .slice(0, 20)
      .map(function(item) {
        return (
          '• [' +
          item.category +
          '] ' +
          item.title +
          '\n' +
          item.content.substring(0, 100)
        );
      })
      .join('\n\n');

    return (
      '🔍 找到 ' +
      list.length +
      ' 筆資料：\n\n' +
      result
    );
  }

  if (command === '#記住') {
    const content = parts.join(' ').trim();

    if (!content) {
      return (
        '❌ 請提供要記住的內容。\n' +
        '例如：#記住 管理密碼 電腦教室2投影機燈泡已更換'
      );
    }

    const extracted = extractCategoryAndTitle_(content);
    const sheet = ensureKnowledgeBaseSheet_();

    sheet.appendRow([
      extracted.category,
      extracted.title,
      content,
      '啟用',
      new Date()
    ]);

    return (
      '✅ 已成功寫入校園資訊知識庫！\n' +
      '' + extracted.category + '\n' +
      '' + extracted.title + '\n' +
      '' + content
    );
  }

  return '❌ 無法辨識管理指令。';
}


/**
 * 使用 Gemini 將文字分類與命名。
 */
function extractCategoryAndTitle_(text) {
  const categories = [
    '校園網路與帳號',
    '數位教學與軟體',
    '數位研習管考',
    '校務系統與行政',
    '平板與設備借用',
    '校園資安與個資',
    '教室設備排障',
    '設備報修與耗材',
    '一般資訊業務'
  ];

  const prompt =
    '請將以下學校資訊業務文字整理成 JSON。\n' +
    '文字：' + text + '\n\n' +
    '可用分類：' + categories.join('、') + '\n\n' +
    '只能輸出：' +
    '{"category":"分類名稱","title":"簡短標題"}';

  try {
    const responseText =
      callGeminiWithFallback_(prompt, true);

    const jsonText = extractJsonObject_(responseText);
    const parsed = JSON.parse(jsonText);

    let category = String(parsed.category || '').trim();
    let title = String(parsed.title || '').trim();

    category = normalizeCategory_(category, categories);

    if (!title) {
      title = text.substring(0, 30);
    }

    return {
      category: category,
      title: title.substring(0, 100)
    };

  } catch (err) {
    console.error(
      '分類與命名失敗：' + err.stack
    );

    return {
      category: '一般資訊業務',
      title: text.substring(0, 30)
    };
  }
}


/**
 * 從模型回覆中擷取 JSON。
 */
function extractJsonObject_(text) {
  const raw = String(text || '').trim();

  const fencedMatch = raw.match(
    /```(?:json)?\s*([\s\S]*?)\s*```/i
  );

  const candidate = fencedMatch
    ? fencedMatch[1].trim()
    : raw;

  const start = candidate.indexOf('{');
  const end = candidate.lastIndexOf('}');

  if (start < 0 || end <= start) {
    throw new Error('Gemini 沒有回傳有效 JSON');
  }

  return candidate.substring(start, end + 1);
}


/**
 * 將 Gemini 分類轉換成允許的分類。
 */
function normalizeCategory_(category, categories) {
  for (let i = 0; i < categories.length; i++) {
    if (category.indexOf(categories[i]) >= 0) {
      return categories[i];
    }
  }

  return '一般資訊業務';
}


/**
 * 管理頁面新增或修改知識庫資料。
 */
function saveKnowledgeBaseEntry(password, entry) {
  requireAdminPassword_(password);

  entry = entry || {};

  const category =
    String(entry.category || '一般資訊業務')
      .trim()
      .substring(0, 100);

  const title =
    String(entry.title || '')
      .trim()
      .substring(0, 150);

  const content =
    String(entry.content || '')
      .trim()
      .substring(0, 10000);

  const status =
    String(entry.status || '啟用')
      .trim() === '停用'
      ? '停用'
      : '啟用';

  if (!title || !content) {
    throw new Error('標題與內容不可空白');
  }

  const sheet = ensureKnowledgeBaseSheet_();
  const rowNumber = Number(entry.rowNumber || 0);

  const values = [
    category || '一般資訊業務',
    title,
    content,
    status,
    new Date()
  ];

  if (rowNumber >= 2 &&
      rowNumber <= sheet.getLastRow()) {
    sheet
      .getRange(rowNumber, 1, 1, 5)
      .setValues([values]);
  } else {
    sheet.appendRow(values);
  }

  return getKnowledgeBaseDataInternal_(true);
}


/**
 * 管理頁面刪除知識庫資料。
 */
function deleteKnowledgeBaseEntry(password, rowNumber) {
  requireAdminPassword_(password);

  const sheet = ensureKnowledgeBaseSheet_();
  const row = Number(rowNumber);

  if (!row ||
      row < 2 ||
      row > sheet.getLastRow()) {
    throw new Error('無效的資料列');
  }

  sheet.deleteRow(row);

  return getKnowledgeBaseDataInternal_(true);
}


// ==========================================================
// 七、對話紀錄
// ==========================================================
/**
 * 寫入對話紀錄。
 *
 * B 欄寫入 LINE 顯示名稱。
 * C 欄保留 LINE userId，方便日後辨識同一位使用者。
 */
function logConversation_(
  question,
  answer,
  userId,
  displayName
) {
  try {
    const sheet = ensureLogSheet_();

    sheet.appendRow([
      new Date(),
      displayName || '未取得名稱',
      userId || 'unknown',
      question || '',
      answer || ''
    ]);

    /*
     * 每次新增紀錄後強制重新設定列高。
     */
    formatLogSheet_(sheet);

  } catch (error) {
    console.error(
      '寫入對話紀錄失敗：' +
      error.stack
    );
  }
}

/**
 * 手動重新整理對話紀錄格式。
 *
 * 請在 Apps Script 中執行一次，
 * 既有資料列就會統一成固定高度。
 */
function formatExistingLogSheet() {
  const sheet = ensureLogSheet_();

  formatLogSheet_(sheet);

  return '對話紀錄已統一設定列高。';
}

/**
 * 取得 LINE 顯示名稱。
 *
 * 一對一聊天：
 * GET /v2/bot/profile/{userId}
 *
 * 群組聊天：
 * GET /v2/bot/group/{groupId}/member/{userId}
 *
 * 多人聊天室：
 * GET /v2/bot/room/{roomId}/member/{userId}
 */
function getLineDisplayName_(source) {
  source = source || {};

  const userId =
    String(source.userId || '').trim();

  if (!userId) {
    return '未提供使用者名稱';
  }

  const accessToken =
    getConfigValue_('LINE_ACCESS_TOKEN');

  if (!accessToken ||
      accessToken.indexOf('請填入') >= 0) {
    console.warn('LINE_ACCESS_TOKEN 尚未設定');
    return '未取得名稱';
  }

  let cacheKey =
    'line_display_name_' + userId;

  if (source.type === 'group' && source.groupId) {
    cacheKey =
      'line_group_display_name_' +
      source.groupId +
      '_' +
      userId;
  }

  if (source.type === 'room' && source.roomId) {
    cacheKey =
      'line_room_display_name_' +
      source.roomId +
      '_' +
      userId;
  }

  const cache =
    CacheService.getScriptCache();

  const cachedName =
    cache.get(cacheKey);

  if (cachedName) {
    return cachedName;
  }

  let profileUrl = '';

  if (
    source.type === 'group' &&
    source.groupId
  ) {
    profileUrl =
      'https://api.line.me/v2/bot/group/' +
      encodeURIComponent(source.groupId) +
      '/member/' +
      encodeURIComponent(userId);

  } else if (
    source.type === 'room' &&
    source.roomId
  ) {
    profileUrl =
      'https://api.line.me/v2/bot/room/' +
      encodeURIComponent(source.roomId) +
      '/member/' +
      encodeURIComponent(userId);

  } else {
    profileUrl =
      'https://api.line.me/v2/bot/profile/' +
      encodeURIComponent(userId);
  }

  try {
    const response =
      UrlFetchApp.fetch(profileUrl, {
        method: 'get',
        headers: {
          Authorization: 'Bearer ' + accessToken
        },
        muteHttpExceptions: true
      });

    const statusCode =
      response.getResponseCode();

    const responseText =
      response.getContentText();

    if (
      statusCode >= 200 &&
      statusCode < 300
    ) {
      const profile =
        JSON.parse(responseText);

      const displayName =
        String(profile.displayName || '').trim();

      if (displayName) {
        /*
         * 快取 6 小時，
         * 避免每次提問都重新呼叫 LINE API。
         */
        cache.put(
          cacheKey,
          displayName,
          21600
        );

        return displayName;
      }
    }

    console.warn(
      '取得 LINE 顯示名稱失敗：' +
      statusCode +
      ' ' +
      responseText
    );

  } catch (error) {
    console.warn(
      '取得 LINE 顯示名稱發生錯誤：' +
      error.message
    );
  }

  return '未取得名稱';
}

// ==========================================================
// 八、初始化知識庫
// ==========================================================

/**
 * 初始化範例知識庫。
 *
 * 注意：
 * 這個函式會清除同名工作表既有內容，
 * 只建議第一次使用時執行。
 */
function initKnowledgeBaseSheet() {
  const ss = getSpreadsheet_();
  let sheet = ss.getSheetByName(CONFIG.SHEET_NAME);

  if (!sheet) {
    sheet = ss.insertSheet(CONFIG.SHEET_NAME);
  } else {
    sheet.clear();
  }

  sheet.appendRow([
    '分類',
    '標題 / 業務項目',
    '詳細內容與設定步驟',
    '狀態',
    '更新時間'
  ]);

  sheet
    .getRange('A1:E1')
    .setBackground('#0f766e')
    .setFontColor('#ffffff')
    .setFontWeight('bold');

  const initialData = [
    [
      '新手上路',
      '新進教師公務帳號開通與密碼重設',
      '1. ：新進教師請填寫資安宣導單洽資訊組領取。\n2. ：首次登入後請立即修改密碼。\n3. ：請依學校規定完成教育雲單一簽入 OpenID 綁定。\n4. ：請洽資訊組協助重設。',
      '啟用',
      new Date()
    ],
    [
      '校園網路與帳號',
      '校園無線網路 Wi-Fi 連線指引',
      '1. 開啟手機或筆電 Wi-Fi。\n2. 選擇校內教師專用 Wi-Fi。\n3. 依學校規定輸入帳號與密碼。\n4. 若使用 eduroam，通常需要輸入完整 Email 帳號。',
      '啟用',
      new Date()
    ],
    [
      '數位教學與軟體',
      'Microsoft Office 365 教育版授權',
      '1. 使用學校公務帳號登入 Microsoft 365。\n2. 依學校授權規定使用 Word、Excel、PowerPoint。\n3. 若顯示授權錯誤，請確認帳號、網路與授權狀態。',
      '啟用',
      new Date()
    ],
    [
      '數位教學與軟體',
      'Canva 教育版申請流程',
      '1. 前往 Canva 教育版申請頁面。\n2. 使用學校公務 Email 申請。\n3. 依平台要求上傳教師身分或在職證明。\n4. 等待平台審核結果。',
      '啟用',
      new Date()
    ],
    [
      '數位研習管考',
      '教育部數位學習研習時數查詢',
      '請登入全國教師在職進修資訊網或縣市研習護照，確認個人研習紀錄與完成時數。如資料尚未同步，請洽研習承辦單位。',
      '啟用',
      new Date()
    ],
    [
      '數位研習管考',
      'A3 數位素養增能研習',
      '1. 使用教育雲帳號登入指定平台。\n2. 搜尋 A3 數位素養相關課程。\n3. 完成影片、教材與測驗。\n4. 研習時數依平台與主管機關規定辦理。',
      '啟用',
      new Date()
    ],
    [
      '校務系統與行政',
      '校務行政系統帳號與權限申請',
      '新進教師或職務異動人員，請依學校規定向業務主責處室申請帳號與權限。若出現權限不足，請提供畫面截圖與帳號給承辦人員。',
      '啟用',
      new Date()
    ],
    [
      '校務系統與行政',
      '各處室公務系統登入問題',
      '1. 確認使用正確的公務帳號。\n2. 確認目前網路環境符合系統規定。\n3. 若顯示權限不足，請洽該系統的業務主責處室。',
      '啟用',
      new Date()
    ],
    [
      '平板與設備借用',
      '生生用平板車借用與歸還',
      '1. 請依學校規定提前登記借用時間。\n2. 領取時清點平板、觸控筆與充電線。\n3. 使用後請登出個人帳號。\n4. 當日歸還並接上電源充電。',
      '啟用',
      new Date()
    ],
    [
      '平板與設備借用',
      '電腦教室與智慧教室預約',
      '1. 請先確認場地可用時段。\n2. 透過校內場地借用系統登記。\n3. 使用後請關閉設備、整理桌椅並清點物品。',
      '啟用',
      new Date()
    ],
    [
      '校園資安與個資',
      '校園資安紅線規範',
      '1. 不得私自架設 Wi-Fi AP 或分享器。\n2. 不得將帳號密碼提供給他人。\n3. 公務電腦應維持系統更新與防毒軟體運作。\n4. 含有個資的檔案傳輸時，應依學校規定加密保護。',
      '啟用',
      new Date()
    ],
    [
      '校園資安與個資',
      '釣魚郵件與社交工程防範',
      '1. 不要任意開啟陌生附件。\n2. 不要點擊可疑縮網址。\n3. 不要在不明網站輸入帳號密碼。\n4. 發現可疑郵件時，請轉知資訊組確認。',
      '啟用',
      new Date()
    ],
    [
      '教室設備排障',
      '投影機或智慧大屏無畫面',
      '1. 檢查 HDMI 線兩端是否插緊。\n2. 使用 Win + P 確認顯示模式。\n3. 確認投影機或大屏輸入來源是否正確。\n4. 若仍無法使用，請提供教室編號與設備狀況。',
      '啟用',
      new Date()
    ],
    [
      '教室設備排障',
      '教室設備無聲音',
      '1. 點選電腦右下角喇叭圖示。\n2. 確認輸出裝置切換為投影機或大屏音訊。\n3. 確認影片或軟體本身沒有靜音。\n4. 檢查 HDMI 或音源線是否接妥。',
      '啟用',
      new Date()
    ],
    [
      '設備報修與耗材',
      '校園資訊設備報修流程',
      '1. 進入校內線上設備報修系統。\n2. 填寫教室、設備編號與故障狀況。\n3. 若為授課中的緊急故障，請依校內規定直接聯絡資訊組。',
      '啟用',
      new Date()
    ],
    [
      '設備報修與耗材',
      '資訊設備耗材申請',
      '請依學校規定填寫耗材申請或領用表，說明使用地點、設備名稱、數量與用途，並由資訊組確認庫存與後續處理方式。',
      '啟用',
      new Date()
    ]
  ];

  sheet
    .getRange(2, 1, initialData.length, 5)
    .setValues(initialData);

  sheet.autoResizeColumns(1, 5);

  console.log(
    '知識庫初始化完成，共建立 ' +
    initialData.length +
    ' 筆資料。'
  );

  return '初始化完成，共建立 ' + initialData.length + ' 筆資料。';
}


// ==========================================================
// 九、測試函式
// ==========================================================
/**
 * 統一設定「對話紀錄」工作表格式。
 *
 * 列高固定為 32 像素，
 * 長文字採截斷顯示，避免列高自動變大。
 */
/**
 * 固定「對話紀錄」工作表的列高。
 *
 * 第 1 列：標題列
 * 第 2 列開始：資料列固定 10 像素
 */
function formatLogSheet_(sheet) {
  if (!sheet) {
    return;
  }

  const lastRow = Math.max(sheet.getLastRow(), 1);
  const lastColumn = Math.max(sheet.getLastColumn(), 5);

  /*
   * 文字不換行，超出儲存格的內容直接截斷。
   * 完整內容仍保留在儲存格中。
   */
  sheet
    .getRange(1, 1, lastRow, lastColumn)
    .setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP)
    .setVerticalAlignment('middle');

  /*
   * 固定標題列高度。
   */
  sheet.setRowHeight(1, 30);

  /*
   * 強制固定資料列高度。
   * 必須使用 setRowHeightsForced，
   * 不要使用 setRowHeights。
   */
  if (lastRow >= 2) {
    sheet.setRowHeightsForced(
      2,
      lastRow - 1,
      25
    );
  }

  /*
   * 凍結標題列。
   */
  sheet.setFrozenRows(1);

  SpreadsheetApp.flush();
}


/**
 * 測試試算表與 Gemini。
 *
 * 請在 Apps Script 函式下拉選單選擇 testSystem，
 * 再按「執行」。
 */
function testSystem() {
  const ss = getSpreadsheet_();
  const sheet = ensureKnowledgeBaseSheet_();
  const kb = getKnowledgeBaseDataInternal_(false);

  console.log('試算表名稱：' + ss.getName());
  console.log('工作表名稱：' + sheet.getName());
  console.log('啟用知識庫筆數：' + kb.length);

  const answer = generateAiResponse_(
    '請簡短回答：這是一則系統測試訊息。'
  );

  console.log('Gemini 回覆：' + answer);

  return {
    spreadsheetName: ss.getName(),
    sheetName: sheet.getName(),
    knowledgeBaseCount: kb.length,
    geminiReply: answer
  };
}


/**
 * 只測試試算表，不呼叫 Gemini。
 */
function testSpreadsheet() {
  const ss = getSpreadsheet_();
  const sheet = ensureKnowledgeBaseSheet_();

  return {
    spreadsheetName: ss.getName(),
    sheetName: sheet.getName(),
    spreadsheetId: ss.getId(),
    lastRow: sheet.getLastRow()
  };
}


/**
 * 測試管理後台實際取得的資料。
 */
function testKnowledgeBaseForWeb() {
  const data = getKnowledgeBaseDataInternal_(true);

  console.log('回傳筆數：' + data.length);

  if (data.length > 0) {
    console.log(
      '第一筆資料：' +
      JSON.stringify(data[0])
    );
  }

  return {
    count: data.length,
    firstItem: data.length > 0 ? data[0] : null
  };
}

完整的 Code.gs 程式碼，請一鍵複製貼上。

雙層登入設計：
VIEW_PASSWORD 只能登入查看； ADMIN_PASSWORD 才能新增、修改與刪除。兩組密碼務必不同。

建立 index.html

在 Apps Script 左側檔案列表點選：
＋ → HTML
檔案名稱輸入： index
系統會自動建立 index.html。
將下方收闔選單中的完整前端管理頁面複製到 index.html。
按下儲存按鈕，先不要急著部署。

🌐 展開／收起 index.html 前端程式碼

請展開後查看完整 index.html，按下「一鍵複製」即可複製全部內容。

          
 <!DOCTYPE html>
<html lang="zh-TW">
<head>
  <base target="_top">

  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <title>校園資訊組 智慧小幫手控制台</title>

  <script src="https://cdn.tailwindcss.com"></script>

  <link
    rel="stylesheet"
    href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">

  <style>
    body {
      font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Noto Sans TC", sans-serif;
    }
  </style>
</head>

<body class="bg-slate-100 text-slate-800 min-h-screen">

  <!-- 頂部導航 -->
  <header class="bg-teal-900 text-white shadow-md">
    <div class="max-w-6xl mx-auto px-4 py-4 flex items-center justify-between">
      <div class="flex items-center space-x-3">
        <div class="w-10 h-10 rounded-xl bg-teal-500 flex items-center justify-center text-xl font-bold">
          <i class="fa-solid fa-laptop-code"></i>
        </div>

        <div>
          <h1 class="text-lg font-bold">
            校園資訊組 AI 智慧小幫手
          </h1>

          <p class="text-xs text-teal-200">
            LINE Bot 智慧知識庫・視覺化管理後台
          </p>
        </div>
      </div>

      <div class="flex items-center space-x-2">
        <span class="px-3 py-1 bg-teal-800 border border-teal-600 rounded-full text-xs text-teal-200">
          <i class="fa-solid fa-circle text-emerald-400 text-[10px] mr-1"></i>
          Gemini RAG 運行中
        </span>
      </div>
    </div>
  </header>


  <!-- 主內容區 -->
  <main class="max-w-6xl mx-auto px-4 py-8 space-y-6">

    <!-- 管理密碼登入區 -->
    <div
      id="loginPanel"
      class="bg-white p-5 rounded-2xl border border-slate-200 shadow-sm space-y-4">

      <div class="flex items-center space-x-3">
        <div class="w-10 h-10 rounded-xl bg-teal-100 text-teal-700 flex items-center justify-center text-lg">
          <i class="fa-solid fa-lock"></i>
        </div>

        <div>
          <h2 class="font-bold text-slate-900">
            知識庫管理員登入
          </h2>

          <p class="text-xs text-slate-500">
            請輸入管理密碼後查看或修改校園資訊知識庫
          </p>
        </div>
      </div>

      <div class="flex flex-col sm:flex-row gap-3">

        <input
          type="password"
          id="adminPasswordInput"
          placeholder="請輸入管理密碼"
          autocomplete="current-password"
          class="flex-1 px-4 py-2 text-sm border border-slate-300 rounded-xl focus:ring-2 focus:ring-teal-500 focus:outline-none">

        <button
          id="loginButton"
          onclick="loginAdmin()"
          class="px-5 py-2 rounded-xl bg-teal-700 text-white text-sm font-medium hover:bg-teal-800">

          <i class="fa-solid fa-right-to-bracket mr-1"></i>
          登入
        </button>

      </div>

      <div
        id="loginMessage"
        class="hidden text-sm rounded-xl px-4 py-3">
      </div>

    </div>


    <!-- 登入後內容區 -->
    <div
      id="contentPanel"
      class="hidden space-y-6">

      <!-- 快捷分類標籤與搜尋 -->
      <div class="bg-white p-5 rounded-2xl border border-slate-200 shadow-sm space-y-4">

        <div class="flex flex-col sm:flex-row items-center justify-between gap-3">

          <div class="relative w-full sm:w-80">
            <i class="fa-solid fa-magnifying-glass absolute left-3 top-3 text-slate-400 text-sm"></i>

            <input
              type="text"
              id="searchInput"
              placeholder="搜尋業務、網路、帳號、研習、平板、排障..."
              class="w-full pl-9 pr-4 py-2 text-sm border border-slate-300 rounded-xl focus:ring-2 focus:ring-teal-500 focus:outline-none"
              oninput="filterCards()">
          </div>

          <div class="flex flex-wrap gap-1.5 text-xs">

            <button
              onclick="filterCategory('ALL', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-teal-700 text-white font-medium">
              全部
            </button>

            <button
              onclick="filterCategory('校園網路與帳號', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              網路帳號
            </button>

            <button
              onclick="filterCategory('數位教學與軟體', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              教學軟體
            </button>

            <button
              onclick="filterCategory('數位研習管考', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              數位研習
            </button>

            <button
              onclick="filterCategory('校務系統與行政', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              校務系統
            </button>

            <button
              onclick="filterCategory('平板與設備借用', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              平板借用
            </button>

            <button
              onclick="filterCategory('校園資安與個資', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              資安規範
            </button>

            <button
              onclick="filterCategory('教室設備排障', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              設備排障
            </button>

            <button
              onclick="filterCategory('設備報修與耗材', this)"
              class="cat-btn px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200">
              報修耗材
            </button>

          </div>
        </div>


        <!-- 管理功能按鈕 -->
        <div class="flex flex-wrap items-center justify-between gap-3 pt-3 border-t border-slate-100">

          <div class="text-xs text-slate-500">
            <i class="fa-solid fa-circle-info mr-1"></i>
            登入後可以新增、編輯或刪除知識庫資料
          </div>

          <div class="flex flex-wrap gap-2">

            <button
              onclick="newEntry()"
              class="px-4 py-2 rounded-xl bg-teal-700 text-white text-sm font-medium hover:bg-teal-800">

              <i class="fa-solid fa-plus mr-1"></i>
              新增資料
            </button>

            <button
              onclick="logoutAdmin()"
              class="px-4 py-2 rounded-xl bg-slate-100 text-slate-600 text-sm font-medium hover:bg-slate-200">

              <i class="fa-solid fa-right-from-bracket mr-1"></i>
              登出
            </button>

          </div>
        </div>

      </div>


      <!-- 新增／編輯資料表單 -->
      <div
        id="editorPanel"
        class="hidden bg-white p-5 rounded-2xl border border-slate-200 shadow-sm space-y-4">

        <div class="flex items-center justify-between gap-3">

          <div>
            <h2
              id="editorTitle"
              class="font-bold text-slate-900">
              新增知識庫資料
            </h2>

            <p class="text-xs text-slate-500">
              請輸入或修改校園資訊組的知識內容
            </p>
          </div>

          <button
            onclick="cancelEdit()"
            class="px-3 py-1.5 rounded-lg bg-slate-100 text-slate-600 hover:bg-slate-200 text-xs">

            <i class="fa-solid fa-xmark mr-1"></i>
            取消
          </button>

        </div>


        <input
          type="hidden"
          id="rowNumberInput">


        <div>
          <label
            for="categoryInput"
            class="block text-sm font-medium text-slate-700 mb-1">
            分類
          </label>

          <input
            type="text"
            id="categoryInput"
            placeholder="例如：校園網路與帳號"
            class="w-full px-4 py-2 text-sm border border-slate-300 rounded-xl focus:ring-2 focus:ring-teal-500 focus:outline-none">
        </div>


        <div>
          <label
            for="titleInput"
            class="block text-sm font-medium text-slate-700 mb-1">
            標題／業務項目
          </label>

          <input
            type="text"
            id="titleInput"
            placeholder="例如：教師 Wi-Fi 連線方式"
            class="w-full px-4 py-2 text-sm border border-slate-300 rounded-xl focus:ring-2 focus:ring-teal-500 focus:outline-none">
        </div>


        <div>
          <label
            for="contentInput"
            class="block text-sm font-medium text-slate-700 mb-1">
            詳細內容與設定步驟
          </label>

          <textarea
            id="contentInput"
            rows="7"
            placeholder="請輸入操作步驟、注意事項或聯絡方式"
            class="w-full px-4 py-2 text-sm border border-slate-300 rounded-xl focus:ring-2 focus:ring-teal-500 focus:outline-none">

狀態

載入校園資訊知識庫中...

程式中應該具備的主要函式

函式	用途
doGet(e)	瀏覽器開啟管理網頁時，載入 index.html。
doPost(e)	接收 LINE Webhook 傳入的訊息事件。
testSpreadsheet()	測試 Apps Script 是否能連到 Google 試算表。
testSystem()	測試試算表、知識庫與 Gemini API。
initKnowledgeBaseSheet()	第一次使用時建立範例知識庫。
verifyLogin(password)	驗證檢視者或管理者登入密碼。
saveKnowledgeBaseEntry()	管理者新增或修改知識庫。
deleteKnowledgeBaseEntry()	管理者刪除知識庫資料。

我已貼上完整 Code.gs。

我已建立 index.html 並貼上管理頁面。

我已填入 Spreadsheet ID、Gemini API Key 與 LINE Token。

我已設定檢視密碼與管理者密碼。

測試系統、部署 Web App 並設定 LINE Webhook

約 8～15 分鐘完成

我已完成

第一階段：先測試試算表連線

在 Apps Script 上方函式下拉選單選擇： testSpreadsheet
按下「執行」。
第一次執行時，依照 Google 授權畫面完成授權。如果看到「進階」選項，請確認這是自己建立的專案後再繼續。

正常結果應包含：
試算表名稱、工作表名稱、Spreadsheet ID 與資料列數。

第二階段：第一次使用才初始化知識庫

如果知識庫工作表尚未建立，才執行： initKnowledgeBaseSheet
回到 Google 試算表，確認出現：
- 資訊組AI小幫手知識庫
- 對話紀錄

第三階段：測試 Gemini 與知識庫

在函式下拉選單選擇： testSystem
按下「執行」。
查看 Apps Script 左側：執行項目或執行記錄。

試算表名稱：資訊組AI小幫手知識庫
工作表名稱：資訊組AI小幫手知識庫
啟用知識庫筆數：15
知識庫資料筆數：15
送給 Gemini 的知識庫字數：3489
Gemini 成功使用模型：gemini-3.1-flash-lite
Gemini 回覆：......

如果顯示「GEMINI_MODELS 沒有設定」：
請檢查 CONFIG 是否真的有加入 GEMINI_MODELS: [...]。

第四階段：部署 Apps Script Web App

點選 Apps Script 右上角：
部署 → 新增部署作業
點擊左側齒輪或「選取類型」，選擇：網頁應用程式 Web app
設定如下：

項目	建議設定	說明
說明	v1	方便辨識部署版本。
執行身分	我	程式以擁有者權限讀取試算表並呼叫 API。
誰可以存取	所有人 Anyone	LINE 伺服器必須能從外部連線到 Webhook。

為什麼要選「所有人」？
LINE 平台需要從外部將訊息 POST 到您的 Web App。但這不等於公開 GAS 程式碼，也不等於公開 Google 試算表。使用者能看到什麼，取決於您的 doGet、 doPost 與管理頁面是否有正確驗證。

按下「部署」。
如果出現授權視窗，依畫面完成授權。
部署完成後，複製： Web app URL

正式 Web App 網址通常長這樣：

https://script.google.com/macros/s/部署ID/exec

請使用 /exec，不要使用 /dev。
/dev 是測試網址，通常只有具備腳本編輯權限的人可以使用。 LINE Webhook 應使用正式部署後的 /exec 網址。

第五階段：回到 LINE Developers 設定 Webhook

回到 LINE Developers Console：
Provider → Messaging API Channel → Messaging API
找到： Webhook URL
貼上剛才複製的 Apps Script Web App URL。
按下： Verify
看到： Success
確認： Use webhook：ON

第六階段：關閉 LINE 內建自動回覆

如果沒有關閉 LINE 官方帳號的內建自動回覆，使用者可能同時收到兩段訊息：

感謝您的訊息！
很抱歉，本帳號無法個別回覆用戶的訊息。
以及：
Gemini AI 小幫手的實際回覆。

請確認以下設定：

自動回應訊息：關閉。

歡迎訊息：關閉。

Webhook：啟用。

Use webhook：ON。

四、加入好友並進行第一次測試

✓

加入 LINE 官方帳號，開始測試

完成後即可讓學員實際操作

我已完成

在 LINE Developers 的 Messaging API 頁面找到官方帳號 QR Code。
使用手機 LINE 掃描 QR Code，加入官方帳號。
在一對一聊天室傳送：

請問校園 Wi-Fi 怎麼設定？

或傳送：

生生用平板要如何借用？

正常情況：
Bot 會讀取知識庫中與問題相關的資料，再由 Gemini 整理成親切、清楚的繁體中文回答。

群組測試方式

如果程式設定成群組內只有被提及時才回覆，請使用包含小幫手稱呼的訊息，例如：

小幫手，請問校園 Wi-Fi 怎麼設定？

如果只是輸入一般文字而沒有提到小幫手， Bot 可能會刻意不回覆，以免干擾群組聊天。

更新程式後不需要重新掃碼：
只要仍然使用同一個 LINE 官方帳號與同一個 Messaging API Channel，修改 GAS、更新部署版本或重新產生 Channel access token，通常都不需要重新加入好友。

五、如何進入知識庫管理後台？

後台網址就是同一個 Web App URL。
也就是 LINE Webhook 使用的 /exec 網址。

例如：

https://script.google.com/macros/s/部署ID/exec

將這個網址貼到瀏覽器開啟，就會由 doGet() 載入 index.html 管理頁面。

登入方式	可以做什麼？
檢視密碼	登入、搜尋、查看知識庫；不能新增、修改、刪除。
管理者密碼	查看、新增、修改、刪除知識庫資料。

安全設計提醒：
不可以只在前端把「編輯」按鈕藏起來。 Code.gs 的新增、修改、刪除函式也必須再次驗證管理者密碼，才能真正防止檢視者直接呼叫後端函式。

六、知識庫資料應該怎麼整理？

一筆知識庫資料建議只處理一個明確主題，這樣 Gemini 比較容易找到最相關的答案。

分類	標題／業務項目	詳細內容與設定步驟	狀態
校園網路與帳號	教師 Wi-Fi 連線方式	1. 開啟 Wi-Fi。 2. 選擇教師專用基地台。 3. 輸入教師公務帳號。 4. 若仍無法連線，請提供設備與教室資訊。	啟用
平板與設備借用	生生用平板車借用流程	請於授課前幾天完成登記，領取時清點平板與配件，使用後登出帳號並歸還充電。	啟用

知識庫撰寫原則：

寫入學校真正採用的規定，不要直接照抄其他學校範例。
Wi-Fi 密碼、個資、帳號密碼不要直接放入公開知識庫。
校內分機、系統網址與設備編號要確認是否適合讓所有使用者看到。
如果資訊已經過期，請修改或將狀態改為「停用」。

七、常見問題與排除方式

問題 1：LINE 完全沒有回覆。

確認 LINE Developers 的 Webhook URL 結尾是 /exec。
確認 Use webhook 已開啟。
確認 LINE Channel access token 正確且沒有多餘空白。
確認 Web App 部署版本是最新版本。
到 Apps Script「執行項目」查看是否有錯誤。

問題 2：同時收到 LINE 內建訊息與 Gemini 回覆。

請到 LINE Official Account Manager 關閉：

自動回應訊息。
歡迎訊息。

Webhook 保持啟用即可。

問題 3：測試紀錄顯示「GEMINI_MODELS 沒有設定」。

請確認 CONFIG 內有設定多模型陣列：

GEMINI_MODELS: [
  'gemini-3.7-flash',
  'gemini-3.6-flash',
  'gemini-3.5-flash',
  'gemini-3.1-flash-lite',
  'gemini-2.5-flash',
  'gemini-2.5-flash-lite'
]

問題 4：Bot 說知識庫沒有資料，但試算表明明有資料。

請檢查：

Apps Script 是否連到正確的 Spreadsheet ID。
SHEET_NAME 是否與下方工作表名稱完全相同。
知識庫資料的狀態是否為「啟用」。
generateAiResponse_() 是否真的將分類、標題與內容組合後送給 Gemini。

正確的知識庫文字組合應該類似：

return (
  '' + item.category + '\n' +
  '' + item.title + '\n' +
  '\n' + item.content
);

問題 5：試算表的提問者欄位是一長串 ID。

LINE Webhook 原本提供的是 userId。如果希望顯示 LINE 顯示名稱，程式需要再呼叫 LINE Profile API 取得 displayName。建議同時保留「提問者名稱」與「提問者 ID」，因為顯示名稱可能會被使用者自行修改。

問題 6：修改程式後，LINE 還是使用舊版本。

修改 Code.gs 或 index.html 後，請重新部署新版本：

部署
→ 管理部署作業
→ 編輯原本的 Web App
→ 版本：新增版本
→ 部署

通常不需要更換 Webhook URL，也不需要重新掃描 QR Code。

八、實務建議

先從小範圍開始 先放入 10～20 筆最常被詢問的資料，例如 Wi-Fi、帳號、平板、投影機與報修流程。

每筆資料保持單一主題 不要把 Wi-Fi、投影機、平板與研習全部塞在同一筆，讓 AI 更容易找到正確答案。

建立更新制度 建議每學期或每學年檢查一次知識庫，將過期規定改為停用或重新編修。

最重要的觀念：
AI 的回答品質，不只取決於 Gemini，更取決於您提供的校內知識是否正確、清楚、最新。知識庫整理得越好，Bot 越像一位真正熟悉學校業務的資訊組長。

首頁選單：
可以在Line Office Account的主頁，左側聊天室相關，找到圖文選單，上傳圖片，功能設定成文字，就可以建立一個簡單的首頁選單。Bot 會越加人性化一點。

參考資料

LINE Messaging API：Get started
LINE Messaging API：Building a bot
LINE：Channel access token
Google Apps Script：Web apps
Google Gemini API：API keys
Google Gemini API：Models
全台中小學 AI 數位轉型開源專案

本教學中的畫面名稱可能會因 LINE、Google Apps Script 或 Google AI Studio 介面更新而略有不同；若找不到完全相同的文字，請尋找功能相近的選項。

Tech

2026年8月29日星期六

資訊組AI小幫手

校園資訊組 LINE Bot AI 智慧小幫手

一、完成後，會得到什麼？

二、整體運作流程

三、開始前請先準備

建立 LINE 官方帳號並啟用 Messaging API

取得 LINE Channel access token

取得 Gemini API Key

建議保留多模型備援

建立 Google 試算表知識庫

程式會使用的工作表

建立 Apps Script，貼上 Code.gs 與 index.html

CONFIG 基本設定範例

建立 index.html

程式中應該具備的主要函式

測試系統、部署 Web App 並設定 LINE Webhook

第一階段：先測試試算表連線

第二階段：第一次使用才初始化知識庫

第三階段：測試 Gemini 與知識庫

第四階段：部署 Apps Script Web App

第五階段：回到 LINE Developers 設定 Webhook

第六階段：關閉 LINE 內建自動回覆

四、加入好友並進行第一次測試

加入 LINE 官方帳號，開始測試

群組測試方式

五、如何進入知識庫管理後台？

六、知識庫資料應該怎麼整理？

七、常見問題與排除方式

八、實務建議

參考資料

沒有留言:

張貼留言

2026年8月29日 星期六

資訊組AI小幫手

校園資訊組 LINE Bot AI 智慧小幫手

一、完成後，會得到什麼？

二、整體運作流程

三、開始前請先準備

建立 LINE 官方帳號並啟用 Messaging API

取得 LINE Channel access token

取得 Gemini API Key

建議保留多模型備援

建立 Google 試算表知識庫

程式會使用的工作表

建立 Apps Script，貼上 Code.gs 與 index.html

CONFIG 基本設定範例

建立 index.html

程式中應該具備的主要函式

測試系統、部署 Web App 並設定 LINE Webhook

第一階段：先測試試算表連線

第二階段：第一次使用才初始化知識庫

第三階段：測試 Gemini 與知識庫

第四階段：部署 Apps Script Web App

第五階段：回到 LINE Developers 設定 Webhook

第六階段：關閉 LINE 內建自動回覆

四、加入好友並進行第一次測試

加入 LINE 官方帳號，開始測試

群組測試方式

五、如何進入知識庫管理後台？

六、知識庫資料應該怎麼整理？

七、常見問題與排除方式

八、實務建議

參考資料

沒有留言:

張貼留言

2026年8月29日星期六