文档 - 网站嵌入
把智能体嵌入你的网站
把智能体放到你自己的网站上，访客不需要 WukongDojo 账号就能直接对话。这部分流量的费用从你的钱包扣除，上限是你设定的每日预算。
1. 两种嵌入方式
| 方式 | 访客看到什么 | 适合 |
|---|---|---|
| 悬浮小组件（默认） | 右下角固定一个聊天按钮，点开是聊天面板——手机上全屏，电脑上是浮动卡片；翻页后仍记得面板是开着还是关着。 | 大多数网站。一行 script 标签，不用调尺寸。 |
| 内联 iframe | 聊天窗口嵌在页面里你指定的位置。 | 希望聊天放在某一栏或首屏区域的文档页、落地页。 |
2. 开始之前
智能体必须是 Unlisted（不公开）或 Public（公开）。Private（私有）智能体的嵌入永远显示离线。修改可见性见「发布」一文。
嵌入设置在智能体编辑页：打开智能体，点「编辑」，进入「渠道」区域，找到「嵌入到你的网站」。只有 Owner 能看到。
3. 开启嵌入
- 勾选「启用网站嵌入」。
- 设置「每日预算（美元）」——见第 4 节。
- 在「添加域名」里填你的网站地址，例如
https://example.com——只填协议和域名，不带路径和查询参数。主域名和www.版本会一起生效；其他子域名（例如docs.example.com）要单独添加。 - 每个域名都有自己的嵌入代码。点「复制」，粘贴到你网站 HTML 的
</body>之前：
<script src="https://www.wukongdojo.ai/api/worker/embed/<embed-id>/widget.js" async></script>
想内联？点代码下方的「或以内联方式嵌入（iframe）」，把那段代码贴到你希望聊天出现的位置，宽高按你的版面调整：
<iframe src="https://www.wukongdojo.ai/api/worker/embed/<embed-id>"
style="width:100%;max-width:420px;height:600px;border:0;border-radius:12px"></iframe>嵌入代码只在它对应的域名上有效。别人把它复制到其他网站，浏览器会拒绝加载。
4. 谁付费，以及每日预算
访客不付费，也不需要登录。所有嵌入对话都由你（智能体 Owner）从你的 WukongDojo 钱包付费。
每日预算是这部分花费的上限。访客每发一条消息，从当天预算里计 $0.0015，所以 $1 大约够 660 条消息。实际按真实成本扣费，长回答可能略高于这个数。当天预算用完后嵌入会暂停，到第二天（UTC 零点）自动恢复。把预算设为 0 即可暂停嵌入，不用删除任何东西。
为防止单个访客耗光预算，每个访客还有每分钟 20 条、每天 300 条的上限。
5. 访客看到什么
当嵌入无法回答时——预算用完、你的钱包没钱了、或访客发得太快——访客会看到「This chat is outside office hours right now — please try again later.」。价格、钱包、预算这些信息永远不会展示给访客。
访客按浏览器识别。回访的访客能看到自己最近 20 条消息。如果 30 分钟没有新的回复，他们下一条消息会为智能体开启一段新对话，但之前的消息仍显示在上方。
6. 撤销域名
点域名旁的「撤销」，该网站立刻失去访问权限。小组件会安静地消失，不会弄坏你的页面：悬浮按钮不再出现，内联 iframe 显示离线。取消勾选「启用网站嵌入」则对所有域名同时生效。
重新添加同一个域名会生成新的嵌入代码。把新代码贴到网站上——旧代码不会再恢复。