2026 年 10 月 28 日針對 Wix Custom Code 與 Agentkit 產生的小工具更新。
若要將 Agentkit 聊天機器人加入 Wix，請從 Channels → Website embed 複製完整的 Chat widget 程式碼，並將兩個 script 標籤貼入同一個 Wix Custom Code 項目。發佈網站後，在線上頁面檢查小工具與一個已核准的回答。Wix 表示 Custom Code 需要已發佈且連結網域的網站。連結網域需要付費的 Wix Editor Premium 方案，詳見 Wix 的網域指南。請在已發佈的網址測試，而不是在編輯器預覽中測試。Wix 的 Custom Code 說明與 Agentkit 的 Wix 設定指南分別說明安裝的兩個面向。
本指南依據目前的 Agentkit 與 Wix 文件撰寫。我們並未在客戶的 Wix 網站上安裝機器人，也未測量其回答品質。Agentkit 發表本指南並銷售文中所述的聊天機器人。
選擇正確的放置方式
| 讀者目標 | Wix 放置位置 | Agentkit 管道 |
|---|---|---|
| 在選定頁面或整個網站顯示浮動聊天按鈕 | 後台 Settings → Development & integrations → Custom Code | Chat widget，包含兩個產生的 script 標籤 |
| 在單一頁面區塊內顯示完整聊天面板 | 編輯器 Add Elements → Embed Code → Embed HTML | Iframe，使用產生的 iframe 程式碼 |
Wix 的 HTML 嵌入本身就是一個 iframe。它會在頁面元素內顯示內容，因此調整該元素的大小很重要。它不適合用來放置全站浮動按鈕。Wix 的可見嵌入說明解釋了這個頁面元素。以下步驟使用 Custom Code 來安裝浮動小工具。
安裝前先準備一個回答
選擇一個您的網站已經回答的公開問題，例如服務區域、營業時間或已公佈的退貨規則。儲存確切的來源網址與一個已核准的回答。將該頁面新增為 Agentkit 網站來源，然後在 Playground 中提出該問題。將回答與目前頁面內容進行比對。如果重要資訊位於圖片中，或位於爬蟲未擷取的頁面，請新增一組已核准的問答並再次測試。訓練指南說明如何檢閱擷取的來源。
另外選擇一個您的來源無法回答的問題。決定機器人應該說什麼，或應提供哪個聯絡管道。上線前請將實際回覆與您核准的政策進行比對。
在 Wix 中安裝浮動小工具
- 在 Agentkit 中，開啟您的聊天機器人的 Channels → Website embed → Chat widget。複製完整的產生程式碼。第一個 script 會設定小工具佇列；第二個會為您的聊天機器人載入小工具。請將兩者放在一起，並使用所提供的 script 網址與聊天機器人 ID。
- 在您的 Wix 網站後台，開啟 Settings → Development & integrations → Custom Code，然後選擇 + Add Custom Code。確認您的 Wix 方案支援連結網域，且網站已發佈。
- 將兩個 script 標籤貼入同一個程式碼項目。給它一個易於辨識的名稱。若要全站顯示小工具，請選擇 All pages；若要縮小上線範圍，請選擇 Choose specific pages。對於 All pages，請選擇 load on each page your visitor opens，如 Agentkit Wix 指南所指定。
- 在 Place Code in 下選擇 Body - end，然後點擊 Apply。Agentkit Wix 指南採用此放置位置。如果您已啟用 Agentkit 網域限制，請將已發佈的 Wix 網域加入允許清單。發佈您的 Wix 網站。
- 在全新的瀏覽器工作階段中，透過連結網域開啟已發佈的頁面。確認聊天按鈕顯示、可開啟並接受訊息。在手機大小的螢幕上重複測試。Wix 要求 Custom Code 必須在已發佈的網站上運作，因此請檢查已發佈的網址。
如果您之後變更網站的連結網域，請再次檢查 Custom Code 項目。Wix 表示程式碼片段與網域綁定，當指派的網域變更時會被刪除。必要時請重新安裝產生的程式碼。
若需固定的聊天面板，請改為在 Agentkit 中複製產生的 Iframe 程式碼。在 Wix 編輯器中，使用 Add Elements → Embed Code → Embed HTML，貼上 HTTPS iframe 程式碼，為桌面與行動裝置調整元素大小，發佈並測試線上頁面。Wix 的嵌入指南涵蓋此頁面元素。
邀請訪客前先檢查結果
以下是建議的驗收檢查，而非來自 Wix 安裝的結果。
| 檢查項目 | 記錄內容 | 通過條件 |
|---|---|---|
| 安裝 | 已發佈的 Wix 網址、桌面與行動裝置結果 | 按鈕在預期頁面上顯示且可開啟聊天 |
| 已核准的問題 | 問題、來源網址、預期回答、實際回答 | 回答與目前已核准的來源一致 |
| 未知問題 | 問題與實際回覆 | 機器人不會憑空捏造政策；約定的聯絡管道清楚明確 |
| 範圍 | 若使用特定頁面，一個包含與一個排除的 Wix 頁面 | 小工具僅在選定的位置顯示 |
| 網域 | 連結網域與 Agentkit 允許網域設定 | 已發佈的網域被允許且小工具可載入 |
如果按鈕未顯示，請先確認程式碼片段已啟用、網站已在連結網域上發佈、項目包含兩個產生的標籤，且所選的 Wix 頁面包含您開啟的頁面。如果 script 存在但小工具無法載入，請檢查 Agentkit 網域限制。如果按鈕正常但回答錯誤，請先檢查來源並在 Playground 中重新測試，再變更嵌入程式碼。
對於重要的來源變更，請重新訓練受影響的網站來源並重複已核准問題的檢查。排程更新或成功的爬取本身並不能確認訪客現在看到的回答。
邀請訪客前，請檢查已發佈的頁面、選定的聊天機器人與已核准的回答。如果您從零開始，請建立 Agentkit 聊天機器人，準備一小組公開來源，然後使用上述產生的程式碼。
