安装到网站
一次嵌入启动脚本,再从门户管理授权网站和显示页面。
最近核对
安装前
需要管理员访问安装设置,以及维护者编辑公共 HTML 或全站脚本配置的权限。启动脚本在 iframe 中打开聊天,隔离宿主样式,不替换网站已有表单或内容。
复制脚本
在安装中复制工作区代码,一次加入共享模板,通常放在 body 结束标签前。
<script src="https://preview.runsagents.com/launcher.js" data-tenant="your-workspace"></script>
这是结构示例,工作区标识只是占位符,请使用实际复制代码。单页应用路由变化时不要重复注入脚本。
授权网站来源
来源包含协议、主机和可选端口,不含路径。https://example.com 与 https://www.example.com 在安装授权中不同;HTTP、HTTPS、子域名、端口也各自独立。没有授权网站时不会在外部网站显示。
页面规则
| 策略 | 行为 |
|---|---|
| 每个页面 | 授权来源内全站显示。 |
| 仅这些页面 | 只在匹配路径显示。 |
| 除这些页面外 | 在匹配路径隐藏。 |
规则可匹配本页或本页及子页。/support 包含 /support/contact,不包含 /supporters。查询参数与片段不参与匹配。
配置可能短暂缓存,已打开页面没有实时推送。保存后重新加载核实。单页应用有意义的路径变化会重新评估显示条件。
加载和安全策略
如果网站限制资源,需在脚本和框架策略中允许相应 Runs Agents 来源,启动器也会请求公开配置。应检查具体被阻止请求,不要整体关闭内容安全策略。
聊天自身的框架策略也检查来源授权,直接嵌 iframe 不能替代设置。隐私插件、存储限制、代理或浏览器政策也可能影响加载和恢复。
验证
在桌面和手机打开允许页面,检查启动、隐私提示、虚构提问、关闭重开、导航重载和草稿恢复。检查排除页面,并确认记录进入正确工作区。位置在预览中保存。
移除嵌入应从公共模板删除脚本;门户的网站授权和页面规则可控制显示。