在Zion页面嵌入Coze智能体需通过OAuth鉴权的【Coze Bot容器】组件实现,禁用iframe直嵌;配置Bot ID与OAuth公钥,补全私钥;支持全屏、悬浮窗、内联三种嵌入模式;需开启“接收外部消息”并设置行为流联动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

在Zion页面中嵌入Coze智能体
要把用函子Zion搭建的智能体真正展示在网页前端,必须通过OAuth鉴权方式将Coze Bot界面安全映射到Zion页面容器内,不能直接iframe嵌入或跳转外部链接——否则会触发跨域拦截且无法传递用户身份。
第一步:进入Zion项目编辑器,在左侧组件库搜索栏输入「智能体」,拖拽【Coze Bot容器】组件到画布任意位置。该组件是Zion专为Coze集成设计的原生容器,自动处理鉴权握手与消息透传。
第二步:选中刚拖入的组件,在右侧属性面板填写两项必填字段:【Bot ID】(从Coze体验页URL中/bot/后的一串数字获取)和【OAuth公钥】(需提前在Coze开发者后台创建OAuth应用并复制公钥)。漏填任一字段会导致组件加载为空白页且无报错提示。
第三步:点击组件右上角「预览配置」按钮,系统会弹出模拟对话窗口。此时若显示“正在连接智能体…”但3秒后卡住,说明私钥未在Zion后台完成绑定——需前往项目设置→API管理→Coze OAuth密钥处补全私钥并保存。
让智能体适配不同页面区域
Zion的Coze容器支持三种嵌入模式,根据你的页面布局需求选择其一:
方法一:全屏对话页——将容器宽度设为100%、高度设为100vh,勾选「隐藏标题栏」,适用于独立AI客服页;
方法二:侧边悬浮窗——宽度设为360px、高度设为600px,开启「固定定位」并设置bottom: 30px、right: 30px,适合嵌入在内容页右下角;
方法三:内联卡片式——宽度设为100%、高度设为400px,关闭「自动滚动到底部」,保留顶部标题栏,适合放在文章末尾作为互动延伸模块。
注意:iOS微信内置浏览器对iframe高度计算存在兼容问题,若选择方法二或三,请务必在Zion发布前勾选「启用移动端高度自适应」开关,否则悬浮窗在iPhone上可能被截断。
配置智能体与页面其他组件联动
第一步:在页面中添加一个【文本输入框】组件,用于接收用户初始提问关键词;
第二步:选中该输入框→点击右上角「行为流」→新建触发动作→选择「用户提交」→添加动作「向Coze Bot发送消息」;
第三步:在动作参数中,将「消息内容」设为「输入框值」,并勾选「清空输入框」;
第四步:回到Coze Bot容器组件→打开「高级设置」→开启「接收外部消息」开关。这一步不做,前面配置的联动完全失效,Bot不会响应页面其他组件传来的指令。
第五步:测试时,在输入框里打字后按回车,观察Bot容器是否立即发起首条回复。如果无反应,检查行为流中「向Coze Bot发送消息」动作是否被误设为「仅首次触发」——应改为「每次触发」。


















