需通过四步集成腾讯元宝智能体:一、在元器平台发布智能体并复制小程序路径;二、在微信公众平台申请半屏打开权限;三、用wx.openEmbeddedMiniProgram接口调用,填入指定AppID和路径;四、配置合法域名并真机验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已开发完成微信小程序,希望将腾讯元宝智能体能力集成进小程序中供用户直接调用,则需通过官方支持的嵌入机制实现。以下是具体操作路径:
一、确认前置条件并完成元宝智能体发布
在嵌入前,必须确保智能体已在腾讯元器平台(yuanqi.tencent.com)创建并成功发布,且已获取该智能体的唯一小程序路径。该路径是后续在开发者工具中配置的关键参数,未发布则无法生成有效路径。
1、登录腾讯元器平台,进入“我的智能体”列表页。
2、找到目标智能体,点击右侧“发布”按钮,按提示完成发布流程。
3、发布成功后,在智能体详情页点击“使用方式”,展开“小程序嵌入”模块。
4、复制显示的完整小程序路径,格式类似:/pages/agent/agent?agentId=xxxxx。
二、在微信公众平台申请半屏打开权限
微信要求第三方小程序调用腾讯元宝小程序时,必须开通“半屏打开”能力,否则调用将被拦截。该权限需在小程序管理后台手动提交申请,并经微信审核通过后方可生效。
1、登录微信公众平台,进入目标小程序的“开发管理” > “开发设置”页面。
2、向下滚动至“第三方服务”区域,点击“申请半屏打开权限”按钮。
3、在弹窗中选择“腾讯元宝小程序”作为服务方,填写申请理由,如“用于嵌入已发布的元宝智能体,提升用户AI交互体验”。
4、提交后等待微信审核,通常需1–3个工作日,状态可在同一页面查看。
三、在微信开发者工具中调用wx.openEmbeddedMiniProgram接口
该接口是微信官方提供的标准嵌入方式,允许当前小程序以半屏浮层形式唤起腾讯元宝小程序,并自动跳转至指定智能体路径,无需用户手动搜索。
1、在小程序代码中,于需要触发嵌入的位置(如按钮bindtap事件)编写调用逻辑。
2、确保已声明所需权限,在app.json的”permission”字段中添加:{“scope.openEmbeddedMiniProgram”: {“desc”: “用于打开元宝智能体”}}。
3、调用代码示例(JS部分):
wx.openEmbeddedMiniProgram({