嵌入網頁小工具

一行 script 標籤，就能把你的代理放上任何網站，內建氣泡、視窗與全螢幕三種模式。

基本嵌入

<script src="https://chat.agent4.io/ui/embed.js"
        data-token="YOUR_SHARE_TOKEN" async></script>

載入器會在右下角放上一個浮動對話氣泡，點開可展開成視窗或全螢幕。iframe 指向平台網域，所以你的網站不需要另外設定 CORS。

選項

屬性	作用
`data-token`	必填。主控台產生的 share token。
`data-color`	小工具標題列與氣泡的主色。
`data-position="left"`	把氣泡改停在左下角，而非右下角。

鍵盤操作：Ctrl/⌘ + Shift + F 可在氣泡、視窗、全螢幕之間循環切換。

命令面板（Ask 命令列）

更喜歡文件站上那種現代的「Ask a question」互動？把 embed.js 換成 ask.js 即可——同樣一行指令碼，其他都不用改：

<script src="https://chat.agent4.io/ui/ask.js"
        data-token="YOUR_SHARE_TOKEN" async></script>

這會在頁面底部注入一根細長的 Ask a question 列。點它——或在頁面任意位置按 ⌘K / Ctrl+K——它便展開成壓暗背景上的一個螢幕置中命令面板；按 Esc 或點空白處關閉。這根列不是寫死的標籤：它會打字機式地逐條打出訪客在這個頁面上最可能問的問題（取自與氣泡建議問題同一套頁面劇本）。

參數	作用
`data-token`	必填。主控台裡的 share token。
`data-color`	主題色。
`data-position`	`bottom-center`（預設）、`bottom-right` 或 `bottom-left`。

命令面板背後跑的是與氣泡完全相同的 Agent、檢索與驗證——包括下方的 host-session 模式——因此本頁其餘內容原樣適用。在主控台裡按 share 逐個選擇氣泡還是 Ask 命令列（網站嵌入 → 聊天氣泡 / Ask 命令列）。

網域白名單

每個 share 都帶有一份 allowed_domains 清單。平台會以 frame-ancestors CSP 強制執行，因此小工具只會在你列出的網站中顯示。設定位置在主控台的 share 上。

驗證模式

一個 share 會以下列三種模式之一運作：

匿名 — 訪客不需帳號即可對話，每個瀏覽器各自擁有一個空間。
帳號登入 — 訪客以平台終端使用者帳號登入，紀錄與記憶會跨裝置跟著他走。
主站工作階段（HMAC） — 由你的後端告訴小工具這位使用者是誰，讓已登入的使用者不必再登入第二次：

<script src="https://chat.agent4.io/ui/embed.js"
        data-token="YOUR_SHARE_TOKEN"
        data-uid="user-42"
        data-ts="1767139200"
        data-sig="HMAC_SHA256(secret, uid + ts)"
        async></script>

data-sig 由你的伺服器以該 share 的簽章密鑰計算，平台驗證後會把 user-42 對應到一個固定的終端使用者身分。

獨立頁面

每個 share 同時也是一個完整頁面，網址為 https://chat.agent4.io/s/YOUR_SHARE_TOKEN。當你無法掌控網站本身時，這很適合用在 QR code、email 連結或廣告到達頁。

對回答本身的檢查

頁面劇本