# OakXgen 使用手冊 > OakXgen 的操作手冊與常見問題。 ## Table of Contents ### 對話 › 建立與管理 - [怎麼新增、切換、找回對話](https://docs.oakxgen.ai/zh-Hant-TW/guide/chats/manage-conversations.md): 對話頁面是拿建好的 agent 直接聊測試用的地方。這篇說明怎麼開新對話、換 agent、找回舊紀錄。 ### 對話 › 驗證與除錯 - [怎麼從一則回覆確認 AI 真的查到了什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/chats/verify-ai-answers.md): 每則 AI 回覆下面可能帶著「參考」清單，這篇說明那是什麼、什麼時候不會出現、代表什麼意思。 ### AI 代理 › 建立與選型 - [Channel 還是 Skill？兩種 agent 怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/agent-types.md): 建立 agent 時只會看到這兩種類型可選，這篇說明兩者的差異，幫你在建立當下就選對。 - [用範本快速建立 agent，還是從空白開始](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/templates.md): 選完類型後可以套用範本，範本只是預填的起始值，套用後角色設定、場景都還能整包改。這篇列出目前有哪些範本。 ### AI 代理 › Channel（SCRM／通訊平台） - [三種場景類型：諮詢查詢／表單流程／固定回覆，怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-types.md): 新增場景的第一步是選類型，三種類型的資料結構完全不同，選錯了要刪掉重建，不能中途切換。這篇說明三者的差異，以及怎麼用 AI 幫你把場景說明跟例句寫出草稿。 - [場景說明要怎麼寫，AI 才分得對](https://docs.oakxgen.ai/zh-Hant-TW/guide/scenarios/routing-description.md): 決定客人的問題會進到哪個場景的，主要是「場景說明」而不是例句。這篇說明兩者的分工、常見的寫法錯誤，以及為什麼多寫例句沒有用。 - [表單場景：欄位、選項、完成後怎麼收尾](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-form.md): 表單場景要設定收集哪些欄位、每個欄位要不要給預設選項、以及填完之後要送出什麼訊息、要不要轉真人。這篇說明這幾個設定的細節。 - [諮詢查詢場景：資料來源與工具範圍怎麼縮小](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-qa-scope.md): 諮詢查詢場景可以把資料夾與工具的範圍縮小到只給這個場景用，三選一是全部、自選、不使用。這篇說明三者的差異，以及跟 agent 本身資料來源設定的關係。 - [諮詢查詢的兩個進階回覆格式：卡片輪播、AI 建議選項](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-qa-formats.md): 諮詢查詢場景可以額外開啟卡片輪播與 AI 建議選項兩種回覆格式，各自有一個「什麼時候該用」的條件說明欄位。這篇說明兩者的用途與怎麼寫觸發條件。 - [固定回覆場景與快速回覆按鈕](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-template-quickreply.md): 固定回覆場景可以設定多則一字不改照發的訊息，諮詢查詢與固定回覆都可以另外加快速回覆按鈕。這篇說明兩者怎麼設定，以及 LINE 平台的數量與字數限制。 - [服務時間與回覆節奏怎麼設](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/service-hours-pacing.md): 服務時間決定 AI 什麼時候該回話，回覆節奏決定收到訊息後多快回。這篇說明服務時間的三種模式（尤其是容易搞混的「時段外」），以及等待與載入動畫怎麼設。 - [說話方式：語氣、表情符號、訊息長度、禁用詞](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/voice-tone.md): 語氣分頁的「說話方式」區塊控制 AI 回覆的用字風格、長度與底線，這篇逐一說明每個欄位的作用範圍。 - [轉真人怎麼觸發](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md): 轉真人分頁控制什麼情況下把對話交給真人接手，有關鍵字、情緒偵測、連續答不出來三種觸發條件，這篇逐一說明。 - [主動追問：等待時間與話術](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/follow-up.md): 主動追問讓 AI 在客人沒回覆一段時間後主動送一句話拉回來，最多可以設 3 道追問，各自有自己的等待時間與話術。這篇說明怎麼設，以及跟服務時間互相打架時會發生什麼事。 ### AI 代理 › Skill - [資料來源怎麼設](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-sources.md): Skill agent 能掛四種資料來源：資料夾、指定檔案、試算表、網頁搜尋，這篇說明各自的用途與什麼時候該選哪一種。 - [用試算表當資料來源要注意什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-source-spreadsheet.md): 試算表要分享給另一個服務帳號才讀得到，跟 Google Drive 連線用的不是同一個帳號，這篇說明怎麼分享以及常見的搞混點。 - [網頁搜尋資料來源的參數是什麼意思](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-source-web-search.md): 網頁搜尋資料來源有五個可調參數：關鍵字前綴、網域白名單、時效性、天數、筆數。這篇逐一說明各自的用途。 - [怎麼幫 agent 掛工具庫的動作](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/actions.md): 工具庫裡設定好的連線與動作，要在 agent 編輯畫面另外掛上才會生效。這篇說明怎麼挑動作、為什麼有些動作選不到，以及同名動作怎麼分辨。 ### AI 代理 › 串接 - [SCRM 串接：選帳號就自動接好](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scrm-integration.md): 要讓 AI 在 LINE、Messenger 等 SCRM 管理的通訊平台上回覆客人，在串接分頁選一個你在 SCRM 有管理員權限的帳號就好，網址、金鑰都由系統自動設定。這篇說明需要什麼權限、一個 SCRM 帳號只能接一個 AI 的限制，以及怎麼改接與解除。 - [Telegram 串接：把 AI 接上 Telegram bot](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/telegram-integration.md): 貼上 BotFather 給的 bot token 就能讓 AI 在 Telegram 私訊裡回覆客人。這篇說明怎麼建 bot、支援哪些訊息，以及 Telegram 沒有真人客服時轉真人會發生什麼事。 - [Google Chat 串接：在自己的 Google Cloud 專案建 Chat app](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/google-chat-integration.md): 讓同事或客人在 Google Chat 私訊 AI。Chat app 建在你自己的 Google Cloud 專案，把 service account 金鑰交給 OakXgen，再把我們給的網址填回 Chat API 設定頁。這篇逐步說明，以及常見的錯誤訊息。 - [通用 Webhook 串接：請求格式、簽章與 callback](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/webhook-integration.md): 自家 App 或客服系統要接上 OakXgen 的 AI，走通用 Webhook：客人訊息連同對話歷史 POST 進來，AI 的回覆稍後 POST 到你的 callback URL。這篇是給工程師的完整格式說明。 - [對話 API：同步呼叫與逐字串流](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/api-conversation.md): 自家網站或 App 要直接跟 Skill agent 對話、做出打字機式的逐字回覆，用對話 API。這篇說明認證方式、請求格式、串流事件，以及跟通用 Webhook 怎麼選。 ### 知識庫 › 資料夾與上傳 - [資料夾怎麼建、怎麼找](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/folders.md): 知識庫裡的每一份文件都要放在一個資料夾底下，這篇說明資料夾怎麼新增、怎麼搜尋，以及資料夾旁邊那兩個數字代表什麼。 - [用哪種方式把文件放進知識庫](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/add-document-methods.md): 資料夾裡新增文件有三個入口：上傳檔案、匯入網站、寫入文件。這篇說明三者的差異，幫你在動手前就選對，而不是上傳完才發現該用別的方式。 - [上傳檔案：格式、切塊、圖片辨識](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/upload-file.md): 上傳檔案時要決定切塊長度與重疊長度，圖片會另外走 VLM 辨識、內容還能編輯。這篇說明這些欄位怎麼填，以及不同檔案類型上傳後可以改什麼、不能改什麼。 - [匯入網站怎麼用](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/import-website.md): 貼一個網址，系統會自動抓標題與正文，抓回來之後可以先編輯再存檔。這篇說明匯入流程，以及編輯已匯入文件時要注意什麼。 ### 知識庫 › 檢索與驗收 - [檔案狀態代表什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/file-status.md): 文件存進知識庫後會經過處理中、學習中才會變成已就緒，AI 只查得到已就緒的內容。這篇說明每個狀態的意思，以及為什麼試算表沒有這幾個狀態。 ### 工具庫 › Google Drive - [把 Google Drive 資料夾分享給服務帳號](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/gdrive-share-folder.md): 建立 Drive 連線前，要先把資料夾分享給一個固定的服務帳號 email。這篇說明怎麼分享、為什麼是這種做法，以及分享沒做好時會看到哪些錯誤訊息。 ### 工具庫 › MCP - [接上 MCP 伺服器（Notion、Linear 等）](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/mcp-connect.md): MCP 連線只要貼一個伺服器位址就能接上，不需要我們為每一家服務另外開發。這篇說明貼什麼網址、OAuth 授權怎麼走，以及探索不到工具時該看哪裡。 ### 工具庫 › 網站／爬蟲連線 - [幫網站建一個爬蟲連線](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/web-crawler-connection.md): 網站連線不是存一份網頁副本，而是讓 AI 需要的時候即時去抓，所以對方改了內容不會有過期問題。這篇說明探索範圍怎麼設，以及探索回來的頁面怎麼篩選要開放哪些。 ### 工具庫 › 資料庫 - [資料庫連線：範本 SQL 跟自由發揮怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/database-connection.md): 資料庫連線支援 MySQL、PostgreSQL、SQL Server，每個動作可以選「先寫好 SQL 讓模型填參數」或「讓模型自己寫 SQL」。這篇說明兩種模式的差異與為什麼預設用範本模式。 ### 工具庫 › 自訂 API - [接 REST API：憑證、預設 Header、動作怎麼填](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/http-connection.md): 自訂 API 連線只填一次主機位址與憑證，底下可以掛多個動作，每個動作是一支 API 呼叫。這篇說明驗證方式怎麼選、以及動作裡的路徑參數怎麼寫。 ### 工具庫 › 連線基礎知識 - [連線的共通觀念：類型鎖定、動作說明、存檔後為什麼會重測](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/connection-basics.md): 不管是 HTTP、資料庫、MCP、網站還是 Google Drive，連線頁有幾個共通的行為：類型建立後改不了、動作的說明欄位是寫給 AI 看的、存檔時系統可能自動重新測試一次。這篇把這些共通規則集中說明，各類型的專屬設定見各自的篇章。 ### 組織設定 › 使用者與角色 - [使用者管理：怎麼邀請成員、指派角色](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/user-management.md): 組織設定裡的使用者管理負責邀請與移除成員、指派角色。新成員預設是唯讀的檢視者，這篇說明邀請流程、角色怎麼換，以及為什麼刪不掉最後一個管理員。 - [角色與權限：系統範本跟自訂角色怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/roles-and-permissions.md): 每個組織內建 5 種系統範本角色（管理員、編輯、內容維護、檢視者、稽核），權限不夠用時可以自己建立角色、逐項勾選能力。這篇說明範本角色怎麼分工，以及勾選能力時的連帶關係。 ### 組織設定 › AI 引擎 - [AI 引擎設定：怎麼設定組織自己的模型與 API 金鑰](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/ai-engine.md): 組織可以設定自己的 AI 引擎（OpenAI、Anthropic 或 NCHC），取代系統預設模型。這篇說明怎麼新增設定，以及「系統 AI」這個開關實際是做什麼用的。 ### 對話 › 建立與管理 - [怎麼新增、切換、找回對話](https://docs.oakxgen.ai/zh-Hant-TW/guide/chats/manage-conversations.md): 對話頁面是拿建好的 agent 直接聊測試用的地方。這篇說明怎麼開新對話、換 agent、找回舊紀錄。 ### 對話 › 驗證與除錯 - [怎麼從一則回覆確認 AI 真的查到了什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/chats/verify-ai-answers.md): 每則 AI 回覆下面可能帶著「參考」清單，這篇說明那是什麼、什麼時候不會出現、代表什麼意思。 ### AI 代理 › 建立與選型 - [Channel 還是 Skill？兩種 agent 怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/agent-types.md): 建立 agent 時只會看到這兩種類型可選，這篇說明兩者的差異，幫你在建立當下就選對。 - [用範本快速建立 agent，還是從空白開始](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/templates.md): 選完類型後可以套用範本，範本只是預填的起始值，套用後角色設定、場景都還能整包改。這篇列出目前有哪些範本。 ### AI 代理 › Channel（SCRM／通訊平台） - [三種場景類型：諮詢查詢／表單流程／固定回覆，怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-types.md): 新增場景的第一步是選類型，三種類型的資料結構完全不同，選錯了要刪掉重建，不能中途切換。這篇說明三者的差異，以及怎麼用 AI 幫你把場景說明跟例句寫出草稿。 - [場景說明要怎麼寫，AI 才分得對](https://docs.oakxgen.ai/zh-Hant-TW/guide/scenarios/routing-description.md): 決定客人的問題會進到哪個場景的，主要是「場景說明」而不是例句。這篇說明兩者的分工、常見的寫法錯誤，以及為什麼多寫例句沒有用。 - [表單場景：欄位、選項、完成後怎麼收尾](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-form.md): 表單場景要設定收集哪些欄位、每個欄位要不要給預設選項、以及填完之後要送出什麼訊息、要不要轉真人。這篇說明這幾個設定的細節。 - [諮詢查詢場景：資料來源與工具範圍怎麼縮小](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-qa-scope.md): 諮詢查詢場景可以把資料夾與工具的範圍縮小到只給這個場景用，三選一是全部、自選、不使用。這篇說明三者的差異，以及跟 agent 本身資料來源設定的關係。 - [諮詢查詢的兩個進階回覆格式：卡片輪播、AI 建議選項](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-qa-formats.md): 諮詢查詢場景可以額外開啟卡片輪播與 AI 建議選項兩種回覆格式，各自有一個「什麼時候該用」的條件說明欄位。這篇說明兩者的用途與怎麼寫觸發條件。 - [固定回覆場景與快速回覆按鈕](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scenario-template-quickreply.md): 固定回覆場景可以設定多則一字不改照發的訊息，諮詢查詢與固定回覆都可以另外加快速回覆按鈕。這篇說明兩者怎麼設定，以及 LINE 平台的數量與字數限制。 - [服務時間與回覆節奏怎麼設](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/service-hours-pacing.md): 服務時間決定 AI 什麼時候該回話，回覆節奏決定收到訊息後多快回。這篇說明服務時間的三種模式（尤其是容易搞混的「時段外」），以及等待與載入動畫怎麼設。 - [說話方式：語氣、表情符號、訊息長度、禁用詞](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/voice-tone.md): 語氣分頁的「說話方式」區塊控制 AI 回覆的用字風格、長度與底線，這篇逐一說明每個欄位的作用範圍。 - [轉真人怎麼觸發](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/handoff.md): 轉真人分頁控制什麼情況下把對話交給真人接手，有關鍵字、情緒偵測、連續答不出來三種觸發條件，這篇逐一說明。 - [主動追問：等待時間與話術](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/follow-up.md): 主動追問讓 AI 在客人沒回覆一段時間後主動送一句話拉回來，最多可以設 3 道追問，各自有自己的等待時間與話術。這篇說明怎麼設，以及跟服務時間互相打架時會發生什麼事。 ### AI 代理 › Skill - [資料來源怎麼設](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-sources.md): Skill agent 能掛四種資料來源：資料夾、指定檔案、試算表、網頁搜尋，這篇說明各自的用途與什麼時候該選哪一種。 - [用試算表當資料來源要注意什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-source-spreadsheet.md): 試算表要分享給另一個服務帳號才讀得到，跟 Google Drive 連線用的不是同一個帳號，這篇說明怎麼分享以及常見的搞混點。 - [網頁搜尋資料來源的參數是什麼意思](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/data-source-web-search.md): 網頁搜尋資料來源有五個可調參數：關鍵字前綴、網域白名單、時效性、天數、筆數。這篇逐一說明各自的用途。 - [怎麼幫 agent 掛工具庫的動作](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/actions.md): 工具庫裡設定好的連線與動作，要在 agent 編輯畫面另外掛上才會生效。這篇說明怎麼挑動作、為什麼有些動作選不到，以及同名動作怎麼分辨。 ### AI 代理 › 串接 - [SCRM 串接：選帳號就自動接好](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/scrm-integration.md): 要讓 AI 在 LINE、Messenger 等 SCRM 管理的通訊平台上回覆客人，在串接分頁選一個你在 SCRM 有管理員權限的帳號就好，網址、金鑰都由系統自動設定。這篇說明需要什麼權限、一個 SCRM 帳號只能接一個 AI 的限制，以及怎麼改接與解除。 - [Telegram 串接：把 AI 接上 Telegram bot](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/telegram-integration.md): 貼上 BotFather 給的 bot token 就能讓 AI 在 Telegram 私訊裡回覆客人。這篇說明怎麼建 bot、支援哪些訊息，以及 Telegram 沒有真人客服時轉真人會發生什麼事。 - [Google Chat 串接：在自己的 Google Cloud 專案建 Chat app](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/google-chat-integration.md): 讓同事或客人在 Google Chat 私訊 AI。Chat app 建在你自己的 Google Cloud 專案，把 service account 金鑰交給 OakXgen，再把我們給的網址填回 Chat API 設定頁。這篇逐步說明，以及常見的錯誤訊息。 - [通用 Webhook 串接：請求格式、簽章與 callback](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/webhook-integration.md): 自家 App 或客服系統要接上 OakXgen 的 AI，走通用 Webhook：客人訊息連同對話歷史 POST 進來，AI 的回覆稍後 POST 到你的 callback URL。這篇是給工程師的完整格式說明。 - [對話 API：同步呼叫與逐字串流](https://docs.oakxgen.ai/zh-Hant-TW/guide/agents/api-conversation.md): 自家網站或 App 要直接跟 Skill agent 對話、做出打字機式的逐字回覆，用對話 API。這篇說明認證方式、請求格式、串流事件，以及跟通用 Webhook 怎麼選。 ### 知識庫 › 資料夾與上傳 - [資料夾怎麼建、怎麼找](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/folders.md): 知識庫裡的每一份文件都要放在一個資料夾底下，這篇說明資料夾怎麼新增、怎麼搜尋，以及資料夾旁邊那兩個數字代表什麼。 - [用哪種方式把文件放進知識庫](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/add-document-methods.md): 資料夾裡新增文件有三個入口：上傳檔案、匯入網站、寫入文件。這篇說明三者的差異，幫你在動手前就選對，而不是上傳完才發現該用別的方式。 - [上傳檔案：格式、切塊、圖片辨識](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/upload-file.md): 上傳檔案時要決定切塊長度與重疊長度，圖片會另外走 VLM 辨識、內容還能編輯。這篇說明這些欄位怎麼填，以及不同檔案類型上傳後可以改什麼、不能改什麼。 - [匯入網站怎麼用](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/import-website.md): 貼一個網址，系統會自動抓標題與正文，抓回來之後可以先編輯再存檔。這篇說明匯入流程，以及編輯已匯入文件時要注意什麼。 ### 知識庫 › 檢索與驗收 - [檔案狀態代表什麼](https://docs.oakxgen.ai/zh-Hant-TW/guide/knowledge/file-status.md): 文件存進知識庫後會經過處理中、學習中才會變成已就緒，AI 只查得到已就緒的內容。這篇說明每個狀態的意思，以及為什麼試算表沒有這幾個狀態。 ### 工具庫 › Google Drive - [把 Google Drive 資料夾分享給服務帳號](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/gdrive-share-folder.md): 建立 Drive 連線前，要先把資料夾分享給一個固定的服務帳號 email。這篇說明怎麼分享、為什麼是這種做法，以及分享沒做好時會看到哪些錯誤訊息。 ### 工具庫 › MCP - [接上 MCP 伺服器（Notion、Linear 等）](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/mcp-connect.md): MCP 連線只要貼一個伺服器位址就能接上，不需要我們為每一家服務另外開發。這篇說明貼什麼網址、OAuth 授權怎麼走，以及探索不到工具時該看哪裡。 ### 工具庫 › 網站／爬蟲連線 - [幫網站建一個爬蟲連線](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/web-crawler-connection.md): 網站連線不是存一份網頁副本，而是讓 AI 需要的時候即時去抓，所以對方改了內容不會有過期問題。這篇說明探索範圍怎麼設，以及探索回來的頁面怎麼篩選要開放哪些。 ### 工具庫 › 資料庫 - [資料庫連線：範本 SQL 跟自由發揮怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/database-connection.md): 資料庫連線支援 MySQL、PostgreSQL、SQL Server，每個動作可以選「先寫好 SQL 讓模型填參數」或「讓模型自己寫 SQL」。這篇說明兩種模式的差異與為什麼預設用範本模式。 ### 工具庫 › 自訂 API - [接 REST API：憑證、預設 Header、動作怎麼填](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/http-connection.md): 自訂 API 連線只填一次主機位址與憑證，底下可以掛多個動作，每個動作是一支 API 呼叫。這篇說明驗證方式怎麼選、以及動作裡的路徑參數怎麼寫。 ### 工具庫 › 連線基礎知識 - [連線的共通觀念：類型鎖定、動作說明、存檔後為什麼會重測](https://docs.oakxgen.ai/zh-Hant-TW/guide/connections/connection-basics.md): 不管是 HTTP、資料庫、MCP、網站還是 Google Drive，連線頁有幾個共通的行為：類型建立後改不了、動作的說明欄位是寫給 AI 看的、存檔時系統可能自動重新測試一次。這篇把這些共通規則集中說明，各類型的專屬設定見各自的篇章。 ### 組織設定 › 使用者與角色 - [使用者管理：怎麼邀請成員、指派角色](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/user-management.md): 組織設定裡的使用者管理負責邀請與移除成員、指派角色。新成員預設是唯讀的檢視者，這篇說明邀請流程、角色怎麼換，以及為什麼刪不掉最後一個管理員。 - [角色與權限：系統範本跟自訂角色怎麼選](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/roles-and-permissions.md): 每個組織內建 5 種系統範本角色（管理員、編輯、內容維護、檢視者、稽核），權限不夠用時可以自己建立角色、逐項勾選能力。這篇說明範本角色怎麼分工，以及勾選能力時的連帶關係。 ### 組織設定 › AI 引擎 - [AI 引擎設定：怎麼設定組織自己的模型與 API 金鑰](https://docs.oakxgen.ai/zh-Hant-TW/guide/settings/ai-engine.md): 組織可以設定自己的 AI 引擎（OpenAI、Anthropic 或 NCHC），取代系統預設模型。這篇說明怎麼新增設定，以及「系統 AI」這個開關實際是做什麼用的。 ### 問題導向文章 - [LINE 官方帳號的客服 AI 要怎麼接上自己的知識庫](https://docs.oakxgen.ai/zh-Hant-TW/article/line-ai-customer-service-knowledge-base.md): LINE 官方帳號常見的自動回覆多半只是關鍵字比對，換個問法就答不出來。這篇說明怎麼讓 LINE 客服 AI 真的讀公司自己的資料回答問題，以及串接 LINE 為什麼現在只要選帳號、不用自己架 webhook。 - [Google Drive 知識庫要怎麼保持更新，不用每次手動同步](https://docs.oakxgen.ai/zh-Hant-TW/article/gdrive-knowledge-base-stay-updated.md): 把 Drive 文件當客服 AI 的知識庫，最怕的是文件改了、AI 卻還在講舊版價目表。這篇說明為什麼 OakXgen 的 Drive 連線不用手動同步，以及員工帳號異動為什麼不會讓知識庫斷掉。 - [AI 客服怎麼保證只回答公司自己的資料，不會亂編答案唬弄客人](https://docs.oakxgen.ai/zh-Hant-TW/article/ai-customer-service-answer-scope.md): 導入 AI 客服前最常見的疑慮就是「會不會亂講」。這篇說明 OakXgen 怎麼用知識庫檢索加上可驗證的參考來源降低亂答風險，以及怎麼在場景層級再縮小一次查詢範圍。 - [網站客服機器人要怎麼即時查詢訂單狀態，不是每次都要人工查系統](https://docs.oakxgen.ai/zh-Hant-TW/article/website-chatbot-order-status-lookup.md): FAQ 型機器人只能回答固定文字，查不了「我的訂單到哪了」這種需要即時資料的問題。這篇說明怎麼讓客服 AI 直接呼叫公司自己的訂單 API 或資料庫，查到真實資料再回答。 - [客服機器人什麼時候該自動轉真人，怎麼設定不會該轉的時候不轉](https://docs.oakxgen.ai/zh-Hant-TW/article/chatbot-handoff-to-human-timing.md): 導入客服 AI 最怕兩種極端：該轉真人的時候卡住不轉，或是動不動就轉真人讓 AI 形同虛設。這篇說明可以組合的三種轉真人觸發條件，以及不同通訊平台轉真人時實際會發生什麼事。 - [一個客服 AI 要同時顧 LINE、Telegram、Google Chat，需要重做三個機器人嗎](https://docs.oakxgen.ai/zh-Hant-TW/article/multi-channel-chatbot-one-agent.md): 品牌常常同時經營好幾個通訊平台，卻擔心每個平台都要重新設定一次邏輯。這篇說明 OakXgen 怎麼讓同一顆 agent 同時串接多個渠道，以及語氣設定為什麼是統一的，不是每個渠道各自一份。 - [要串 Notion、Linear 這類工具當 AI 客服的資料來源，需要自己開發串接嗎](https://docs.oakxgen.ai/zh-Hant-TW/article/mcp-tool-integration-no-custom-dev.md): 公司內部常把規則、SOP 寫在 Notion，或用 Linear 追蹤客訴工單，想讓 AI 客服直接查這些工具卻擔心要自己開發一套串接。這篇說明 MCP 這個公開協定怎麼讓貼一個網址就能接上，不需要為每一家服務另外開發。 - [客服機器人要怎麼收集客人資料辦預約，不會因為問法不對就答錯格式](https://docs.oakxgen.ai/zh-Hant-TW/article/chatbot-booking-form-collection.md): 診所、餐廳、代銷這類需要收集姓名、電話、日期辦預約的商家，最怕客人亂打格式讓後續作業出錯。這篇說明表單型場景怎麼用快速回覆選項降低出錯機率，以及收集完成後怎麼自動轉真人跟進。