本文介绍如何在网易云信智能体管理平台为应用创建、配置和测试智能体，并为智能硬件设备绑定智能体。

平台介绍

网易云信智能体管理平台是面向开发者和企业用户的 Web 端管理工具。通过该平台，您可以：

• 便捷管理智能体：直接在 Web 端创建、配置和管理您的 AI 智能体。
• 统一用户管理：集中管理所有用户信息和权限设置。
• 智能记忆管理：查看和管理智能体的长期记忆，包括块状记忆和结构化记忆。
• 对话历史追踪：完整查看用户与智能体的对话消息历史。
• 设备绑定管理：特别适合嵌入式设备场景的智能体应用。

无论您是首次接入 AI 智能体，还是已有成熟的智能硬件或应用场景，网易云信智能体管理平台都可以帮助您更高效地完成智能体配置、测试和设备绑定。

前提条件

在开始接入网易云信智能体管理平台之前，请确保您已经完成了以下准备工作：

• 如果您还没有注册 网易云信控制台 账号，请先注册企业账号。详情请参考 注册账号并登录控制台。
• 您需要在网易云信控制台创建您的应用，并获取唯一的密钥（App Key）作为应用的身份标识。详细步骤请参考 创建应用并获取 AppKey。
• 请确保已联系您的网易云信商务经理，为您的应用开通 AI 硬件智能体 服务，并根据您的产品目标市场选择中国大陆或海外数据中心。

管理智能体

第一步：登录管理平台

1. 打开 网易云信智能体管理平台。
2. 使用您在 网易云信控制台 注册的企业账号进行登录。
3. 登录成功后，您将进入智能体管理主界面。

第二步：选择 AppKey

1. 在页面顶部导航栏右上方，选择中国大陆、东南亚或欧美数据中心。

2. 在 AppKey 下拉菜单中选择您要管理的应用。

   

3. 选择完成后，系统将自动显示该 AppKey 下的所有智能体，包括：

   • 您创建的自定义智能体。
   • 系统预置智能体。
   • 必须先选择 AppKey 才能进行后续操作。
   • 如果您没有可用的 AppKey，请前往 网易云信控制台 创建应用。

第三步：创建或复制智能体

1. 单击配置区域的 添加智能体 按钮。

   

2. 您可以选择自定义创建或导入配置，自定义创建时，您可以根据智能体的应用场景，选择 普通模式、儿童模式、硬件助手模式。

   

3. 以下内容以自定义创建智能体为例，介绍表单中需要填写的信息：

   • 智能体名称：为您的智能体起一个易于识别的名称。
   • 角色设定：详细描述智能体的角色定位和功能特点。
   • 其他配置：可使用系统默认设置或根据需要自定义，主要包含以下模块：

     • 基础模型配置（LLM/TTS/ASR/Realtime）：设置大模型参数、选择 TTS 音色、配置语音识别灵敏度、断句策略以及语义 VAD（语音活动检测）。

     • Pipeline 配置：定义对话流控逻辑，包括打断策略、自定义开场白、休眠设置；同时可开启回声消除、AI 降噪、声纹识别及回调通知等音频处理功能。

     • 工具与扩展（Tools & MCP）：配置端侧注册工具以实现 Function Call（函数调用），或配置 MCP Server 接入以扩展服务能力。

     • Agent 模式配置：设置特定场景下的子交互模式（如“讲故事”、“互动游戏”），允许智能体在特定情境下跳出主角色设定进行互动。

     • 知识库配置：关联上传的文档，赋予智能体基于特定知识库回答问题的能力。

     • 情绪与状态设置：

       • 情绪交互：开启情绪识别、ASR 语气检测及 TTS 情绪控制，支持在端侧实时显示情绪状态。
       • 状态信息（亲密度）：配置亲密度等动态变量。亲密度用于衡量智能体对用户的信任度与情感安全感，系统将根据此变量动态调整智能体自我暴露的程度（即“真实度”）。
       

   以上内容描述的是中国大陆数据中心支持的智能体配置，如果您选择的是其他国家或地区数据中心，请以具体页面效果为准。

4. 完成填写后，单击 保存配置 按钮。

5. 保存后，您可以在右侧区域体验与智能体进行语音对话或文字对话的效果。

   如果您需要在配置阶段体验智能体文字对话效果，请确保您已经创建了至少一个用户。详细步骤请参考下文 用户管理。

6. 系统将自动保存并显示新创建的智能体。

第四步：体验智能体对话效果

1. 在智能体列表中找到需要体验的智能体。

2. 单击智能体卡片中的 配置角色 按钮。

   

3. 在编辑界面中，找到右侧对话测试区域，根据您的需求切换 语音对话测试 或者 文字对话测试。

   

第五步：智能体接入小派（可选）

如果您希望 C 端用户通过网易小派客户端体验该智能体，可以将已创建并测试通过的智能体接入小派。接入后，小派客户端会在用户完成设备配网后展示您推送的智能体，供 C 端用户查看和使用。

智能体接入小派为可选步骤，适用于需要使用网易小派微信小程序客户端作为 C 端承载入口的智能硬件场景。如果您的业务使用自有 App 或其他客户端承载 C 端体验，可跳过本步骤。

1. 在智能体列表中找到需要接入小派的智能体。

2. 单击智能体卡片右上角的 ... 按钮，在下拉菜单中选择 小派展示配置。

   

3. 在弹出的配置窗口中，完成网易小派 AI 展示信息配置：

   • 角色头像：选择系统提供的角色头像。
   • 角色名称：填写 C 端用户在小派客户端中看到的角色名称。
   • 唤醒词：填写用户在设备端唤醒该智能体时使用的唤醒词。
   • 展示状态：开放展示 代表将该智能体开放展示，开放后 代表将该智能体从当前应用拉取并展示。选择 下线 代表将该智能体下线，下线后 代表将该智能体从当前应用下线。
   • 默认角色：选择用户进入小程序后默认绑定的智能体角色。未显式设置默认角色时，服务端会按排序取第一个在线角色作为默认。
   

4. 确认信息无误后，单击 保存配置。

5. 系统将把当前 AppKey 下的智能体发布到小派客户端承载层。

6. 发布成功后，C 端用户在微信小程序中搜索 网易小派 AI，使用小派完成对应设备配网后，即可看到该智能体。

   
   • 仅支持通过适配了网易云信 AI 硬件智能体的设备接入网易小派，详情请参考 对接网易小派。如果您有硬件适配需求，请参考下文 硬件开发 或联系网易云信技术支持工程师。
   • 如果同一 AppKey 下接入了多个智能体，C 端展示顺序和默认角色以小派客户端实际配置为准。
   • 如果设备绑定时未找到可用的官方智能体或已接入智能体，可能导致绑定失败。请先确认智能体已成功接入小派，并确保设备归属关系配置正确。

第六步：修改智能体配置（可选）

1. 在智能体列表中找到需要修改的智能体。

2. 单击智能体卡片中的 配置角色 按钮。

   

3. 在编辑界面中修改智能体配置。

4. 完成修改后，单击 保存 按钮。

   系统内置智能体不支持编辑功能，只有您创建的自定义智能体可以进行修改。

用户管理

1. 单击左侧导航栏中的 用户管理 选项。

2. 进入全局用户管理界面，单击 添加用户 弹出添加用户弹窗，在弹窗中根据页面引导完成用户信息设置，然后单击 确定。

   

   添加了用户后，您可以在用户列表管理用户，包括用户设备管理、为用户录入声纹、为用户录入联系方式、编辑用户、添加子用户、删除用户。

   

对比测试智能体

除了在配置智能体时测试对话体验，您也可以在创建智能体和用户后，对多个智能体进行对比测试。

1. 在智能体卡片上，单击 对话测试。

   

2. 在对话框中，选择您创建的用户，选择需要对比的智能体。

   

3. 在对话框中，输入您的消息，然后单击发送。

至此，您已完成基础的智能体创建与对话测试。由于默认配置参数无法覆盖所有业务场景，网易云信建议您结合自身业务持续调整配置，不断优化智能体的问答体验。

管理设备

设备管理功能适用于通过嵌入式设备使用网易云信实时对话智能体的场景，可帮助您管理设备与智能体的绑定关系。在网易云信智能体开发体系中，一个用户（用户账号）可以对应多个设备（设备终端实体），每个设备必须唯一绑定一个用户和一个智能体。

前提条件

在开始管理设备之前，请确保您已经至少 添加了一个用户。

进入设备管理

平台提供两个设备管理入口，您可以选择任意一个：

方式一：通过智能体卡片

1. 在智能体列表中找到目标智能体。

2. 单击智能体卡片中的 设备管理 按钮。

   

方式二：通过左侧导航栏

1. 单击页面左侧导航栏中的 用户管理 选项。

   

2. 进入全局用户管理界面，通过 设备管理 查看用户绑定的设备。

添加设备绑定

以下步骤假设您通过左侧导航栏的 用户管理 选项绑定设备：

1. 单击用户列表中 设备管理 按钮，出现 添加设备 弹窗。

   

2. 在弹出的表单中填写以下信息：

   • 绑定方式：支持通过设备 ID 和设备激活码绑定设备。

   • 设备 ID：输入要绑定的设备唯一标识符。

   • 设备激活码：输入由设备播报或显示的临时播报码。

   • 用户 ID：输入使用该设备的用户标识符。

   • 智能体 ID：输入要绑定的智能体。

     如果您是从智能体卡片进入设备管理，系统会自动填入对应的智能体 ID，您只需输入设备 ID 和用户 ID 即可。

3. 单击 确认 按钮完成设备绑定。

   

4. 绑定设备后，您需要通过 激活授权码 License 接口，为设备下发使用智能体的授权凭证。

硬件开发

在为设备绑定用户后，即可按照嵌入式 SDK 接入文档进行集成开发，让硬件开口说话。所需文档如下：

• 嵌入式 SDK 接入：在网易云信嵌入式 SDK（NERTC SDK）中配置智能体，完成 AI 对话功能的核心实现步骤。
• 激活授权码 License：绑定设备后，您可以通过激活授权码接口，为设备下发使用智能体的授权凭证。

休眠与唤醒

典型的智能硬件会有休眠与唤醒机制。您可在配置智能体时，在 Pipeline 设置 中设置休眠参数。

1. 在智能体列表中找到需要修改的智能体。

2. 单击智能体卡片中的 配置角色 按钮。

3. 在 Pipeline 设置 中设置休眠参数，然后单击 保存设置。如下面的配置示例为若 30 秒内自然用户无主动发言，则进行休眠模式，同时会抛出休眠播报提示词。

   

对话进入休眠模式后，支持再度唤醒。

1. 在智能体列表中找到需要修改的智能体。

2. 单击智能体卡片中的 设备管理 按钮。

3. 在 设备管理 中找到对应的设备，选择 更多操作 > 唤醒词配置 中进行配置。

   

4. 在 唤醒词编辑 中输入唤醒词。如下面的配置示例为用户通过发出 小智小智 来唤醒对话。

   

解绑设备

1. 在设备管理弹窗中，找到需要解绑的设备。

2. 单击对应设备行的 更多操作 > 解绑设备 按钮。

   

3. 系统将立即解除设备与智能体的绑定关系。

   • 在同一个 AppKey 下，一个设备 ID 只能绑定一个智能体。
   • 解绑设备后，该设备可以重新绑定到其他智能体。
   • 解绑操作不可撤销，请谨慎操作；解绑后可重新绑定。