You need to enable JavaScript to run this app.
文档中心
实时音视频

实时音视频

复制全文
下载 pdf
快速集成
获取开发凭证
复制全文
下载 pdf
获取开发凭证
本文将引导您完成硬件对话智能体服务的云端配置。完成本文操作后,您将获取硬件开发必需的关键凭证,为后续设备端集成做好准备。​
相关概念​
在开始之前,请理解以下相关概念:​
  • 产品:用于标识和管理一组具有相同特征的设备。一个产品对应一个硬件型号。​
  • License:设备接入服务的商业授权凭证。一个 License 对应一台物理设备,设备激活时会与 License 绑定。​
  • 智能体:负责处理用户请求、逻辑判断和生成回复的对话“大脑”。一个产品可关联多个智能体,一个智能体也可服务于多个产品。​
前提条件​
您已完成火山引擎账号注册和实名认证。​
操作步骤​
第一步:开通服务与授权​
  1. 登录 硬件对话智能体控制台,按界面提示开通服务。​
  1. 完成跨服务访问授权。​
  • 请前往 实时音视频控制台 的 跨服务授权 页面完成跨服务访问授权。授权成功后,您可以在 访问控制 的 角色管理 列表中查看 VoiceChatRoleForRTC 服务角色。​
硬件对话智能体访问关联的火山引擎云服务时,将通过该角色获取相应权限。若该角色不存在,将导致跨服务访问失败,影响部分进阶功能的使用(如长期记忆库)。​
​图片​​
第二步:搭建智能硬件​
  1. 在 概览 页,单击 搭建智能硬件。​
  1. 根据配置向导完成以下操作:​
  1. 创建产品:为即将开发的硬件设备创建一个产品,并填写相关信息。​
  • ​图片​​
  • 所属实例:选择默认的物联网实例即可。​
  • 产品名称:填写产品的名称,例如“儿童伴读”。​
  1. 分配 License:为已创建的产品分配 License。​
  • ​图片​​
  • 一个产品只能分配一种规格的 License。当该产品下的设备与硬件对话智能体服务端成功建连时,设备将会激活,每台设备会自动绑定并消耗一个 License 配额。​
  • 不同规格的 License 内置了不同额度的资源(如语音时长、LLM Tokens)。建议您根据预估的用户使用频率选择合适的 License 规格,并根据预期的设备销售总量规划 License 数量。​
  • 开通服务后,您会自动获得 10 个免费的基础版 License。如需更多资源,可按需购买 License 和扩展资源。​
  1. 关联智能体:选择一个智能体与产品关联。​
  • ​图片​​
  • 您可以选择 创建智能体(创建一个全新的对话大脑),或者关联已有智能体(从列表中选择)。​
  • 首次使用建议选择默认智能体。后续可根据需要创建更多智能体,详情请参见智能体管理。​
  1. 获取 SDK​
  • 控制台提供设备端 SDK 访问入口。建议您先阅读官方 SDK 集成指引,确定最适合的方案后,再下载对应 SDK 或查看协议文档。​
  • ​图片​​
开发凭证与参数​
云端配置完成后,请在控制台获取并妥善保管以下开发凭证。这些凭证是后续设备端开发的必需品。为了帮助您更好地理解各凭证在不同场景下的映射关系,请参考下表:​
​
控制台显示名称​
变量名​
说明​
获取途径​
实例 ID​
InstanceID​
标识物联网实例。​
进入您创建的产品详情页获取相关信息。​
​图片​​
ProductKey​
product_key​
标识您的产品型号。​
​
ProductSecret​
product_secret (用于签名)​
用于生成设备注册和连接签名,严禁硬编码在设备端。​
​
智能体 ID​
bot_id / bot​
标识设备关联的智能体。​
进入智能体管理页获取产品关联的智能体 ID。​
警告​
必须使用与产品关联的智能体。​
​图片​​
设备名称​
device_name​
由您自定义,用于唯一标识单个设备。请确保其在同一产品下唯一,推荐使用设备的 MAC 地址或序列号(SN)。​
不涉及​
​
​
​
最近更新时间:2026.09.09 17:39:16
这个页面对您有帮助吗?
有用
有用
无用
无用