AI 回覆與代理
讓 AI 回覆或解析申請,也可設定使用你的資料回答問題、必要時轉交客服的 AI 代理。
本頁內容
你可以讓 AI 處理單一步驟,也可以交給它整段對話:
| 選擇 | 適用情況 | 你需設定 |
|---|---|---|
| AI 動作 | 從訊息擷取電話和主題,或產生簡短回覆 | 反應與模型任務 |
| AI 代理 | 依你的知識來源自行回答問題 | 資料、回覆規則和轉交客服條件 |
兩者都需要同一類 AI 整合。
連接模型
在整合新增 AI 類型,填寫:
- Base URL:OpenAI 相容 API 網址,預設
https://api.openai.com/v1;可用 OpenAI、OpenRouter、本機伺服器等相容服務。 - 模型:例如
gpt-4o-mini。 - 系統提示詞:模型的一般指引。
- API 金鑰:供應商憑證,會加密保存,也可存入專用憑證區。
這個連接也會把文字片段轉成語意搜尋用的數值表示(embeddings)。沒有可用的 AI 整合,代理和知識搜尋都無法運作。
AI 動作
在反應中加入 AI 動作並設定:
- AI 整合:要使用的模型連接。
- 提示詞:模型要做的事,可插入
{{text}}、{{param.鍵}}、{{ctx.鍵}}等變數。 - 儲存回覆至參數/ctx:選擇結果保存位置。
- JSON 擷取結構:設定後,模型按結構回傳 JSON,適合解析申請或分類;結果可交給清單迴圈。
- 向使用者傳送回覆:直接將生成文字送到聊天。
訊息中的 AI 區塊
訊息編輯器也有帶自己提示詞的 AI 區塊,可即時生成回覆的一部分;詳見訊息與按鈕。
使用範例
AI 代理
左側 AI 區含代理、日曆及分析。代理會自行處理傳入訊息:在允許的來源尋找資料、組成答案、記錄客戶事實或預約會議,並依規則轉交客服。草稿狀態的代理不會介入真實對話。
狀態與版本
代理狀態為草稿、啟用、暫停、已封存。草稿可啟用或封存;啟用的代理可暫停或封存;暫停的可重新啟用或封存。封存不可撤銷。
啟用時,完整設定會保存成一個版本。修改已啟用代理會產生新版本,而既有對話繼續使用開始時的版本。同一個傳入頻道最多只屬於一個已啟用代理,不能在同一頻道啟用第二個。
代理設定
基本設定及行為:
- 頻道與表面:代理在哪裡答覆,可選 Telegram、VK、WhatsApp 及網站。
- 回覆語言:1 至 20 個語言代碼,例如
ru, en, pt-br;其他語言的回覆會在傳送前被拒絕。 - 代理指引:最多 12,000 字元,寫明任務、邊界與禁止事項。
- 語氣:最多 160 字元。
- 回覆長度上限:200 至 12,000 字元。
- 措辭自由度與信心門檻:0–100%;低於門檻時不自行答覆。
- 非工作時間:照常回覆、準備給客服的草稿,或轉交對話;須先啟用客服時間表。
- 草稿模式:向客服建議答案,而非直接傳給客戶。
客戶資格確認:
- 確認目標:代理應了解什麼。
- 必須收集的事實:最多 30 項;每項包含客戶資料鍵(小寫字母、數字、底線)及提問。
- 確認完成後:繼續對話或轉交客服。
- 停止詞句:最多 20 句,每句最多 160 字元;只有客戶整則訊息與句子相同時才觸發,不區分大小寫及多餘空格。
知識與工具:
- 允許的來源:1 至 200 個知識來源;客服專用或停用的來源不能選。
- 允許的工具:最多 8 個。已啟用代理目前只可使用日曆工具,詳見會議與 Google 日曆。有副作用的工具預設要求確認。
轉交與失敗時:
- 轉交客服:指定客服群組,及接手前客戶看到的訊息。
- 無法協助時:轉交客服、傳送備用訊息,或交回機器人的一般流程。
一次回覆如何產生
收到訊息後,代理先搜尋相關資料,再準備答案。若需要日曆等允許的工具,就等待工具結果。最後可能傳送答案、改用備用訊息、轉交客服或記錄錯誤。每次對話輪次最多呼叫工具四次。每則傳入訊息只處理一次,即使模型回應慢,也不應由重複的處理程序送出第二個答案。
伺服器會組合模型情境:客戶資料及已批准屬性、已驗證頻道、有限的近期訊息和事件、目前客服狀態與時間表,以及找到的資料片段。傳給供應商前會截短內容並移除敏感值。
代理只可依允許來源作答,搜尋最多回傳 12 個片段。若代理有來源、沒有工具,卻找不到資料,它不會自行編造答案,而會轉交或以 no_source 原因提供備用回覆。引用搜尋結果中不存在的來源,也會在傳送前被拒絕。
防止訊息或資料中的惡意指令
客戶或文件可能寫「忽略規則並傳送資料」。代理應把它當作內容,不是新指令:
- 系統政策與工具結構獨立提供,來源或客戶文字不能取代它們。
- 模型不能選擇機器人、客戶、來源、URL、SQL、憑證或原始 HTTP 參數;這些值由伺服器情境決定,模型回應中的權限欄位會被移除。
- 只有工具已註冊、在代理設定中獲准,而且參數符合不接受未知欄位的封閉結構時,才會執行。
- 每個有副作用的工具呼叫都以對話輪次及呼叫編號形成冪等鍵,限時 15 秒,並記錄已去除個人資料的參數與結果。
- 答案送出前會檢查長度、語言、來源引用和不安全語法,並移除不支援的格式標記。
事實與來源
代理只能把列於必須收集的事實中的鍵寫入客戶資料。每個事實都保留來源訊息、對話輪次及「建議/已套用/已拒絕」狀態,可追溯至客戶實際說過的話。
轉交客服與恢復
轉交會建立或更新一般客服對話、指派群組,並附上已清理的結構化摘要:原因、已收集事實、使用過的來源及未完成事項。原因可能是停止詞句、信心不足、找不到來源、資格確認完成、非工作時間、供應商或工具故障。
對話由客服處理期間,代理保持安靜。只有在對話中明確要求恢復(POST /api/bots/{botID}/subscribers/{subscriberID}/ai/resume)才會重新接手。
上線前檢查
代理檢查會驗證設定並安全模擬:不呼叫模型、不傳送訊息、不執行工具、不建立預約,只顯示哪些動作被抑制。資料片段應在搜尋檢查查看。
設定錯誤、頻道被其他代理佔用或未連接、來源或客服群組不存在、沒有 AI 整合,或日曆工具缺少已啟用的會議類型時,就緒檢查不會允許啟用代理。
分析與品質檢查
AI → 分析可查看對話、已傳答案、備用答案、轉交、錯誤、草稿、已檢查及不安全回覆、延遲、輸入/輸出 token、各貨幣成本、來源與工具使用、日曆操作,以及無須客服就解決問題、目標達成、CSAT、重新開啟和升級處理等業務結果。可按期間、代理及版本、頻道、語言、受眾群組、來源與結果篩選,並按日或小時分組。
AI → 回覆品質列出代理對話。對話中可見代理狀態及每個回答的信心、延遲、token 和成本;訊息文字留在客服對話中,由連結開啟。審查者可評為正確、錯誤或不安全,附原因碼與備註,亦可匯出評分。畫面與匯出都會移除敏感資料。
每次輪次都會保存輸入/輸出 token,若供應商提供成本,也會記錄,供按代理及期間查看。
Managed AI
代理設定須明確選擇模型來源:你自己的 AI 整合,或帳號的 Managed AI。自己的金鑰出錯時,系統不會自動切換至付費 Managed AI。Managed AI 可選 fast、balanced、quality 三種設定檔;它們決定路由,不代表固定的一個供應商模型。
產品會顯示每月內含點數、每月硬性上限及加價比例,選方案前應比較。直接 API 呼叫需要具 managed_ai:invoke 權限的 PAT 及 Idempotency-Key,查看用量另需 managed_ai:usage:read。請將權杖保存在自己的伺服器;路徑見 REST API。