渠道接入
嵌入网页挂件
一个 script 标签把智能体放上任意网站——含气泡、窗口与全屏三种形态。
基础嵌入
<script src="https://chat.agent4.io/ui/embed.js"
data-token="YOUR_SHARE_TOKEN" async></script>加载器会在页面右下角注入一个悬浮气泡，可展开为窗口或全屏。iframe 指向平台域名，宿主站点无需任何 CORS 配置。
选项
| 属性 | 作用 |
|---|---|
data-token | 必填。 控制台里创建的分享 token。 |
data-color | 挂件头部/气泡的主题色。 |
data-position="left" | 气泡停靠在左下角。 |
快捷键：Ctrl/⌘ + Shift + F 循环切换 气泡 → 窗口 → 全屏。
域名白名单
每个分享带有 allowed_domains 列表，平台用 frame-ancestors CSP 强制执行——挂件只会在你列出的站点内渲染。在控制台的分享设置里配置。
鉴权模式
分享可运行在三种模式之一：
- 匿名——访客无需账号即可对话，每个浏览器有独立空间。
- 账号登录——访客用平台终端用户账号登录，历史与记忆跨设备跟随。
- 宿主会话（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，平台校验后把 user-42 映射为稳定的终端用户身份。
独立整页
每个分享同时提供整页形态：https://chat.agent4.io/s/YOUR_SHARE_TOKEN——适合二维码、邮件链接或广告落地页等你不控制宿主站点的场景。