You need to enable JavaScript to run this app.
实时音视频

实时音视频

请输入
  • 文档首页
    • 实时音视频硬件对话智能体快速集成获取开发凭证
复制全文
我的收藏
快速集成
获取开发凭证
复制全文
我的收藏
获取开发凭证

本文将引导您完成硬件对话智能体服务的云端配置。完成本文操作后，您将获取硬件开发必需的关键凭证，为后续设备端集成做好准备。

相关概念

在开始之前，请理解以下相关概念：

  • 产品：用于标识和管理一组具有相同特征的设备。一个产品对应一个硬件型号。
  • License：设备接入服务的商业授权凭证。一个 License 对应一台物理设备，设备激活时会与 License 绑定。
  • 智能体：负责处理用户请求、逻辑判断和生成回复的对话“大脑”。一个产品可关联多个智能体，一个智能体也可服务于多个产品。

前提条件

您已完成火山引擎账号注册和实名认证。

操作步骤

第一步：开通服务与授权

  1. 登录 硬件对话智能体控制台，按界面提示开通服务。

  2. 完成跨服务访问授权。
    请前往 实时对话式 AI 控制台 的 跨服务授权 页面完成跨服务访问授权。授权成功后，您可以在 访问控制 的 角色管理 列表中查看 VoiceChatRoleForRTC 服务角色。

    硬件对话智能体访问关联的火山引擎云服务时，将通过该角色获取相应权限。若该角色不存在，将导致跨服务访问失败，影响部分进阶功能的使用（如长期记忆库）。

    Image

第二步：搭建智能硬件

  1. 登录 硬件对话智能体控制台。
  2. 在 概览 页，单击 搭建智能硬件。
  3. 根据配置向导完成以下操作：
    1. 创建产品：为即将开发的硬件设备创建一个产品，并填写相关信息。
      Image
      • 所属实例：选择默认的物联网实例即可。
      • 产品名称：填写产品的名称，例如“儿童伴读”。
    2. 分配 License：为已创建的产品分配 License。
      Image
      • 一个产品只能分配一种规格的 License。当该产品下的设备与硬件对话智能体服务端成功建连时，设备将会激活，每台设备会自动绑定并消耗一个 License 配额。
      • 不同规格的 License 内置了不同额度的资源（如语音时长、LLM Tokens）。建议您根据预估的用户使用频率选择合适的 License 规格，并根据预期的设备销售总量规划 License 数量。
      • 开通服务后，您会自动获得 10 个免费的基础版 License。如需更多资源，可按需购买 License 和扩展资源。
    3. 关联智能体：选择一个智能体与产品关联。
      Image
      您可以选择 创建智能体（创建一个全新的对话大脑），或者关联已有智能体（从列表中选择）。
      首次使用建议选择默认智能体。后续可根据需要创建更多智能体，详情请参见智能体管理。
    4. 获取 SDK
      控制台提供设备端 SDK 访问入口。建议您先阅读官方 SDK 集成指引，确定最适合的方案后，再下载对应 SDK 或查看协议文档。
      Image

开发凭证与参数

云端配置完成后，请在控制台获取并妥善保管以下开发凭证。这些凭证是后续设备端开发的必需品。为了帮助您更好地理解各凭证在不同场景下的映射关系，请参考下表：

控制台显示名称

变量名

说明

获取途径

实例 ID

InstanceID

标识物联网实例。

进入您创建的产品详情页获取相关信息。

Image

ProductKey

product_key

标识您的产品型号。

ProductSecret

product_secret (用于签名)

用于生成设备注册和连接签名，严禁硬编码在设备端。

智能体 ID

bot_id / bot

标识设备关联的智能体。

进入智能体管理页获取产品关联的智能体 ID。

注意

必须使用与产品关联的智能体。

Image

设备名称

device_name

由您自定义，用于唯一标识单个设备。请确保其在同一产品下唯一，推荐使用设备的 MAC 地址或序列号（SN）。

不涉及

最近更新时间：2025.12.30 10:34:39
这个页面对您有帮助吗？
有用
有用
无用
无用