閒聊工具：不只是聊聊天
所謂的「閒聊」，在 DMflow 的定義裡，是整合了文檔問答、表單問答以及多種實用工具的強大介面。透過配置不同的工具，您可以讓機器人從單純的對話者，進化為能處理複雜任務的 AI 助理。
參數取得小技巧：Domain ID 與 Table ID
在使用許多工具時，您需要填入 domain_id 或 table_id。系統大多會提供自動提示功能，但若您使用的是較新的工具，可能需要手動查找。
請參考下圖位置獲取這些 ID：
工具詳解
search_table (表單查詢)
| 參數 | 說明 |
|---|---|
| domain_id | 選擇包含該表單的領域（必須是表單問答類型的領域）。 |
| table_id | 選擇目標表單的 ID。 |
此工具允許機器人透過 SQL 語法 查詢表單內容。
- 權限： 搜尋結果受「訪客權限」限制。您可以前往 表單權限 進行設定。
- 呈現： 支援整合 CARD（卡片）輸出，讓結果更美觀。
- 預覽： 您可以點選 Preview 預覽搜尋結果與對應欄位。
rate_conversation (評價對話)
當系統判斷顧客有結束對話或離開的意圖時，可調用此工具詢問顧客本次對話是否「有幫助」或「沒用」。這些回饋會自動寫入系統日誌，作為優化的依據。
search_knowledge (知識庫搜尋)
| 參數 | 說明 |
|---|---|
| domain_id | 選擇文檔問答領域。 |
| description | 描述想要搜尋的關鍵字或問題。 |
使用此工具，機器人將自動調用文檔問答（DocQA）的內容來回答用戶問題。
collect_user_info (蒐集用戶資訊)
此工具用於更新使用者的個人檔案：
usernameemailphone
只要將上述參數設定為 true，機器人就會在對話過程中，嘗試從使用者的回答中提取並更新這些資訊。
create_table_data (新增表單資料)
| 參數 | 說明 |
|---|---|
| domain_id | 表單問答領域。 |
| table_id | 目標表單 ID。 |
| trigger_id | 指定觸發器 ID。 |
- 權限特例： 調用此工具不需要設定表單的寫入權限，只要角色擁有「插入」權限即可執行。
- 連動： 資料插入成功後，會自動調用指定的觸發器（Trigger）。
human_agent_help (真人客服支援)
當用戶明確表達需要真人客服，或 AI 無法處理時，此工具會觸發 Fallback 機制，並將訪客的問題自動記錄到「共用筆記」內，方便真人客服接手。
auto_suggestion (自動建議)
啟用後，系統會自動在回答下方追加最多三個推薦的後續詢問句，引導用戶繼續對話。
googlemap_routes_api (路徑規劃)
- api_key： 請先在設置頁面完成加密後再填入。
- limit： 搜尋結果數量限制。最大為 25，預設為 25。您可自行設定 1-25。
- 邏輯： 系統會先計算直線距離，過濾出最近的地點，再調用 API 進行路徑計算。
custom_service (自定義 API)
允許您調用外部 API。
- 限制： 回傳的 Payload 大小不得超過 4K（CJK 字元長度算 1，其他語言約 3-5 個字母算 1）。
| 參數 | 說明 |
|---|---|
| resource_id | 資源節點 ID。 |
| name | functionName（對應 LLM 調用工具的名稱）。 |
| description | function Description（對應 LLM 調用工具的描述）。 |
| parameters | 定義參數結構：{name, description, type, require, enums}。 |
參數設定說明：
- type： 支援
string,number,boolean,string_array。目前不支援物件陣列。 - enums： 選項值可用
|分隔，例如：中文|英文|日文。
suggestion_items (產品搜尋)
透過內建的產品搜尋引擎，尋找並推薦相關產品。
search_reserve_range (預約查詢)
- 前提： 必須選擇含有「預約組件」的表單。
- 參數：
domain_idtable_iddescription：讓 LLM 清楚了解您想要預約的標的物。
collect_user_tag (蒐集用戶標籤)
根據對話內容自動為訪客上標籤。
- 格式：
{name: string, description: string}[] - 邏輯： 若標籤名稱已存在於訪客標籤庫中，則會進行添加。
get_form_link (取得表單連結)
取得一個綁定該訪客身份的外部表單連結，方便訪客在網頁填寫複雜資料。
- 參數：
array name,description,table_id
code_geodesic (經緯度計算)
使用程式碼演算法判斷經緯度之間的距離，不需調用外部地圖 API。
store_memory (記憶存取)
管理訪客的持久性記憶。支援儲存、查詢及移除操作。
