功能設定

對話平台的功能設定：基本功能、AI 互動功能、Hook 處理標記、提問集選項顯示模式，以及 AI 感知設定（使用系統時間、傳送者名稱、位置資訊回答）與時區規則。

功能設定 是對話平台設定頁裡開關最多的一個分類，決定使用者在對話中「能做什麼、看得到什麼」，以及 AI 回答時「知道什麼」。網頁與 API 平台有完整五個區塊，內部平台沒有「提問集選項顯示模式」；LINE、Microsoft Teams 等通訊平台只有「AI 互動功能」（啟用 OCR、@ 提及才回覆 與 各平台專屬開關）與「AI 感知設定」。

方案導覽：本頁是對話平台設定的其中一步，文字客服的完整上線流程見 文字客服：從零到上線。

這些設定掛在每一個對話平台上，不是掛在 Agent 上。同一個 Agent 接了網頁與 LINE，就要分別在兩個平台設定。設定頁的整體結構與進入方式請見對話平台設定總覽。

一、什麼時候會用到

一家診所用 Agent 在 LINE 上回答掛號問題。病患問「今天下午還能掛號嗎」，Agent 卻反問「請問今天是幾月幾日」。負責的行政人員打開 LINE 平台的 功能設定，把 使用系統時間回答 打開，時區維持 Asia/Taipei，按下 儲存。再問一次，Agent 直接回答「今天是星期五，下午門診 14:00 開始，目前還可以掛號」，Agent 的角色指令一個字都沒改。

二、基本功能

網頁平台的功能設定：「基本功能」區塊的最後一列是「啟用對話交接」與「顯示上下文使用量」

開關	說明
是否啟用	關閉後這個平台停止對外服務，使用者打開對話頁無法送出訊息
允許上傳檔案	使用者可以在對話中上傳圖片或檔案給 AI 分析
允許分享對話	使用者可以產生對話的分享連結
允許切換字級大小	對話視窗提供字級切換
啟用對話交接	MaiAgent 已開啟全域對話交接功能時，此平台的 Web Chat 會在上下文使用量達 80% 起顯示交接提示條，並可產生交接摘要卡。全域開關不在後台，需洽 MaiAgent；全域未開啟時，打開這個開關不會有任何可見變化。預設關閉。說明見對話交接
顯示上下文使用量	此平台的 Web Chat 在輸入框下方顯示上下文使用量百分比。與對話交接互相獨立，可以只開其中一個。預設關閉

啟用對話交接 與 顯示上下文使用量 只出現在網頁與 API 平台，內部平台的設定頁不顯示這兩個開關。MaiGPT 不需要設定：上下文使用量一律顯示，對話交接只看全域開關。兩個功能在對話中的實際效果請見對話交接。

「是否啟用」的預設值與切換權限

• 誰可以切換：能編輯這個對話平台的成員就能切換 是否啟用，也就是角色具備 對話平台權限，且在 分配對話平台 中對此平台有 編輯 權限；只有讀取權限的成員無法切換。設定方式見 角色權限管理 與 角色資源可見性控制。

• 新 Agent 的預設狀態：建立或複製 Agent 時，系統自動帶出的網頁與 API 平台預設為啟用。組織可以改為「新建的 Agent 預設不啟用」，由有權限的成員確認後再手動開啟；這個組織層級的預設值由 MaiAgent 設定，如需調整請洽 MaiAgent 窗口。調整只影響之後新建的 Agent，既有 Agent 的狀態不變；內部平台一律啟用。

• 停用時訪客看到什麼：Web Chat 會直接顯示「此頁面暫時不提供服務」，不會先要求登入或填寫對話前表單。

三、AI 互動功能

開關	說明
顯示引用文件	AI 回答時列出參考的知識庫來源，使用者點引用節點可看到文件片段
允許下載引用文件	使用者可以下載被引用的檔案
啟用 OCR	辨識上傳圖片中的文字，讓 AI 讀得到截圖或掃描件的內容
顯示思考過程	對話中顯示 AI 的推理過程
允許使用者調整思考力度	使用者可以在對話視窗自行調整 AI 的思考深度。要讓對話視窗出現思考力度按鈕，必須同時開啟「顯示思考過程」，且 Agent 使用的模型支援思考；Agent 的預設等級在 建立 Agent：設定思考力度 設定，使用者端選單中「預設」的實際行為見 MaiGPT 對話：思考力度
顯示知識庫檔案及 FAQ 選取列表	只有內部平台有這個開關，預設開啟。開啟後，成員在內部對話中可以從 Agent 關聯的知識庫檔案與 FAQ 清單勾選本次要查詢的範圍，Agent 只在選取的範圍內檢索；關閉則不顯示清單，一律檢索全部關聯的知識庫

開啟「顯示引用文件」與「允許下載引用文件」後的對話畫面

依使用情境決定是否公開引用資訊：公開客服顯示所有引用建立信任感；內部支援可關閉下載保護機密文件；教育機構顯示學習資源方便學生查閱。

Web Chat 的思考力度按鈕

Web Chat 要同時符合三個條件，輸入框下方才會出現思考力度按鈕：開啟 顯示思考過程、開啟 允許使用者調整思考力度，且 Agent 使用的模型支援思考。

按鈕上顯示這段對話目前套用的等級。點開後，上方是 預設 與 關閉（只在模型可以關閉思考時出現），下方是 Agent 所用模型支援的等級；訪客選好後，這段對話之後的回覆都依該等級思考。Agent 本身的預設等級在 建立 Agent：設定思考力度 設定。

Agent 已設定預設等級時，選單的 預設 下方顯示「跟隨助理設定」；Agent 沒有設定等級時，預設 會依模型實際行為標示為 預設（不思考・最快） 或 預設（模型會自行思考），說明見 MaiGPT 對話：思考力度。各思考等級的說明都是「開啟思考：每次模型呼叫約多 1–3 秒，依模型而異」。

Web Chat 的思考力度選單：Agent 已設定等級時，「預設」顯示跟隨助理設定

通訊平台專屬開關

LINE、Telegram、Microsoft Teams、Slack、Viber 等通訊平台的 功能設定 分頁，「AI 互動功能」區除了 啟用 OCR，還有依平台能力提供的開關：

開關	哪些平台	說明
@ 提及才回覆	有群組聊天的平台（LINE、Telegram 等；Slack、LINE WORKS 在建立時的對應選項）	在群組中只有被 @ 提及時才回覆；一對一對話不受影響
AI 助理思考中動畫	LINE	預設開啟。使用者送出訊息後，AI 產生回覆期間在 LINE 顯示「思考中」的載入動畫。只在一對一聊天室生效，群組不會顯示。LINE 的這個開關在 基本設定 分頁，見 LINE：AI 助理思考中動畫
啟用輸入中提示	Telegram	機器人處理回覆時顯示 Telegram 原生的「輸入中…」提示
等待提示訊息	Microsoft Teams、Slack、Telegram、Viber	AI 還在處理時先送一則文字提示，見下表

等待提示訊息的欄位：

欄位	說明
啟用等待提示訊息	使用者傳訊息後，AI 還在處理時先送一則提示訊息
提示訊息文字	啟用後必填，例如「AI 處理中，請稍候...」
首次提示延遲秒數	等幾秒才送出第一則提示，建議 1–3 秒；太短的話 AI 若很快回覆，提示會顯得多餘
提示重複間隔秒數	AI 仍在處理時，每隔幾秒更新一次提示文字，並附上已經過的秒數
AI 回覆後自動刪除提示訊息	AI 回覆送出後刪掉先前的提示訊息，只在支援刪除訊息的平台（Teams、Slack、Telegram）有效；Viber 的提示訊息會留在對話中

網頁平台沒有這些開關：Web Chat 的等待體驗由 回覆等待樣式 控制。

四、Hook 處理標記

開啟 顯示 Hook 處理標記 後，訊息經過 Hook 處理（例如敏感資訊遮蔽）時，對話中會顯示標記，標記文字可自訂。Hook 本身的設定請見 Hook 訊息攔截。

五、工具顯示模式（已移到回覆等待樣式）

工具顯示模式（AI 呼叫工具時，工具卡顯示完整、精簡或隱藏）在同一設定頁的 回覆等待樣式 → 調用工具時 設定，和工具執行文案、品牌動畫的「調用工具中」素材放在一起，操作方式見回覆等待樣式：調用工具時。

六、提問集選項顯示模式

Agent 配置了內建的 Agent UI 提問工具 後，可以在對話中向使用者「出題」：例如先問「想了解哪個主題？」並附上幾個選項，使用者點選後 Agent 再依答案往下回覆。這一區決定這些選項在 Web Chat 上怎麼呈現，兩張卡片二選一，點選後隨整頁 儲存 一起送出：

模式	對話視窗的效果
浮動按鈕	選項以按鈕列浮在輸入框上方，輸入框保持可用；使用者直接打字送出，就視為忽略選項
選項面板	選項以面板覆蓋輸入區，使用者作答或關閉面板後才回到輸入框

「提問集選項顯示模式」：兩張卡片附縮圖預覽，點選後隨整頁儲存

客服主管的 Agent 在對話開頭會先請訪客選擇「產品功能」「價格方案」「技術支援」三個主題。上線後有訪客反映：「我想直接打字問問題，可是選項面板擋住了輸入框。」她打開該網頁平台的 功能設定，在「提問集選項顯示模式」點選 浮動按鈕 並按 儲存。訪客重新開啟對話視窗後，選項改成浮在輸入框上方的按鈕列，想點選就點、想打字就打，不用再先關掉面板。

預設為「選項面板」，新建與既有的平台都一樣；要改用浮動按鈕請自行切換。這個設定只影響網頁與 API 平台的 Web Chat 呈現；內部平台的測試對話固定使用選項面板，因此設定頁不會出現這一區。

讓 Agent 出題：角色指令範例

要讓 Agent 在對話中出題，先到 AI 功能 → AI 助理 的 工具 分頁配置內建的 Agent UI 提問工具。工具本身會告訴 AI 每一題有哪些欄位，角色指令只需要寫清楚三件事：什麼時候問、問什麼、要不要開放自由輸入。後台沒有「是否開放其他」的開關，這些都由角色指令決定、AI 每次出題時自己帶上。

每一題可用的欄位：

欄位	用途	沒寫時
label	題目文字	必填
options	選項清單，建議 2 到 5 個	必填
multi_select	允許複選	單選
allow_other	開放「其他」自由輸入：選項面板多一個「其他」輸入框，浮動按鈕模式則把輸入框提示字改成「輸入其他答案」	只能從選項挑
skippable	設為 false 表示這題必答：選項面板不顯示「略過」鈕、Esc 鍵無效	可略過

範例一：需求不明確時先釐清（單選）

角色指令片段

當使用者的問題可能對應多種方案、你無法判斷該回答哪一種時，先呼叫 Agent UI 提問工具確認，不要直接猜。
例如使用者說「想了解方案」，出一題「想了解哪個方案？」，選項：入門版、專業版、企業版。
一次最多出 2 題，每題 2 到 5 個選項。收到答案後直接回答，不要再重複出同一題。

範例二：開放「其他」與複選

角色指令片段

詢問使用者的產業別時，選項給「金融、零售、製造」，並開放「其他」讓使用者自行輸入（allow_other 設為 true）。
詢問想了解的功能時允許複選（multi_select 設為 true），選項：知識庫、工作流、多語系、API 串接。

範例三：只在對話開頭出一次

角色指令片段

對話的第一則回覆先呼叫 Agent UI 提問工具問「想了解哪個主題？」，選項：產品功能、價格方案、技術支援。
之後不再主動出題，除非使用者說「重新選擇」。

範例四：必答題（不可略過）

角色指令片段

測驗的每一題都必須作答（skippable 設為 false）。
如果使用者沒有點選選項、而是直接打字或關閉題目，請用一句話說明這題必須作答，然後重新出同一題。

skippable: false 只影響選項面板的「略過」鈕與 Esc 鍵。使用者仍然可以按 ✕ 關閉面板；浮動按鈕模式沒有略過鈕，直接打字就等於忽略選項。所以「必答」要成立，角色指令一定要像範例四那樣寫明「沒作答就重新出題」，由 Agent 把關。

AI 依上述指令產生的題目長這樣（由 AI 自動組成，供對照用，不需要寫進角色指令）：

範例二的第一題

{ "id": "industry", "label": "您的產業別？", "options": ["金融", "零售", "製造"], "allow_other": true }

使用者作答後，Web Chat 會以「Q: 題目」「A: 答案」的格式送出，複選以「、」相接，自由輸入的「其他」答案也走同一格式。角色指令若要依答案分流，就用這個格式判斷。

不要在角色指令或題目文字裡寫「按略過」「關閉面板」：浮動按鈕模式沒有這兩個按鈕。使用者直接打字送出就代表忽略選項；題目有開 allow_other 時，打字送出的內容會當作「其他」答案。

七、AI 感知設定

AI 感知設定讓 Agent 在回答時知道「現在幾點」「在跟誰說話」「對方在哪裡」。開啟後，系統會在每一次回覆前，自動把對應資訊補進 AI 的上下文，您不需要修改角色指令、也不需要另外串接工具。三個開關各平台獨立設定。使用系統時間回答 在新建立的對話平台預設為開啟（包含建立 Agent 時自動產生的網頁、內部、API 平台，以及從「串接對話平台」新增的 LINE、Messenger 等所有通路），不需要就在建立表單或設定頁關閉；既有平台維持原本的設定。使用傳送者名稱回答 與 使用位置資訊回答 預設為關閉。

開關	AI 會知道什麼	適合的情境	哪些平台有
使用系統時間回答	目前的日期、時間、星期與時區	「今天幾號」「現在幾點」「現在還有營業嗎」「三天後是星期幾」	所有平台
使用傳送者名稱回答	對方的名稱	用名字稱呼客戶、個人化問候	所有平台
使用位置資訊回答	使用者分享的座標	「離我最近的門市」「這附近有沒有服務據點」	網頁、內部、API、LINE

使用系統時間回答

捲到 AI 感知設定 區塊打開 使用系統時間回答。網頁與內部平台開啟後顯示「自動時間偵測」，時區取自使用者瀏覽器，不用手動設定。

網頁平台：開啟後顯示「自動時間偵測」，時區取自使用者瀏覽器

API 平台與 LINE 等通訊平台開啟後，會多出 時區 下拉選單，下方即時顯示該時區的 目前時間 方便確認。預設為 Asia/Taipei（台北時間 UTC+8），可搜尋切換成其他時區。

API 平台：需手動選擇時區，下方顯示該時區的目前時間

時區怎麼決定

注入的時間會換算成使用者所在的時區，時區來源依平台不同：

平台	時區來源	需不需要手動設定
網頁、內部	自動取使用者瀏覽器的時區，每則訊息隨附	不需要，畫面會顯示「自動時間偵測」
API	呼叫端在訊息 metadata 帶 timezone（IANA 格式，例如 America/New_York）；沒帶就用平台的 時區 設定	建議設定，作為沒帶時區時的預設值
LINE、Microsoft Teams、Slack、Email 等通訊平台	一律使用平台的 時區 設定	需要；海外使用者為主的平台請改成對應時區

通訊平台拿不到使用者的所在時區，所以同一個 LINE 平台服務多國使用者時，AI 只能用一個固定時區回答。若有多個地區的使用者，建議依地區分別建立平台。

API 串接時在訊息帶時區的範例：

{
  "message": {
    "content": "現在幾點？",
    "metadata": { "timezone": "America/New_York" }
  }
}

時區字串無效時，API 會拒絕該請求並回傳驗證錯誤。

使用傳送者名稱回答

開啟後 AI 會知道對方的名稱，並在合適的時候用名字稱呼。名稱取自這筆對話的聯絡人名稱，也就是 客服對話 → 聯絡人 裡看到的名稱：通訊平台由該平台的使用者顯示名稱自動建立，網頁平台則來自登入使用者或對話前表單填寫的資料。聯絡人沒有名稱時，AI 就照一般方式回答。

使用位置資訊回答

開啟後，AI 會依使用者的座標提供在地化回答，例如推薦最近的門市。位置來源：網頁對話視窗向瀏覽器取得定位授權後隨訊息帶入；API 平台由呼叫端在訊息 metadata 帶入 latitude、longitude。目前網頁、內部、API 與 LINE 平台提供這個開關。

八、常見問題

Q：開了「使用系統時間回答」，AI 還是答錯日期？

先確認開的是使用者實際在用的那個平台（例如問題發生在 LINE，就要開 LINE 平台的開關，不是網頁平台）。再確認通訊平台的 時區 是否正確。

Q：需要在角色指令裡加「今天是 ○月○日」嗎？

不需要，也不建議。時間由系統每次自動帶入；在角色指令寫死日期反而會讓 AI 拿到兩個互相矛盾的日期。

Q：AI 會不會去呼叫外部服務查時間？

不會。時間來自平台伺服器的時鐘，換算成對應時區後直接提供給 AI，不呼叫任何外部 API。

Q：夏令時間會自動處理嗎？

會。時區用 IANA 名稱（例如 America/New_York）設定，夏令時間切換由系統自動換算。

Q：這個時區和「客服轉真人設定」裡服務時間的時區一樣嗎？

是兩個獨立的設定。這裡的時區給 AI 回答用；客服轉真人設定的服務時間有自己的時區，決定真人客服的上班時段怎麼判定。

Q：關掉「工具顯示模式」的工具卡片，AI 還會用工具嗎？

會。「隱藏」只是不在對話中顯示工具執行區塊，不會停用工具。工具顯示模式在回覆等待樣式設定。若要阻止 AI 呼叫某支工具，請到 Agent 的「工具」設定取消配置。