需完成模型授权、API密钥配置与智能体绑定三步闭环操作：先在个人账户下获取混元API密钥并保存SecretKey；再通过【模型供应商】安装或【编排】页选择混元版本（函数调用必选Hunyuan-Pro）；最后在【调试】页测试Prompt验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在腾讯云智能体开发平台中接入腾讯混元大模型，需完成模型授权、API密钥配置与智能体绑定三步闭环操作，缺一不可。
获取混元API密钥
登录腾讯云控制台 → 进入【大模型服务】→ 点击【API密钥管理】→ 选择【创建密钥】→ 勾选【混元大模型】权限 → 提交生成 SecretId 与 SecretKey。
这一步必须在【个人账户】下操作，【企业子账号默认无权限，需主账号授权 QcloudHunyuanFullAccess 策略】。生成后立即复制保存，页面刷新后 SecretKey 将不可再次查看。
在智能体平台配置混元模型
方法一：通过「模型供应商」页面安装
进入腾讯云智能体开发平台 → 左侧导航栏点击【设置】→ 【模型供应商】→ 找到「腾讯混元」卡片 → 点击【安装】→ 在弹窗中填入上一步获取的 SecretId 和 SecretKey → 点击【保存】。
方法二：直接在智能体编辑页调用（适用于已安装供应商的用户）
腾讯云通用文字识别（高精度版）技能包。用户发送/粘贴图片、提供图片URL或要求识别图片文字时自动调用。支持中文、英文、中英混合、数字及特殊符号的检测与识别，返回文字框位置与内容。适用于文字较多、版式复杂、准召率要求高的场景。
新建或打开已有智能体 → 进入【编排】页签 → 添加「大模型节点」→ 模型类型选择「腾讯混元」→ 下拉选择具体版本（如 Hunyuan-Standard、Hunyuan-Turbo 或 Hunyuan-Pro）→ 保存节点。
注意：Hunyuan-Turbo 仅支持文本生成类任务，若智能体需调用函数回调（如查数据库、发邮件），必须选用 Hunyuan-Pro 版本，【其他版本调用将静默失败，不报错也不执行】。
测试混元模型是否生效
第一步：在智能体【调试】页签中，输入测试 Prompt，例如“请用中文写一首关于秋天的五言绝句”。
第二步：点击【运行】，观察右侧响应区域是否返回结构化 JSON 数据，且 content 字段含有效文本输出。
第三步：若返回 error: "Unauthorized"，说明 SecretKey 错误或未生效，需重新检查密钥是否复制完整、是否粘贴进错误字段；若返回 error: "Model not found"，说明所选模型名称与当前可用列表不一致，需回到【模型供应商】页面确认已安装对应版本。
