需通过四步集成腾讯元宝智能体：一、在元器平台发布智能体并复制小程序路径；二、在微信公众平台申请半屏打开权限；三、用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({
Codapp 外卖点餐系统是一款专为快餐店、奶茶店、咖啡店、糕点店等商户打造的移动点餐解决方案，支持自提与外卖两种模式，可快速部署上线使用。 该系统支持微信、支付宝支付，并接入腾讯地图与百度地图，支持第三方配送（如达达）与商家自主配送，助力门店实现智能点单与订单管理。 功能特点： 微信小程序&H5移动端双端点餐：无需下载 App，直接扫码下单 支持多门店管理：一套系统可管理多家门
appId: 'wxf8b1a9c5d6e7f8a9',
path: '/pages/agent/agent?agentId=abc123xyz',
extraData: { from: 'myApp' },
envVersion: 'release'
});
4、其中appId必须填写腾讯元宝小程序的正式版AppID：wxf8b1a9c5d6e7f8a9，不可使用测试号或开发版ID。
四、配置request合法域名并启用联网能力
若智能体在运行中需调用外部API（如天气、支付、知识库更新等），小程序前端发起网络请求时，必须将对应域名加入request合法域名白名单，否则请求将被微信拦截。
1、登录微信公众平台，进入“开发管理” > “开发设置” > “服务器域名”。
2、在“request合法域名”栏中，添加腾讯元宝开放平台接口域名：https://api.yuanbao.tencent.com 及其子路径所依赖的其他必要域名（如知识库上传接口、插件回调地址等）。
3、保存后，需重新上传小程序代码并提交审核，新域名才生效。
五、本地调试与真机验证关键步骤
微信开发者工具模拟环境与真机存在行为差异，尤其是wx.openEmbeddedMiniProgram接口仅在真机上可触发半屏浮层，工具中仅提示“调试模式下不可用”，因此必须进行实机验证。
1、在开发者工具中点击“预览”，使用微信扫码，确保二维码绑定的是已开通半屏权限的开发者微信号。
2、在真机微信中打开小程序，点击嵌入按钮，观察是否弹出半屏元宝智能体界面。
3、若失败，检查控制台报错信息；常见错误包括：“errCode: -1, errMsg: openEmbeddedMiniProgram:fail no permission”，表明半屏权限未生效或AppID填写错误。
4、确认智能体路径中的agentId参数与发布时完全一致，大小写及特殊字符均不可修改。
