Agent UI

建立 FlexMessage 資訊卡片，綁定到 Agent，讓回覆以卡片呈現。

一、什麼是 Agent UI？

Agent UI 讓 Agent 在對話中呈現資訊卡片或互動選項。本頁介紹 FlexMessage：把文字、圖片與按鈕放在卡片中，讓使用者更容易閱讀資訊。

在 新增 Agent UI 時，可以選擇 FlexMessage 或 快速選單。Quick Reply 的入口是否顯示，依平台開放狀態而定；若畫面未出現此類型，請先使用目前可選的類型。

新增時先選擇要建立的類型

使用情境

客服主管想讓同事看懂收據卡片的呈現方式。她建立一張 Receipt 模板卡片，保留虛構品項與金額，將卡片綁定到測試 Agent，再於 Web Chat 請 Agent 展示虛構示範收據。Agent 呼叫卡片工具後，對話中會出現品項、總額與付款編號，方便確認版面。

卡片模板與 AI 提示詞不會自動串接帳單、會員、訂房或掛號系統。若要展示真實即時資料，須先另外提供知識庫內容或配置可取得資料的工具；按鈕開啟連結，也不代表已完成付款或預約。下方收據為虛構模板資料。

二、卡片欄位與按鈕

卡片的欄位可設定 預設值，也可以填入 AI 提示詞，告訴 Agent 該欄位應呈現什麼內容。未設定 AI 提示詞的欄位使用預設值。

卡片按鈕可以做什麼？

• URL 按鈕：開啟指定網址，例如商品說明頁。

• Prompt 按鈕：向 Agent 送出一則訊息，接續對話，例如「查看其他商品」。

按鈕的結果取決於連結目的地或 Agent 已配置的能力，請在正式提供給使用者前測試。

三、建立 Agent UI（FlexMessage）

1

1. 進入 Agent UI 頁面

在左側選單點選 AI 功能 → Agent UI，再點 新增 Agent UI。選擇 FlexMessage，進入設定頁面。

2

2. 填寫基本資訊

欄位	說明
顯示名稱	後台用來識別卡片的名稱，例如「虛構收據卡」
工具名稱	供 AI 識別的英文名稱，例如 demo_receipt_card
描述	說明用途，例如「展示虛構示範收據」
提示詞	說明使用時機，例如「當使用者詢問虛構示範收據時，使用此卡片」

工具名稱使用英文識別名稱，不要含空格或中文。提示詞寫明使用時機，較有助於 Agent 判斷何時呼叫卡片。

3

3. 選擇模板與設定欄位

點選模板查看預覽，再點 套用此模板。內建模板包括 Restaurant、Apparel、Hotel、Local Search、Real Estate、Social、TODO app、Transit、Receipt、Shopping、Menu 與 Ticket；也可選擇 自訂，貼入 FlexMessage JSON。

套用後，在 AI 欄位設定 調整 預設值 與 AI 提示詞。先用固定的虛構資料確認版面，再逐步加入需要動態生成的欄位。

Receipt 卡片的基本資訊與預覽

4

4. 儲存卡片

點擊右上角 儲存。完成後回到列表，可看到新建立的卡片。

四、綁定到 Agent

1

1. 開啟 Agent 設定

前往 AI 功能 → AI 助理，開啟要設定的 Agent。請使用 Agent 模式，才能配置 Agent UI。

2

2. 選擇卡片

在設定頁點選 Agent UI，再點 選擇 Agent UI。勾選卡片後按 確認；已加入的卡片會出現在 已使用的 Agent UI。

確認卡片已加入 Agent

3

3. 儲存與測試

點擊 儲存，再開啟此 Agent 的測試對話或 Web Chat。輸入「請展示虛構示範收據」，確認 Agent 呼叫卡片工具且卡片內容正確。

Agent 在對話中呈現虛構收據卡片；金額只供示範

五、應用情境

可以將模板改成商品型錄、旅宿介紹、課程資訊或活動票券等資訊卡。先準備內容與可用連結，再設定卡片欄位與提示詞；若需要查詢庫存、訂單或預約狀態，先配置對應資料來源與工具。

一個 Agent 可以綁定多張卡片。請把每張卡片的使用時機寫清楚，並分別測試，確認 Agent 在對應問題下選用正確卡片。

六、Agent UI 提問工具（ask_user_question）

除了 FlexMessage 卡片，也可以使用 Agent UI 提問工具，讓 Agent 列出選項供使用者回答。在 Agent 的 工具 設定中加入此內建工具，操作方式見 為 Agent 配置工具。

Web Chat 的選項呈現方式由對話平台的 提問集選項顯示模式 決定。

七、常見問題

卡片沒有出現怎麼辦？

確認 Agent 使用 Agent 模式、卡片已綁定並儲存，再檢查提示詞是否清楚描述使用時機。Agent 是否呼叫卡片仍依對話內容判斷，請用具體問題測試。

卡片會自己查詢外部系統嗎？

不會。卡片負責呈現內容；查詢外部系統需另外配置工具或資料來源，不能只在欄位提示詞寫「取得帳單」就完成串接。