asyntai/agent-skills

使用 Asyntai 加入 AI 聊天機器人

Asyntai 可在網站中加入 AI 支援代理。它會根據網站自身的內容回答訪客的問題，支援 80 多種語言，並在必要時轉接給真人客服。對話功能只需要一個 script 標籤，因此安裝過程只會有一小段程式碼更動。

步驟 1：取得 widget ID

每次安裝都需要網站的 widget ID。它看起來像是 asyntai_ 後面接著 12 個字母和數字，例如 asyntai_1a2b3c4d5e6f。

1. 找找看使用者是否已經提供了一個 ID，或者專案中是否已經存在（搜尋程式碼中的 data-asyntai-id）。如果網站已經有這段程式碼，請不要重複加入。
2. 如果 Asyntai MCP 伺服器已連線，請呼叫 list_websites。每個網站都有一個 widget_id。
3. 否則，請向使用者詢問。告訴他們在哪裡可以找到：在 https://asyntai.com/dashboard 登入，開啟「Install」頁面，然後從程式碼片段中複製 data-asyntai-id 的值。
4. 如果使用者沒有帳戶，可以在 https://asyntai.com/auth/ 免費建立一個。免費方案足以試用聊天機器人。

絕對不要自行編造 widget ID。如果沒有可用的 ID，請在程式碼中放入佔位符 YOUR_WIDGET_ID，並告訴使用者自行替換。

步驟 2：找出網站的建置方式

• 託管建置器或 CMS（WordPress、Shopify、Wix、Webflow、Squarespace、HubSpot、Ghost、Moodle 等）：使用者應在該平台的管理後台安裝小工具，而非修改程式碼。請在 references/platforms.md 中找到該平台，然後提供使用者該指南的連結及簡短步驟。
• 程式碼專案：檢查 package.json、設定檔及資料夾結構，然後依照 references/frameworks.md 操作。該檔案包含每個技術棧的確切修改方式，以及靜態網站和文件工具的 Asyntai 套件。

步驟 3：加入程式碼片段

這是官方程式碼片段。請保持原樣，只更改 YOUR_WIDGET_ID：

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

它會等待頁面 load 事件，因此不會拖慢頁面載入速度。請將這段程式碼放在每個頁面都使用的共用佈局中（</body> 之前或 <head> 內）。不要放在某個單一頁面元件中，否則對話功能只會出現在那個頁面上。

步驟 4：檢查結果

1. 執行網站（或建置）並開啟一個頁面。
2. 對話按鈕會出現在角落。小工具會在 #asyntai-widget-host-<widget ID> 元素內繪製。在瀏覽器主控台中，document.querySelectorAll('script[data-asyntai-id]').length 必須為 1。
3. 如果按鈕沒有出現：

   • 檢查瀏覽器主控台是否有「Asyntai Widget:」錯誤。

   • 如果網站設有內容安全政策 (CSP)，必須允許下列來源：

     指令	來源
     script-src	https://widget.asyntai.com https://asyntai.com（以及程式碼片段所需的 'unsafe-inline'，或使用 references/frameworks.md 中的短格式）
     connect-src	https://asyntai.com
     style-src	'unsafe-inline'
     img-src	data: https://flagcdn.com

步驟 5：告知使用者後續步驟

小工具會根據使用者在 Asyntai 儀表板 (https://asyntai.com/dashboard) 中新增的內容來回答問題。請告知使用者：

• 將網站頁面、檔案或文字新增為知識庫，
• 在儀表板上設定代理名稱、顏色和問候語，
• 閱讀完整指南：https://asyntai.com/documentation/installation/。

如果 Asyntai MCP 伺服器已連線，你可以幫他們完成這項設定。請參閱 manage-ai-support-agent 技能。