# AI 代理人

目前此功能僅開放網頁聊天以及Whatsapp使用，每次使用消耗一點AI點數

此模式大幅度減少開發流程式問答的作業。我們網頁的部分可以分為

1. 建議功能: AI將不會直接回覆訪客，而會在聊天室提供建議搜尋的項目
2. 自動回覆: AI會直接回覆對方問題

不管哪種模式，第一次問答只要有客服專員在線上馬上都會通知，而意圖沒命中也會自動通知。指派的專員採用自動負載根據未關閉的聊天室窗做自動分配。

### 輸入

網頁: 支援文字

Whatsapp: 支援文字、圖片、語音(一分鐘左右，檔案大小勿超過5mb幾乎都可以通過) 

### 如何使用

先前往領域開啟你需要的功能

### 文檔問答

此為最簡單的方式，自行上傳檔案，唯一要注意的是sitemap模式下只會抓取靜態網頁。而單一抓取動態網頁，由於近期版本已經預設爬蟲user-agent為DMflowBot，將會依照robots.txt的規則做爬取。若有使用cloudflare且有開啟WAF（Web Application Firewall），請先關閉或是允許該DMflowBot爬取。請爬取自己的網頁。

<figure><img src="/files/NCrdZ6wYqjSrXQvsbNtL" alt=""><figcaption></figcaption></figure>

### 表單問答

表單問答就像使用資料庫一樣，先設定schema即可。但由於產品本身是adapter(將SQL轉成系統的搜尋方式)資料庫的方式並非操作真實資料庫，所以不會發生任何跟SQL injection等問題。

在權限方面，使用代理人做插入是可以允許的(若是從儀表板進行插入若沒權限則是無法)，但查詢的權限請必須設定好。詳情可從 [表單](/domain/formqa/form.md#biao-dan-quan-xian) 查詢。

<figure><img src="/files/Pykv2KENf5AtVPapYrA5" alt=""><figcaption></figcaption></figure>

設計完畢後，請先前往儀表板做新增設定，機器人操作新增資料的時候的時候會依照你的新增設定而改動，若未添加新增設定會自動根據欄位做設定。

<figure><img src="/files/wo6ar6pzPq78RNdHpElp" alt=""><figcaption></figcaption></figure>

點擊新增設定後你可以自行設定預設值，必填等設定，唯一要注意的是Upload目前僅支援UI功能，不支援任何聊天機器人。若想新增完畢做觸發器工作流，請在Button設定，詳細觸發器請查看 <https://www.dmflow.chat/tw/blog/2024-dmflow-form-qa-tutorial-2>或是 [表單問答](/domain/formqa.md#chu-fa-qi)

<figure><img src="/files/Jyw4nWO6WoMIGyUlrbzp" alt=""><figcaption></figcaption></figure>

### 閒聊角色

最後前往閒聊角色的設定，請前往 [#xian-liao-jue-se](#xian-liao-jue-se "mention")查看

### 開始設定代理人

目前代理人的設定分為前置條件設定(過濾使用者資訊)、意圖設置以及回應設置。

過濾用戶者資訊目前尚未開放，主要用於判斷用戶聊天輪次，用戶的資訊判斷是否滿足(例如: 已經填寫了信箱，信箱是否有認證等)

意圖設置為主要說明方向，本篇教學主要以這個方向為主。

<figure><img src="/files/tucORhwP3TMg6oBhevhe" alt=""><figcaption></figcaption></figure>

意圖主要根據描述做判斷，目前會預載訪客資訊，未來可能還會開放記憶模組或是事先調用資料庫，讓意圖判斷更準確。

* 允許快捷的意思是可以使用 "/" 搭配名稱 加上空白 後面的是對話，可以直接跳過意圖辨識

例如: /查詢資訊 我要請問一下你的統編是多少

* 模式分為代理人回應以及直接回應

直接回應就是辨識到該意圖將直接回覆你已經設置好的訊息

代理人回應是選擇你的閒聊角色即當命中意圖後會轉向該代理人進行回覆

* 預設開啟工具: 意思是每次呼叫代理人都必須調用工具
* 預設開啟思考: 意思是代理人會先思考完再調用工具

**這裡需要注意的是思考**

當你開啟思考後建議你的提示詞不建議 "你是什麼角色" 這類型的角色扮演，直接在提示詞寫你要做什麼即可，例如: 你在新增用戶資料前要先檢查這個用戶是否存在。 這種命令的方式撰寫提示詞即可。&#x20;

### 測試

前往設置->內嵌網頁 設定，要注意的是 分享開啟、是否啟用內嵌網頁開啟、網域限制添加<https://app.dmflow.chat，新增完畢後，下面有個分享連結打開即可進行測試。>

<figure><img src="/files/k5ReOyc0XGM4tO3zDPwP" alt=""><figcaption></figcaption></figure>

每一次AI對話都會提供包含thinking的全部內容，以及knowledge的詢問自動延展，以及followup\_questions為推薦用戶下一步對話。其他包含表單插入可以跳出插入的訊息出來，表單搜尋會顯示該訪客能查詢到的表單內容(目前不能使用不等於等表達式)，點入更多會直接給你查看。

訪客旁邊有個魔法棒的東西可以將該語言根據你瀏覽器選擇的語言做翻譯。而對話選單左數到右分別是emoji、note(添加共用筆記，可使用@ 呼叫其他專員)、magic(目前僅提供翻譯功能，若對方locale有數值會預設指定對方的語言進行轉換)

AI翻譯免費版提供1萬字元/每人/月免費服務，輕量版則是10萬字元/每人/月，字元以輸入的字數數量為限制。完全可以滿足一般客服服務。

<figure><img src="/files/z5rHzblyk3G7lu0M2LET" alt=""><figcaption></figcaption></figure>

之後會補充影片教學。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.dmflow.chat/chatbot/ai-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.