什么是嵌入
嵌入把智能体以<iframe> 的形式放进你自己的网站。网站访客无需登录 AskTable、不用选数据源或角色，打开页面就能用自然语言问数。
这是智能体对外的第四种方式，和频道、定时任务并列：频道接 IM，定时任务按计划推送，嵌入面向你网站上的匿名访客。
典型场景
- 在官网或帮助中心放一个「自助查数」入口，访客自己问、自己得到答案
- 在客户门户里嵌入一个只读某类数据的问数窗口
- 在内部 wiki 页里嵌入一个绑定固定角色的分析助手
配置要素
一个嵌入地址包含：| 要素 | 说明 |
|---|---|
| 名称 | 地址的显示名，仅用于你在后台区分多个地址 |
| 绑定角色 | 必填。地址绑定一个固定角色（含固定角色变量），所有匿名访客都在这个角色的数据范围内提问，看到相同的数据边界 |
| 可信域名 | 开关 + 域名白名单。关（默认）= 不校验来源，任何网站都可嵌入；开 = 只有白名单里的域名可以嵌入该地址 |
| 启用 | 开关。新建即启用、立即可用；停用后正在进行的会话立即断开 |
如何配置
访客体验
访客打开嵌入页后：- 无需登录，也不用选数据源或角色，直接在输入框提问
- 只能在地址绑定的角色数据范围内得到回答
- 可在快速 / 深度思考之间切换（初始为快速，响应更即时）
- 24 小时内刷新页面会接着同一个对话；超过则自动开始新对话，也可随时点【新对话】重新开始
安全模型
嵌入面向匿名公网访客，安全靠这几层：- 固定角色数据范围 — 访客只能问到绑定角色允许的数据；改角色只影响之后新建的对话
- 不可猜的地址 ID — 地址 ID 是随机串（
emb_前缀），不暴露枚举 - 可信域名白名单 — 打开【可信域名】后，只有白名单域名的页面能嵌入
- 禁用即停 — 停用地址后，正在进行的会话立即断开
嵌入是公开入口。绑定角色时，请确认该角色的数据范围适合对外公开。
嵌入 vs 频道
两者都让外部用户用智能体，但形态不同：- 频道：接入飞书等 IM，用户在 IM 里对话
- 嵌入：以 iframe 放进你的网站，面向匿名网页访客，绑定一个固定角色，所有人看到相同的数据范围