輸入您的帳號與密碼登入，即可開始使用。
「忘記密碼？」 重新設定。
## 1. 點選忘記密碼按鈕 「重置密碼」 按鈕 MaiGPT 六大功能模組全景圖
MaiGPT vs Agent Builder：定位、對象、用途與操作方式一覽
點擊上方模型名稱，展開選單切換 AI 模型
選擇知識庫後提問，AI 會使用 query_files 工具搜尋知識庫並回覆結果
AI 使用 Web Search Tool 搜尋網路資料後，整理回覆並附上來源
⋮ 選單
3. 選擇 釘選
將滑鼠移到對話上，點 ⋮ 選單即可看到「釘選」
已釘選 區塊，並在標題旁顯示 📌 圖示。
已釘選的對話集中在最上方的「已釘選」區塊，一般對話依時間排序於其下
⋮ 選單，選擇 取消釘選 ，對話就會回到下方一般的時間分組。
### 排序與規則 左側為對話區，右側為 Canvas 編輯區
請 AI 撰寫公告，Canvas 自動開啟並呈現完整文件內容
AI 在 Canvas 中產出的視覺化圖表
輸入研究主題後，點擊藍色的「深度研究」按鈕即可開始
研究完成後，報告會自動顯示在 Canvas 中
輸入文字描述，AI 即時生成對應圖片
在對話中指示修改方向，AI 會生成新版本的圖片
點擊「連接器」按鈕即可看到可用的連接器清單
Agent Builder 模組全景圖
Agent 核心運作流程：LLM 驅動 × 角色指令 × 記憶
知識庫 RAG 流程：從文件上傳到 Agent 查閱回覆
Text to SQL：自然語言 → SQL 查詢 → 白話回覆
代理排程：定時觸發 → Agent 自動執行 → 結果傳送
AI 功能 → 代理排程 。進入後會看到排程列表：
代理排程列表頁，顯示所有排程的狀態、類型、傳遞方式與上次執行時間
新增排程 按鈕開啟表單。表單分為四個分頁：**基本資訊**、**提示詞**、**排程設定**、**傳遞設定**。
### 2. 填寫基本資訊 基本資訊分頁：選擇 AI 助理、命名、決定執行模式與對話平台
提示詞分頁：描述 Agent 每次執行要完成的任務
Cron 模式：使用標準 5 欄位 Cron 表達式精確設定時間
間隔模式：天、時、分、秒四欄位組合
單次執行：選擇特定日期時間，執行完畢後排程結束
傳遞設定：可設定多個對話目標與多個 Webhook URL
執行紀錄 頁，只是不會主動 push 到別的地方。
{% endhint %}
#### 對話 新增對話 從選單中挑選對話，結果會以機器人訊息的形式送出。可加入多個對話。
#### Webhook 新增 Webhook URL ，結果會以 POST 請求送到你的外部 URL（需以 `http://` 或 `https://` 開頭）。常用於：
* 串接 Slack / Discord / LINE
* 寫入自家系統做進一步處理
* 觸發其他自動化流程
{% hint style="warning" %}
沒設傳遞目標也沒關係，執行結果一定會留在執行紀錄 頁。但如果想讓團隊／同事被動收到結果（例如推到 Slack），就要至少設定一個對話或 Webhook，否則沒人會被通知。
{% endhint %}
### 6. 儲存並啟用 確認 儲存。若「啟用」開關為開啟狀態，排程會立即開始依設定的時間觸發。
## 儲存後會發生什麼？ 客服對話 列表）
3. **等排程觸發**
* **Cron / 間隔**：依設定的時間自動執行，例如 Cron `0 9 * * 1-5` 會在下一個週一至週五的 9:00 觸發
* **單次執行**：到設定的那個時間點執行一次
* 不想等？點列表中的 ▶️ 立即執行 按鈕，可以立刻觸發一次做測試
4. **執行過程**
* 列表中的狀態會保持「啟用中」，「上次執行」欄位會隨每次執行更新時間
* 每一次執行都會在執行紀錄 頁產生一筆紀錄（含完整 Agent 回覆）
* 若你在「傳遞設定」加了對話或 Webhook，結果同時會送到那些目標
* 詳細查看方式請見下方〈[結果會跑到哪裡？](#where-results-go)〉
5. **任務結束時**
* 達到「最大執行次數」上限 → 自動切換為「已暫停」，不再觸發
* 單次執行完成 → 排程保留在列表中但不再觸發
## 結果會跑到哪裡？ 代理排程 列表 → 在該排程那一列點 🕘 查看執行紀錄 → 進入執行歷史頁 → 點某筆紀錄右側的 👁 查看詳情
**會看到：**
* 執行狀態（成功 / 失敗 / 部分成功）
* 開始時間、完成時間
* Agent 完整回覆內容（即使後續傳遞失敗，內容仍保留在這）
* 失敗時的錯誤訊息
### 2. 你指定的對話（傳遞設定中加入的對話） 客服對話 → 進入你在傳遞設定中加入的那個對話 → 訊息會在最新位置。
### 3. Webhook URL（傳遞設定中加入的 URL） **客服對話** **列表中**——它是系統內部使用的容器，不是給人類客服處理的對話。要看歷史結果請走執行紀錄 。
{% endhint %}
## 完整範例：每日客服摘要 代理排程 → 點該排程的 🕘 → 點 👁 → 看完整機器人回覆與 token 使用量
* **Slack**：直接到 #customer-support 頻道（這是你設定的 Webhook 接收端）
4. **週二、週三… 持續執行**：每個工作日早上 9:00 自動觸發，不再需要人為介入
### 如果有問題要怎麼排查？ 執行紀錄頁：依狀態、日期範圍篩選，並查看每次執行的結果
執行詳情：狀態、開始/完成時間、完整機器人回覆與錯誤訊息
排程為什麼沒有觸發？
可能原因：
1. 排程狀態為「已暫停」——到列表確認狀態欄
2. 已達「最大執行次數」上限——會自動暫停
3. Cron 表達式或時區設定錯誤——到編輯頁檢查
4. 單次執行模式已執行過——單次執行只會觸發一次
建議先用「立即執行」測試，確認排程本身可正確執行，再排查時間設定。
為什麼選不到我的 AI 助理？
代理排程**只支援 Agent 模式**的 AI 助理。若你的助理是 Chatbot 模式或其他模式，不會出現在選單中。請到 AI 助理設定頁確認模式後再來建立排程。
排程跑完，要去哪裡看 Agent 產生了什麼？
主要入口是代理排程 → 點該排程的 🕘 查看執行紀錄 → 點某筆紀錄的 👁。詳情會顯示 Agent 完整回覆。
如果有設定傳遞目標（對話／Webhook），也會送一份過去：
* 指定的對話：直接進那個對話看訊息
* Webhook：到你的外部接收端看 POST body
「儲存結果至上下文」開了之後，我去哪看那個對話？
**這個開關不影響你能不能看到結果**——所有歷次回覆永遠保留在執行紀錄頁。
它只影響「Agent 下次執行時記不記得上次發生什麼」：
* 開啟（預設）：Agent 在後端會用同一個對話容器累積記憶，下次執行能延續上下文
* 關閉：每次都不留訊息，效果類似獨立模式
這個後端對話容器目前不會出現在客服對話 列表，是系統內部使用的，不是給人類客服處理的。
Webhook 收到的資料格式是什麼？
POST 請求，Content-Type 為 `application/json`，body 結構：
```json
{
"content": "Agent 產生的完整回覆內容（純文字）"
}
```
逾時 30 秒，不重試。Webhook 端應在 30 秒內回應 2xx 狀態碼，否則該次傳遞會記錄為失敗（但執行紀錄頁仍會保留 Agent 完整回覆）。
獨立模式 vs 上下文模式，差別到底在哪？
兩者最大差別在 **Agent 執行時看不看得到上次的對話歷史**：
* **上下文模式**：用同一個後端對話累積訊息。Agent 下次執行時，能看到歷次的提示詞與回覆，可以延續判斷（適合需要追蹤趨勢、避免重複、累積上下文的任務）
* **獨立模式**：每次建臨時對話，執行完立即刪除。Agent 每次都從零開始，不知道之前發生過什麼（適合每天獨立輸出的任務，例如每日報告）
兩種模式的執行結果**都會保存在執行紀錄頁**——差別不在「能不能查歷史」，而在「Agent 工作時帶不帶記憶」。
## 延伸閱讀 工具：Agent 透過 Function Calling 呼叫外部服務
技能：定義多步驟 SOP，Agent 按流程引導對話
爬蟲：自動抓取網頁內容，匯入知識庫
情境 → 模組對照：快速找到正確的起點
產業 應用場景 電商零售 智慧客服、導購推薦、退貨流程處理 金融保險 保單諮詢、理財推薦、風險問答 教育 課程助教、學習診斷、語言練習 醫療 健康諮詢、預約掛號、病患教育輔助 政府機關 公共服務查詢、政策問答、民意回饋 製造業 內部知識管理、維修操作指引 旅遊觀光 行程推薦、導覽、即時問答支援
## MaiAgent AI 助理設定四階段 AI 功能 」中「AI 助理 」，點選右上方的 「+建立AI助理 」。
AI 助理名稱 」 欄位，填寫 AI 助理的名稱。可以針對這位 AI 助理的主要任務來命名，例如 XX AI 客服， XX 法規查詢小幫手，XX 專案智慧助理。
一個帳號可建立多個 AI 助理 （依購買方案內容有數量上的限制）
RAG 設定 」 頁籤，在 「RAG 」 下拉式選單當中，挑選不同的 RAG（Retrieval-Augmented Generation，檢索增強生成）。如無特殊需求，預設為 MaiAgent RAG 。
回答模式設定 」 頁籤
2. 在 「角色指令 」 欄位中，輸入以下指令：
```
請優先使用faq的內容回答使用者問題
```
基本設定 」 頁籤，在 「LLM 模型 」 下拉式選單當中，可以挑選不同的大型語言模型，如無特殊需求，預設為 Claude 4.5 Haiku 。
「回答模式」 頁籤，從自由對話到高度結構化回應，滿足各式業務需求。每種模式各有特色與適用範圍，您可以依照實際使用情境靈活選擇。
回答模式設定 」 頁籤，回答模式選擇 「一般（預設）」 ，於 「角色指令 」 欄位，填寫您為該 AI 助理訂定的角色指令。輸出格式，可選擇輸出純文字或 JSON 格式作使用。
**回答模式：模板** 」，您的 AI 助理的幻覺回覆機率將降低到零，因為 AI 助理將嚴格地依照您建立的知識庫和 FAQ 回覆內容問題，改成以分類的原則回覆問題，而不是以生成的方式請 LLM 生成內容。使用模板系統來生成回答，保證 100 % 無幻覺。
**適用情境**
需要統一回答格式的情境，如標準諮詢流程、報表等。
**案例操作**
假如您希望建立一個「台南市政 1999」 的 客服 AI 助理，以即時回應民眾市政相關問題。
**1. 選擇 「****回答模式設定** **」 頁籤，回答模式選擇 ****「模板」**
**初始化回覆模板** 」，您就會看到系統依據您剛剛上傳到知識庫的文件，產生回覆範例。
**無法回覆模板** 」 回覆。
最後按下 「**儲存** 」 按鈕即可。
**「工作流」** 作為回覆模式。\
此模式適用於特定任務導向的應用情境，如：
* **知識管理**：協助彙整、調閱或維護內部知識資料
* **資訊摘要**：快速整理文件重點或會議記錄
* **企劃寫作**：協助發想創意、撰寫提案草稿等
請根據實際業務需求，選擇對應的工作流程模組，讓 AI 助理在特定任務中發揮最大效益。
**即時查詢、資料洞察** 的情境，例如報表分析、營運指標追蹤、數據查詢等。讓非技術使用者也能輕鬆獲取數據，實現更直覺、更高效的資料驅動決策流程。
**Text to SQL 操作流程**
1. 前往 「回答模式設定」 頁籤，並選擇 **「Agent」** 作為回覆模式
**「Agent」** 作為回覆模式
權限設定 」 頁籤，可以設定助理預先需要被分配到給哪些成員進行訪問，預設為全選加入至所有角色，可根據使用情境修改設定。
確認 」 按鈕即可完成設定 🎉。
# 角色指令設計指南
{% hint style="info" %}
您可以使用 MaiAgent 製作的 [生成角色指令的 AI 工具](https://chat.maiagent.ai/web-chats/4b67b140-db5f-40dc-bce3-f2217e9574bd) 協助您完善您的角色指令
{% endhint %}
## 🎭 什麼是「角色指令」？ 85 分以上 ✅
|
| **回答相關性評分** | AI 有沒有回答客戶真正想問的問題 | 85 分以上 ✅
|
| **上下文精確度評分** | AI 有沒有找對參考資料，是否精準針對上下文 | 85 分以上 ✅
|
***
#### 簡易判斷法 AI 助理 」
2. 選擇要設定的 AI 助理
3. 點選「設定 」按鈕
4. 切換至「進階設定 」頁籤
#### 調整 Token 上限 使用模型最大值 」：直接套用所選模型支援的最大輸出 Token 數（預設）
* 「自訂數量 」：自行指定上限
2. **輸入自訂數值（選擇「自訂數量」時）**
* 在數字輸入框輸入目標數值
* 可輸入範圍依所選模型而定，畫面會即時顯示該模型允許的範圍（如下圖的「範圍：512 - 64000 tokens」）
3. **儲存設定**
* 點選「儲存 」按鈕
* 設定立即生效,無需重啟 AI 助理
AI 助理進階設定頁面：可選擇「使用模型最大值」或「自訂數量」來控制輸出 Token 上限
應用情境 建議 Token 數 說明 簡短問答 256 - 512 適合快速回答,如 FAQ 機器人 一般客服 512 - 1024 平衡詳細度與成本 專業諮詢 1024 - 2048 提供詳細說明與解決方案 內容生成 2048 - 4096 生成長篇文章或報告 程式碼生成 1024 - 2048 產生完整的程式碼片段
***
### 應用情境範例 設定 」頁的「使用分析 」分頁,可依日期區間查看「對話字數 」「對話次數」「訊息次數」「平均對話互動次數」「使用者滿意度」等趨勢圖。其中「對話字數」為該助理累計產生的字數,字數與 Token 數量呈正相關,可作為 Token 消耗的參考依據。
AI 助理「使用分析」分頁：可依日期區間查看對話字數、對話次數、訊息次數、平均對話互動次數與使用者滿意度等趨勢圖
知識庫運作示意圖
AI 功能 」 → 「知識庫 」
2. 點選要上傳的知識庫（若尚未建立，請先參考 [如何建立知識庫：基本設置](/km/km-basic-settings)）
3. 在知識庫頁面右上方點選 「上傳檔案 」 藍色按鈕，上傳您想讓 AI 助理知道的資料
{% hint style="info" %}
* 根據不同的方案會提供不同大小的知識庫容量
* 如果您的檔案較大或資料量較多，上傳後系統可能需要一些時間處理。
{% endhint %}
處理狀態 」 欄位中檢視處理進度。
編輯 」
2. 查看分段內容，點擊要查看的片段
畫面會以 Markdown 格式顯示此片段的完整內容。
#### 編輯原始文件 檢視文件 」
儲存 」即可保存您的編輯結果。
{% hint style="info" %}
**資料管理提醒**
* 建議在編輯前先備份重要內容
* 編輯原始文件後，系統會重新進行片段分割
{% endhint %}
# 如何建立知識庫：基本設置
## 基本設置 逐字稿檢視畫面
下載逐字稿（支援 TXT 與 SRT 格式）
退貨政策 」的知識庫設定下，一次關聯以上兩個 AI 助理：
關聯多個 AI 助理示意圖
退貨政策 」的知識庫，根據同樣的內容進行回答，後續維護只需要**更新一個知識庫**就能保證 AI 助理使用最新資料。
#### 一個 AI 助理使用多個知識庫 AI 功能 」 → 「爬蟲 」，點選右上方的 「+建立頁面爬取請求 」 按鈕。
2. 輸入網址
輸入您要爬取頁面的網址，並按下 \[確認 ] 按鈕。
{% hint style="warning" %}
* 請注意，網址不可超過 200 字
* 若狀態一直未改變，可以按右上角重新整理頁面更新狀態
{% endhint %}
3. 檢視爬蟲資料
當狀態顯示完成後，點入右方的「匯入」，檢視爬完的資料條目。
4. 選取資料
勾選左方的方塊，選擇您想要匯入知識庫的資料。勾選完畢後再按下 「匯入 」 按鈕，資料將會自動匯入到該 AI 助理的知識庫。
{% hint style="info" %}
如想在同一個頁面瀏覽更多資料條目，可點選右下方的 「10條/頁 」來擴大瀏覽範圍。
{% endhint %}
在知識庫中就可以看到以 .md 檔呈現的資料，和一般資料一樣可以進行標籤、元資料的設定。
AI 功能 」 → 「知識庫 」，點選要建立 FAQ 常見問題的知識庫（若尚未建立，請先參考 [如何建立知識庫：基本設置](/km/km-basic-settings)）。
### 新增問答內容 FAQ 常見問題 」頁籤，點選右上方的 「+建立 FAQ 」 藍色按鈕，開始新增問答內容。
答案格式示意圖
確認 」，FAQ 就建立完成，AI 助理就能夠在回答時參考您提供的回答：
答案預覽畫面
點選插入/編輯媒體
鍵入連結示意圖
媒體插入預覽
確定 」
加入後的標籤就會出現在 FAQ 欄位中
非會員 」及「教學 」標籤的文件讓 AI 助理使用。
如圖：篩選後 AI 助理僅能使用初級露營的文件，避免透露不相關的訊息給非會員對話使用。
新增元資料 」鍵，加入剛剛輸入的鍵值對應關係(可以一次加入多個元資料)。
查看引用節點
查看原始檔案位置
文件 頁籤中，點擊要翻譯的 PDF 檔案，進入文件詳情頁面。
PDF 文件詳情頁，右上角可見「翻譯 PDF」按鈕
翻譯 PDF 按鈕。若該檔案已有翻譯紀錄，會先顯示翻譯結果彈窗，可點擊 再次翻譯 開啟設定；若為首次翻譯，則直接開啟翻譯設定彈窗。
翻譯設定彈窗
確認 後，系統會在背景執行翻譯任務。翻譯過程中狀態會即時更新，完成後會自動顯示結果。
***
## 查看翻譯結果 翻譯 PDF 按鈕即可開啟翻譯結果彈窗，包含三個頁籤：
### 結果預覽 翻譯結果 — 雙語對照版 PDF 預覽
下載檔案 — 支援三種格式
處理詳情 — Token 消耗與時間統計
選擇翻譯版本 下拉選單中，可切換不同版本查看結果。版本格式為：`日期 | 來源語言 → 目標語言 | 使用模型`。
如需再次翻譯，點擊 再次翻譯 按鈕即可開啟新的翻譯設定。
# 搜尋測試
在 LLM 正式上線前，可以先透過搜尋測試預覽功能，確認 LLM 所搜尋到的資料相關性與內容
## 為什麼需要搜尋測試？ 初級露營.pdf 」這個檔案，這時就能檢查「初級露營.pdf 」的檔案內容是否都正確，並在**正式上線前**即時更新。
## 依 Metadata 搜尋測試 聽懂人話 」並直接操作資料庫。
{% hint style="info" %}
欲了解更多 Text2SQL 內容，請見：[技術人員手冊—Text to SQL](https://docs.maiagent.ai/tech/advanced-genai-tech/text-to-sql)
{% endhint %}
想像你是便利商店老闆：
**傳統方式：**
* 你：「幫我查一下昨天賣了多少瓶可樂」
* 員工：「老闆，你要教我怎麼用收銀系統查詢...」
* 你：「點這裡、選那裡、輸入條件...」
需要手把手教學，較耗費時間。
**有了 Text2SQL：**
* 你：「幫我查一下昨天賣了多少瓶可樂」
* AI 員工：「好的！」💫 *(自動產出查詢方法並調用資料庫)* → 「昨天賣了87瓶可樂」✅
### **Text to SQL 的核心功能** AI 功能 」區塊，點擊「資料庫 」。頁面分為兩個頁籤：**MaiAgent 資料庫**與**外部資料庫**。
點選右上角的「新增資料庫 」按鈕開始建立。
資料庫管理頁面，顯示 MaiAgent 資料庫列表
步驟一：選擇資料庫類型
步驟二：MaiAgent 資料庫設定畫面
步驟二：外部資料庫（PostgreSQL）設定畫面
測試連線 」按鈕來驗證連線是否正常：
* **連線成功**：代表 MaiAgent 可以正常存取您的資料庫
* **連線失敗**：請檢查連線字串格式、網路連通性，以及資料庫是否允許外部連線
若您的資料庫包含大量資料表，可以在「指定資料表 」欄位中輸入要開放的資料表名稱（例如 `customers, orders, products`），以提升查詢效率及安全性。
### 4. 設定群組權限 建立 」按鈕。建立成功後會進入資料庫設定頁面，可以進行後續操作。
{% hint style="info" %}
建立完成後，別忘了將資料庫**關聯至 AI 助理**，AI 助理才能使用這個資料庫進行查詢。請參考：[關聯 AI 助理與群組權限](/database/link-chatbots-groups)
{% endhint %}
## 上傳檔案建立資料表（MaiAgent 資料庫） 表格管理 」頁籤，點擊「上傳表格檔案 」按鈕。
表格管理頁籤，可上傳檔案建立資料表
表格管理 」頁籤中，點擊資料表的「編輯 」，可以編輯資料表描述與欄位描述。視窗中會顯示填寫進度（例如「3/10 個欄位已設定描述」）。
**外部資料庫**：在「基本資訊 」頁籤下方的資料表清單中，點擊展開資料表，直接在欄位描述欄中輸入說明。
### 撰寫建議 編輯 」即可進入設定頁面。
資料庫設定頁面：基本資訊頁籤
AI 功能 」>「資料庫 」
2. 點擊「新增資料庫 」
3. 選擇「MaiAgent 資料庫 」
4. 輸入資料庫名稱（例如「2024 年度銷售資料」），點擊建立
選擇 MaiAgent 資料庫並填寫名稱
表格管理 」頁籤
2. 點擊「上傳表格檔案 」
3. 拖曳或選取您的試算表檔案
在表格管理頁籤上傳檔案
成功 」，即代表資料表已建立完成。
{% hint style="warning" %}
支援格式：`.csv`、`.xlsx`、`.xls`、`.json`、`.jsonl`。Excel 檔案中每個工作表會各自建立一張資料表。
{% endhint %}
#### 表格格式注意事項 關聯 AI 助理 」頁籤
2. 從左側選取要關聯的 AI 助理，移至右側
3. 點擊「儲存 」
將資料庫關聯至 AI 助理
Agent 模式
2. 將 Agent 模式由一般模式改為**畫布模式(Canvas)**
關聯 AI 助理 」頁籤
2. 頁面左側顯示可選 AI 助理，右側顯示已關聯 AI 助理
3. 從左側選取要關聯的 AI 助理，點擊箭頭按鈕移至右側
4. 完成後點擊「儲存 」
關聯 AI 助理頁籤：左側為可選助理，右側為已關聯助理
群組權限 」頁籤
2. 使用穿梭元件，將要授權的群組從左側移至右側
3. 完成後點擊「儲存 」
{% hint style="info" %}
群組權限與「關聯 AI 助理」是獨立的設定。即使資料庫已關聯至某個 AI 助理，如果使用者所屬的群組沒有該資料庫的存取權限，使用者仍然無法查詢該資料庫。
{% endhint %}
### 權限層級 MCP 整合前後差異
一次開發，處處使用 」，大幅降低了 AI 助理工具生態系統的複雜度和維護成本。
## 快速建立 MCP 工具 AI 功能 」區塊，然後點擊「🔧 工具 」。進入工具列表頁面後，點選右上角的「➕ 新增工具 」按鈕。
點擊「➕ 新增工具」開始建立
MCP 。
Composio mcp for google calendar 。
設定 MCP 命令參數
設定 MCP 環境變數
允許的工具(JSON 數組) 」，點按重新取得 mcp 定義好的工具名稱
確認 」按鈕。您的新工具就建立完成了！
• 工具的網址
| • 只設定這個人的憑證
|
| **什麼時候用** | 第一次要接入新工具時 | 每個客戶要用不同憑證時 |
| **誰可以操作** | 有權限即可操作 | 有權限即可操作 |
| **在哪裡設定** | 工具管理頁面 | 聯絡人編輯頁面 |
| **常見用途** | • 新增一個查詢工具
| • 每個客戶用自己的帳密
|
#### 簡單理解：電腦教室比喻 API 流程示意圖
AI 功能 」區塊，然後點擊「🔧 工具 」。進入工具列表頁面後，點選右上角的「➕ 新增工具 」按鈕。
點擊「➕ 新增工具」開始建立
google calendar 。
工具名稱 」欄位。
* **用途**：此名稱是 AI 助理在內部呼叫和識別此工具時使用的唯一標識符。
* **命名規則 (重要)**：
* 必須使用英文。
* 只能包含：
* 小寫英文字母 (a-z)
* 大寫英文字母 (A-Z)
* 數字 (0-9)
* 底線 (`_`)
* 連字符 (`-`)
* **範例**：`get_weather_forecast`, `database-query-tool`
下圖設為 google\_calendar\_retriever
API 工具名稱定義
工具描述 」欄位中，用戶可以提供清晰且詳細的工具說明。
* **重要性**：良好的描述能幫助 AI 助理更準確地理解：
* 工具的功能和目的。
* 何時應該使用這個工具。
* 如何解釋工具的輸出結果。
* **建議內容**：說明工具做什麼、輸入什麼、輸出什麼，以及任何使用上的注意事項。
工具描述
信封 」，在看到實際的資料內容前，先告訴接收方一些重要的資訊，**沒有正確的標頭，API 請求可能無法通過驗證，或者接收方無法正確解析資料。**。
**常見用途**：
* 身份驗證 (`Authorization`, `X-API-Key`)
* 指定內容類型 (`Content-Type`)
* 指定接受的回應格式 (`Accept`)
若要新增標頭，您需要：
* 點擊「➕ 新增標頭 」來定義隨請求發送的 HTTP 標頭。
* **格式**：必須是有效的 JSON 物件，其中鍵 (Key) 是標頭名稱，值 (Value) 是標頭內容 (字串)。
* **範例**：
```json
{
"Content-Type": "application/json; charset=utf-8",
"Authorization": "Bearer {{SECRET_API_TOKEN}}",
"Accept": "application/vnd.github.v3+json"
}
```
設定必要的 HTTP 請求標頭
使用 JSON Schema 精確定義 API 參數
確認 」按鈕。您的新工具就建立完成了！
功能類型 說明 應用場景 文字生成圖片 根據文字描述生成對應的圖片 行銷素材、社群貼文、產品視覺化 參考圖片編輯 根據參考圖片進行風格轉換或內容修改 品牌視覺一致性、圖片風格調整 對話式圖片編輯 在多輪對話中持續調整與優化圖片 迭代設計、細節微調 中文提示詞支援 直接使用繁體中文描述想要的圖片 中文使用者無需翻譯即可使用
***
### 啟用 Gemini 3 圖片生成工具 AI 助理 」
* 選擇要設定的 AI 助理
* 點選「設定 」
從左側選單進入「AI 助理」，選擇要設定的助理並點選設定
工具 」頁籤
* 點選「選擇工具 」按鈕
* 在可用工具列表中找到「Nano Banana Pro 圖片生成 」並勾選
* 點選「確認 」
切換至「工具」頁籤，可看到已啟用的圖片生成工具
點選「選擇工具」後，在內建工具中找到「Nano Banana Pro 圖片生成」並勾選啟用
儲存 」按鈕
* 等待系統確認設定完成
{% hint style="warning" %}
**注意事項**
* 圖片生成會消耗 Token 額度，請注意方案限制
* 生成的圖片預設為 4K 高品質輸出
{% endhint %}
***
### 使用方式 在 MaiGPT 對話介面中使用圖片生成工具，AI 助理會根據描述生成對應的圖片
對話式編輯：使用者要求將購物袋改為粉紅色，AI 助理根據上下文記憶重新生成修改後的圖片
實際操作畫面：使用者輸入行銷素材需求，AI 助理即時生成含有櫻花與購物袋元素的春季宣傳圖片
實際操作畫面：AI 助理根據描述生成智慧手錶概念圖，包含圓形錶面、銀色金屬錶帶和深藍色錶盤
實際操作畫面：將台北 101 大樓轉換為日系動漫風格，保留建築主要輪廓並套用漫畫風格
Import data from CSV 」，並貼上以 Tab 分隔的文字檔案，向下捲動可以看到製作成表格的結果。匯入完成後按下「Save」
#### 主鍵 (Primary Key) 欄位名稱 主鍵 必填 說明 客戶編號 (CustomerID)✅ ✅ 客戶唯一識別碼 客戶名稱 (CustomerName)❌ ❌ 客戶公司或個人名稱 客戶類型 (CustomerType)❌ ❌ 客戶分類（如：零售商、餐廳、經銷商） 聯絡人姓名 (ContactName)❌ ❌ 主要聯絡人姓名 電話 (Phone)❌ ❌ 聯絡電話 Email❌ ❌ 電子郵件地址 地址 (Address)❌ ❌ 客戶地址 區域 (Region)❌ ❌ 地理區域（如：北部、南部） 客戶等級 (CustomerLevel)❌ ❌ 客戶重要性等級（A、B、C級）
**🔑 主鍵**: `客戶編號 (CustomerID)`\
**🔗 外鍵關聯**: 無
***
#### 📦 **2. Orders 表格（訂單資訊）** 欄位名稱 主鍵 必填 說明 訂單編號 (OrderID)✅ ✅ 訂單唯一識別碼 客戶編號 (CustomerID)❌ ❌ 關聯到 Customers 表格 訂單日期 (OrderDate)❌ ❌ 訂單建立日期 交貨日期 (DeliveryDate)❌ ❌ 預計或實際交貨日期 付款方式 (PaymentMethod)❌ ❌ 付款方式（現金、信用卡、匯款） 訂單狀態 (OrderStatus)❌ ❌ 訂單處理狀態 總金額 (TotalAmount)❌ ❌ 訂單總金額（數值型態） 運費 (ShippingFee)❌ ❌ 運送費用
**🔑 主鍵**: `訂單編號 (OrderID)`\
**🔗 外鍵關聯**:
* `客戶編號 (CustomerID)` → `Customers.客戶編號 (CustomerID)` ( Orders 的 CustomerID 對應 Customer 表格中的 CustomerID)
***
#### 🛍️ **3. Products 表格（商品資訊）** 欄位名稱 主鍵 必填 說明 產品編號 (ProductID)✅ ✅ 產品唯一識別碼 產品名稱 (ProductName)❌ ❌ 產品名稱 產品描述 (Description)❌ ❌ 產品詳細描述 產品類別 (Category)❌ ❌ 產品分類 品牌 (Brand)❌ ❌ 產品品牌 規格 (Size)❌ ❌ 產品規格或尺寸 成本 (Cost)❌ ❌ 產品成本（數值型態） 價格 (Price)❌ ❌ 產品售價（數值型態） 庫存量 (StockQuantity)❌ ❌ 目前庫存數量（數值型態）
**🔑 主鍵**: `產品編號 (ProductID)`\
**🔗 外鍵關聯**: 無
### 情境一：追蹤還沒完成的訂單 AI 功能 」區塊，然後點擊「AI 助理 」。這將顯示您帳戶中所有已建立的 AI 助理列表。
找到您想要配置工具的 AI 助理
編輯 」按鈕，進入該助理的詳細設定頁面。
進入特定 AI 助理的設定頁面
回答模式設定 」頁面選項。
* **檢查**：確認當前選擇的模式是否為「Agent 模式 」
* **更改**：如果當前不是 Agent 模式，請將其**切換**為 Agent 模式。
確保 AI 助理已設定為 Agent 模式才能使用工具
🔧 工具 」的頁面選項。
找到工具配置頁面
➕ 選擇工具 」按鈕，會開啟預先建置好的工具清單列表，並進行以下操作。
* **操作**：
1. 瀏覽列表，找到您希望此 AI 助理能夠使用的工具。
2. 勾選您想要啟用的工具旁邊的複選框。
3. 您可以根據 AI 助理的任務和需求，選擇任意數量的工具。
{% hint style="info" %}
您可以選擇 MaiAgent 內建工具或您自行定義之工具
{% endhint %}
直接勾選希望此 AI 助理使用的工具
確認已為 AI 助理配置了正確的工具
儲存 」按鈕，以保存您對 AI 助理設定所做的更改。
點擊「儲存」以應用工具配置更改
一、什麼是 Agent UI？ 製造業範例：客戶問「推薦一張工業電腦主機板」，AI 助理回傳含處理器、I/O、工作溫度等規格與「立即詢價」按鈕的產品卡
醫療院所範例：使用者查詢看診資訊，AI 助理回傳含科別、時間、地點、QR Code 報到碼的預約確認卡，並提供「查看候診進度」按鈕
航空業範例：使用者查詢航班資訊，AI 助理直接呈現含航段、艙等、座位、行李額度與登機 QR Code 的電子登機證卡
二、核心概念 三、建立 Agent UI（FlexMessage） AI 功能 → Agent UI ，點擊右上角的 新增 Agent UI 。
Agent UI 管理列表，顯示已建立的卡片工具及其關聯 AI 助理
選擇卡片類型，目前支援 FlexMessage
填寫基本資訊後，即可選擇模板與設定 AI 欄位
套用此模板 。
**12 種內建模板與適用產業：**
| 模板 | 適用場景 | 適合產業 |
| ------------ | --------------------- | ----------- |
| Restaurant | 店家推薦、預約 | 餐飲、觀光 |
| Hotel | 房型展示、訂房 | 飯店、旅宿 |
| Local Search | 地點搜尋、周邊推薦 | 觀光、零售 |
| Real Estate | 物件介紹、看屋預約 | 房產、租賃 |
| Apparel | 商品展示、規格介紹 | 零售、電商、製造業 |
| Transit | 路線/航班/時刻 | 交通、航空、物流 |
| Shopping | 商品比較、購物車 | 零售、電商 |
| Menu | 品項展示、菜單 | 餐飲、零售 |
| Receipt | 對帳單、訂單收據、消費明細 | 金融、零售、電商 |
| Ticket | 票券、登機證、預約確認 | 航空、活動、醫療掛號 |
| Social | 人物卡、社群檔案 | 教育、HR、社群 |
| TODO app | 任務清單、課程進度、工單狀態 | 教育、客服、製造業工單 |
| **自訂** | 貼入自訂 FlexMessage JSON | 任何需要客製版面的情境 |
{% hint style="info" %}
選擇模板只是起點，套用後可以在「AI 欄位設定」中任意調整每個欄位的內容與邏輯。
{% endhint %}
{% endstep %}
{% step %}
### 設定 AI 欄位
套用模板後，系統自動解析卡片中所有可編輯的欄位：
每個欄位可設定固定預設值，或填入 AI 提示詞讓 AI 動態生成內容
儲 存 ，Agent UI 工具即建立完成，可在列表中看到新增的項目。
{% endstep %}
{% endstepper %}
***
## 四、綁定到 AI 助理 AI 功能 → AI 助理 ，選擇要設定的 AI 助理，點選 設定 。
{% endstep %}
{% step %}
### 開啟 Agent UI 分頁
在設定頁面的分頁列中，點選 Agent UI 。
在 AI 助理的設定頁面中，可管理所有已綁定的 Agent UI 工具
選擇 Agent UI ，從清單中選取要加入的卡片工具。
* 一個 AI 助理可以綁定**多個** Agent UI
* 每個 Agent UI 的**提示詞**決定 AI 在哪種情況下使用哪張卡片
{% endstep %}
{% step %}
### 儲存
點擊右下角 儲 存 ，設定立即生效。
{% endstep %}
{% endstepper %}
***
## 五、應用範例：六大產業情境 同一個 AI 助理綁定六種產業卡片，AI 依使用者問題自動選用對應卡片
使用者輸入「推薦一張信用卡或理財方案」（或「查我這期帳單」），AI 助理回傳含消費明細、應繳金額、繳費截止日的對帳單卡，使用者可點「立即繳費」直接完成繳費
使用者：「推薦一張工業電腦主機板」— AI 助理回傳含處理器、I/O、工作溫度等完整規格的產品卡片
使用者：「推薦一張信用卡或理財方案」— AI 助理回傳含本期消費明細、回饋金、繳費截止日的對帳單卡，附「立即繳費」按鈕
使用者：「介紹一下課程或招生資訊」— AI 助理回傳含進行中課程、待繳作業、招生開放等多狀態的課程進度卡
使用者：「看一下科別與門診時段」— AI 助理回傳含醫師、時間、地點、QR Code 的預約確認卡，提供「查看候診進度」與「取消預約」按鈕
使用者：「推薦飯店或訂位資訊」— AI 助理同時回傳房型與餐廳推薦，含評分、限時特惠、訂房／訂位按鈕
使用者：「查詢航班與機位資訊」— AI 助理回傳含 TPE→NRT 航段、座位、行李額度與登機 QR Code 的電子登機證卡
六、常見問題
工具名稱有什麼命名限制？
工具名稱是 AI 模型識別此工具的唯一標識，必須：
* 使用英文字母
* 可包含底線（`_`）
* 不可含空格或中文
* 建議用描述性名稱，例如 `finance_statement_card`、`medical_clinic_card`、`airline_flight_card`
提示詞要怎麼寫才有效？
提示詞告訴 AI「什麼時候」要使用這張卡片。建議寫成具體的觸發條件：
**較模糊（效果差）：** 「需要時使用」
**較具體（效果好）：**
* 「當使用者詢問工業電腦、嵌入式系統、檢測設備等規格或報價時，回傳產品型錄卡片」
* 「使用者問到本期消費、繳費截止日或對帳單明細時，使用對帳單卡片」
* 「當需要展示班機、艙等、座位或登機資訊時，以電子登機證卡片呈現」
AI 欄位的 AI 提示詞沒填，欄位會顯示什麼？
若某欄位只填了「預設值」，AI 不會動態生成內容，直接顯示預設值。若兩者都沒填，該欄位顯示為空白。建議至少填入預設值，避免卡片出現空白欄位。
一個 AI 助理可以同時掛多個 Agent UI 嗎？
可以。AI 助理會根據每個 Agent UI 的「提示詞」判斷在當前對話中應使用哪張卡片。建議每個 Agent UI 的提示詞寫得清楚且不互相重疊，以避免 AI 選錯卡片。
Agent UI 可以用在 LINE 頻道嗎？
FlexMessage 原生支援 LINE 的卡片格式，在 LINE 頻道中呈現效果與 Web Chat 相同，都是完整的視覺化卡片。請確認 AI 助理已關聯 LINE 對話平台，並完成 LINE 頻道設定。
# 技能功能概覽
本篇將介紹何謂技能（Skill），技能如何協助 AI 助理處理複雜任務，以及技能與工具的差異
## 什麼是技能？ 技能 ，進入技能管理頁面，點擊右上角 新增技能 按鈕。
系統提供兩種建立方式：
### 方式一：手動建立 改用手動建立 連結，切換至手動模式
2. 填寫 基本設定 頁籤：
* **技能名稱**（必填）：為技能取一個易於辨識的名稱
* **描述**（必填）：簡要說明技能的用途
手動建立技能 — 基本設定頁籤
指令內容 頁籤，撰寫 Markdown 格式的指令內容。您也可以點擊 套用範本 按鈕，使用系統提供的預設範本作為起點
指令內容頁籤 — 支援 Markdown 格式與套用模板
附加工具 頁籤，為技能選擇所需的工具
5. 點擊 儲存 完成建立
### 方式二：上傳技能包 上傳技能包 — 支援 .skill 或 .zip 格式
編輯 圖示，進入技能設定頁面。
### 基本設定 編輯技能 — 基本設定
套用範本 可載入預設的指令範本。
{% hint style="warning" %}
套用範本會覆蓋目前的指令內容，請確認後再執行。
{% endhint %}
### 技能包（僅限上傳方式建立的技能） 預覽 ：展開檢視技能包內的檔案結構
* 下載 ：匯出技能包檔案
* 重新上傳技能包 ：上傳新版本替換現有的技能包
編輯技能 — 指令內容（含實際範例）
選擇工具 按鈕，開啟工具選擇彈窗
2. 勾選要附加的工具（支援多選），點擊確認
3. 已選擇的工具會顯示在列表中，包含工具名稱、類型（API / MCP）與描述
4. 如需移除工具，點擊該工具卡片上的刪除圖示
附加工具頁籤
儲存 按鈕。
***
## 匯出技能 技能包 頁籤中，點擊 下載 按鈕即可將技能匯出為 `.skill` 檔案。
{% hint style="info" %}
手動建立的技能也可以匯出，系統會自動將指令內容與資源打包為 `.skill` 檔案。匯出的技能包可分享給其他組織匯入使用。
{% endhint %}
***
## 將技能綁定至 AI 助理 AI 助理 頁面，選擇目標 AI 助理並進入設置
2. 在模型設置區域找到 技能 設定
3. 選擇要綁定的技能，點擊確認
4. 儲存 AI 助理設定
綁定後，AI 助理在對話中會根據使用者的問題自動判斷是否需要展開技能，並依照技能指令執行對應任務。
***
## 刪除技能 刪除 圖示，確認後即可刪除。
{% hint style="warning" %}
刪除技能後，已綁定此技能的 AI 助理將無法再使用該技能。此操作不可復原。
{% endhint %}
# 什麼是 Agent Teams？
把多個各有專長的 AI 助理組成一個協作團隊，透過「移交」與「委派」自動分工——使用者只跟一個入口對話，系統就把問題交給最合適的助理處理。
## 一、什麼是 Agent Teams？ 二、和「單一助理 + 技能」有什麼不同？ 三、三種互動方式：移交、委派、自動 移交：來源助理交出控制權，目標助理接手繼續與使用者對話
委派：來源助理把子任務交給目標助理，取回結果後自己彙整回覆
自動：由 AI 依當下情況，自行決定要移交還是委派
四、典型應用場景 五、運作原理（概念） 六、下一步 一、新建團隊 AI 功能 →〈團隊 〉。列表會顯示目前組織所有的團隊，包含**團隊名稱、代理數、狀態**等資訊，右上角可搜尋團隊。
團隊列表：可看到每個團隊的名稱、包含幾位代理與啟用狀態
新建團隊 ，填入**團隊名稱**（必填）與**說明**，即可建立。
新建團隊：填入團隊名稱與說明
二、在畫布上編排團隊 畫布編排 檢視。畫面分成三個區域：左側〈**助理列表**〉、中間**畫布**、右側**設定面板**（點選節點或連線時出現）。
放大後的團隊圖：入口節點「客服分流助理」透過「移交」分流到訂單查詢／退換貨／商品推薦助理，訂單查詢助理再「委派」倉儲查詢助理。每個節點顯示助理名稱、模型與 Agent／RAG 模式，入口節點標示「入口」（實際畫面左側另有〈助理列表〉、右側為設定面板）
Agent 或 RAG 模式，方便你辨識。
{% hint style="info" %}
若節點位置雜亂，可點畫布上的 自動排版 讓系統重新整理版面。節點位置會自動儲存。
{% endhint %}
### 2. 設定節點 節點設定：指定入口節點、Token／迭代上限與上下文策略
連線設定：填觸發條件描述、選互動方式（自動／移交／委派），並可選擇是否繼承來源助理的工具
三、設定基本資訊與安全護欄 基本資訊與安全護欄：調整團隊名稱、啟用狀態，以及最大迭代數、整體 Token 上限與逾時秒數
四、與團隊對話 五、刪除團隊 六、下一步 一、查看執行記錄 執行記錄：每一次團隊執行的狀態、迭代數、Token 數與耗時
二、展開步驟詳情 步驟詳情：逐步看到經過哪些助理、各自的輸入輸出摘要與 Token 成本分攤
三、怎麼用這些記錄優化團隊 **AgentOps** 」,點選 「**測試資料集** 」,即可看到測試資料集管理頁面。
測試資料集管理介面
**Create Dataset** 」按鈕,開始建立新的測試資料集。
### 2. 設定基本資訊 **編輯** 」按鈕,您可以:
* 修改測試資料集名稱與描述
* 新增、編輯或刪除測試案例
* 調整測試案例的順序
{% hint style="info" %}
建議定期檢視並更新測試案例,確保測試內容與實際業務需求保持一致
{% endhint %}
### 刪除測試資料集 **刪除** 」按鈕,即可刪除不再需要的測試資料集。
{% hint style="warning" %}
刪除測試資料集後無法復原,請謹慎操作。若該資料集已被用於自動評估,相關評估記錄仍會保留,但無法再次執行相同測試。
{% endhint %}
## 測試資料集最佳實踐 AgentOps 」，點選「自動化測試 」。
自動化測試列表，顯示各次測試的成功率與平均回應秒數
建立測試 」按鈕
3. 填寫評估名稱、描述，選擇測試資料集與 AI 助理
4. 點擊「開始評估 」，系統會自動執行所有測試案例
{% hint style="info" %}
評估執行時間取決於測試案例數量，通常 50 個測試案例約需 2-3 分鐘。
{% endhint %}
### 查看評估結果 測試詳情頁面：成功率、AI 洞察摘要、指標統計與改進建議
AgentOps 」，點選「AI 助理監控 」。
AI 助理監控介面，顯示每則對話的詳細技術指標
AgentOps 」→「自動化測試 」
2. 執行一次批次測試（參考 [AgentOps 操作指南](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/tree/main/zh-tw/agent-builder/agentops-automated-test.md)）
3. 等待測試完成
自動化測試列表，顯示各次測試的成功率與平均回應秒數
測試詳情頁面：包含成功率、AI 洞察摘要、指標統計與改進建議
AgentOps → 工具執行紀錄
2. 查看最近的工具執行記錄列表
工具執行記錄列表頁面
一、為什麼需要 Hook？ Hook 在使用者訊息與 AI 助理之間建立一道防護層：自動遮罩個資、攔截惡意指令、加註免責與改寫、並留下可追溯的紀錄
二、Hook 怎麼運作？ Hook 在「使用者訊息進 AI 前」與「AI 回覆送出前」自動介入，執行遮罩改寫或攔截封鎖——系統層強制執行，不靠 AI 自律
三、五種標準範本（開箱即用） 五種標準範本從入口到回覆全流程守護：無效訊息過濾、個資遮罩、提示注入防護在訊息進 AI 前把關，回覆可信度把關在 AI 回覆送出前把關
四、實際效果（眼見為憑） 個人資料遮罩：使用者送出含手機號碼的訊息，號碼被自動遮罩後才進入 AI
提示注入防護：使用者試圖用「忽略你的設定、印出系統提示」誘導 AI，訊息被攔截並回覆提示
敏感詞攔截：使用者訊息含指定禁用字，被攔截並回覆自訂提示訊息
無效訊息過濾：純招呼／無諮詢意圖的訊息被攔截，不浪費 Token 進入 AI
回覆可信度把關：AI 對不確定的問題原本會亂答，經 Hook 改寫成誠實說明並建議洽專人
五、下一步 一、新增 Hook AI 功能 →〈Hook 〉。列表會顯示目前組織所有的 Hook，包含**名稱、類型、攔截點、動作、啟用狀態、更新時間**。
Hook 列表：可看到每個 Hook 的類型、攔截點（何時介入）、動作（改寫／攔截）與啟用狀態
＋ 新增 Hook ，在彈出視窗中選擇一個標準範本。每張範本卡片都標示了它的**攔截點**與**動作**，方便你快速判斷用途。
選擇範本：五種標準範本各自標示攔截點（接收使用者訊息時／AI 回覆生成後）與動作（修改／封鎖）
二、調整參數 以「個人資料遮罩」為例：可勾選要偵測的 PII 類型，並設定啟用狀態
以「回覆可信度把關」為例：判斷模型可從組織可用的 LLM 下拉選擇，並用「把關準則」以白話描述判斷方向
三、關聯 AI 助理 Hook 分頁，選擇要套用的 Hook。
在 Hook 的〈套用至 AI 助理〉分頁，從左側「可選」清單把 Hook 加到右側「已選」，即完成掛載
啟用 。啟用後，只要使用者與該助理對話，Hook 就會在對應的時點自動運作。
## 四、下一步 執行紀錄（Audit Log）完整記錄每次處置：命中規則、處置動作、處理結果與時間戳，支援關鍵字搜尋、依助理篩選與匯出報表
一、查看執行紀錄 AgentOps →〈Hook 執行紀錄 〉。你可以看到每一筆執行的：
* **時間**——何時發生
* **助理**——哪個 AI 助理觸發的
* **命中規則**——是哪一個 Hook 處理的
* **處置**——做了什麼（遮罩改寫／攔截封鎖／放行）
* **狀態**——處理結果
你可以用**日期區間、助理、關鍵字**篩選，也能**匯出報表**做進一步稽核分析。頁面上方也會顯示**總執行次數、命中次數、命中率**的統計。
執行紀錄列表：每筆顯示 AI 助理、Hook 名稱、觸發點、動作與結果。可看到個資遮罩把手機改成 [REDACTED_PHONE]、敏感詞與提示注入被封鎖等實際處置
單筆詳情：以個資遮罩為例，可看到動作為 modify、訊息內容已遮罩為 [REDACTED_PHONE]
二、控制是否記錄原始訊息 記錄遮罩前原始值 開關由 `off` 改成 `on`。開啟後，紀錄會額外保留遮罩前／攔截前的原始內容，方便追查。
在 Hook 設定頁的「記錄遮罩前原始值」欄位控制：預設 off（只記型別與次數，不留原始個資），需要除錯時才改成 on
三、從對話中查看 Hook 執行詳情 客服對話 →〈所有對話 〉，開啟任一則對話，就能看到該對話中哪些訊息被 Hook 處理過（遮罩或攔截），對應到當下的處置。
這讓你在檢視客戶對話時，能直接理解「為什麼這則訊息被遮罩／被擋下」，不必另外比對紀錄。
## 四、相關頁面 會議記錄列表
語音識別供應商選擇
語言選擇與翻譯設定
即時轉錄設定頁面
會議詳情 — 逐字稿分頁
會議詳情 — 純文字稿分頁
會議摘要分頁
AI 問答分頁
下載分頁
**系統預設平台接口** 對外公開上線 僅對內使用 內部問答介紹 如何使用內部問答？ 藍色下拉選單 中選擇想要進行對話的 AI 助理。
新建問答 」，進行一個全新的對話。
{% hint style="info" %}
所有對話都會出現在左上角問答紀錄中
{% endhint %}
選擇對話後即可在下方文字方框中輸入您的問題開始對話。
繼續過去對話(選擇對話)
開啟新對話(新建對話)
使用技巧 一、WebChat 是什麼？ 二、打造企業風格的 Web Chat 服務 三、訊息客製化 對話開始問題 」 作為快速選項
* 用戶可直接點擊常見問題，無需打字
* **範例問題**：
* 「如何查看已訂購項目？」
* 「如何下訂單」
* 「會員積分規則」
* 「營業時間」
用戶可透過點按起始問題展開對話，加速問答進程：
## 四、多樣性問答內容 五、歷程記憶與對話分享 六、選擇是否顯示使用工具、引用文件列表 七、對話權限保障 - 安全可控的對話環境 一、進入設定頁面 客服對話 > 對話平台 」 ，點選右上角的 「＋串接對話平台 」，選擇平台 「 Website 」
### 2. 路徑二：AI 助理關聯對話平台 AI 功能 > AI 助理 」 選擇某隻 AI 助理，點選 「 操作 」 圖示，再點選 「 關聯對話平台 」 的 「 網頁 XX 助理 」
### 3. 路徑三：對話平台操作 客服對話 > 對話平台 」，選擇您想要設定之 AI 助理，點選 「 操作 」 圖示即可進入對話平台配置。
## 二、基本設定 平台名稱 」 欄位輸入您希望在網站上顯示的 AI 助理名稱
* 例如：「 客服小幫手 」、「 智能助理 」等
**選擇 AI 助理**
* 在 「 AI 助理 」 下拉選單中選擇要使用的 AI 助理
* 這會決定聊天室使用哪一個 AI 助理 來回答問題
**設定返回網址**
* 在 「 返回網址 」 欄位輸入您的公司網站網址
* 當用戶點擊聊天室的返回按鈕時，會跳轉到這個網址
**取得並使用公開網址**
* 系統會自動生成一個 「 公開訪問URL 」
* 您可以：
* 點擊 「 複製 」 按鈕複製網址
* 點擊 「 訪問 」 按鈕在新視窗開啟聊天室
* 點擊 「 嵌入 」 按鈕取得嵌入程式碼
* 點擊 「 嵌入預覽 」 按鈕預覽嵌入效果
**嵌入腳本優化**
當您選擇嵌入方式時，系統會提供優化過的 embed.js 腳本，具備以下特點：
* **防重複執行機制**：即使腳本被多次載入，也只會初始化一次，避免衝突
* **更好的錯誤處理**：當載入失敗時，會提供清楚的錯誤訊息，方便除錯
* **優化載入效能**：腳本經過最佳化，不會影響網站載入速度
* **相容性提升**：與各種網站環境和框架更加相容
**嵌入最佳實踐：**
1. 將嵌入腳本放在 `