本文档介绍在接入百语（BR-Voice）SDK 或 API 实现语音通话功能前，需要完成的准备工作，包括智能体创建与鉴权信息获取。请按照本文档步骤完成配置后，再进行后续的 SDK 集成或 API 调用开发。

​
一、接入前提

在使用百语 SDK 或 API 之前，请确保您已完成以下准备：
  • 已注册百融百语平台账号，并拥有智能体创建与发布权限；
  • 已明确业务场景，确定需要创建的智能体类型（自主规划 Agent 或端到端语音 Agent）；
  • 完成智能体创建并发布后，方可获取 SDK / API 鉴权所需的 robotKey 和 robotToken。

​
二、创建并发布百语智能体

登录百融百语平台，创建用于语音通话的智能体并完成发布。 步骤 1：登录百融百语平台，进入工作台。 步骤 2：点击左侧「创建智能体」按钮，根据业务场景选择智能体类型：
  • 端到端语音 Agent：适用于实时语音对话场景，推荐语音通话接入使用；
  • 自主规划 Agent：适用于需要复杂任务规划、工具调用的场景。
步骤 3：完成 Agent 的人设、知识库、音色等配置后，点击「发布」按钮。 ⚠️ 注意：发布时，发布平台必须勾选「API 调用」选项，否则将无法获取 robotKey 和 robotToken，导致 SDK / API 鉴权失败。 步骤 4：发布成功后，按照下一节步骤获取鉴权所需的 robotKey 和 robotToken。

​
三、获取核心鉴权信息（robotKey、robotToken）

robotKey 和 robotToken 是调用百语 SDK / API 的核心鉴权凭证，请妥善保管，避免泄露。获取步骤如下： 图 1：在工作台点击「更新发布平台」 步骤 2：在弹出的发布平台配置中，选择「API 调用」渠道，点击「查看」按钮。 步骤 3：在「接口密钥」弹窗中，即可查看并复制 robotToken（Token）和 robotKey（智能体标识）。 图 2：获取 robotToken 与 robotKey

​
四、注意事项

  • 密钥安全：robotKey 和 robotToken 是访问您智能体的唯一凭证，请勿在客户端代码、公开仓库或前端页面中硬编码；建议通过服务端代理调用，避免密钥泄露。
  • 发布状态：智能体必须处于「已发布」状态且开启「API 调用」渠道，才能正常使用 SDK / API 接入；草稿状态下无法获取有效密钥。
  • Agent 类型选择：语音通话场景推荐使用「端到端语音 Agent」，延迟更低、语音交互体验更佳；若需要复杂任务编排，可选择「自主规划 Agent」。
  • 密钥重置：如密钥不慎泄露，请及时在平台重新生成并更新到您的服务中，旧密钥将失效。

​
五、下一步

获取 robotKey 和 robotToken 后，您可以：
  • 参考《百语 SDK 接入指南》，在客户端 / 设备端集成语音通话能力；
  • 参考《百语 API 文档》，通过服务端接口直接调用智能体能力；
  • 如有接入问题，请联系百语技术支持团队，邮箱：di.li@brgroup.com。