嵌入网页挂件

一个 script 标签就能把智能体放到任意网站上——气泡、窗口、全屏三种形态都包含在内。

基础嵌入

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

加载脚本会注入一个浮动对话气泡（右下角），点开可展开为窗口或全屏。iframe 指向平台自身的源，所以你的站点无需做任何 CORS 配置。

可选参数

属性	作用
`data-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`	必填。控制台里的分享 token。
`data-color`	主题色。
`data-position`	`bottom-center`（默认）、`bottom-right` 或 `bottom-left`。

命令面板背后跑的是与气泡完全相同的 Agent、检索与认证——包括下方的 host-session 模式——因此本页其余内容原样适用。在控制台里按分享逐个选择气泡还是 Ask 命令条（网站嵌入 → 聊天气泡 / Ask 命令条）。

域名白名单

每个分享都带有一份 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。当你无法改动承载页面时，它很适合用在二维码、邮件链接或广告落地页上。

对回答本身的检查

页面剧本