AI 对讲控制台
接入 AI 对讲前，请先进入 AI 对讲控制台 完成角色、知识库和插件能力配置。
1. 进入智能体管理
在控制台左侧选择智能体管理，可以查看当前应用下已有的智能体角色。你可以在这里新建智能体，或进入已有智能体的配置页。
2. 配置角色
进入角色配置页后，选择角色模板并填写智能体昵称、人设指令（System Prompt）、欢迎语、对话语言和音色等配置。保存并发布后，该角色会生成或对应一个 role_id，后续申请连接凭证和发送 start_session 都需要使用它。
3. 配置知识库
如果智能体需要回答私域知识、产品说明、操作手册等内容，可以在知识库管理中创建知识库，并将知识库关联到对应智能体。
4. 配置设备端插件
设备端插件用于声明设备可以执行的本地能力，例如灯光操作、音量调节、本地播放等。平台在对话中触发设备动作时，会通过事件协议下发给设备执行。
5. 配置云端插件
云端插件用于接入外部服务或 MCP 工具，例如地图、搜索、业务系统查询等。配置完成后，智能体可以在对话中调用这些云端能力。
6. 通过 OpenAPI 管理角色
除控制台外，业务服务端也可通过 OpenAPI 管理角色：
- 创建自定义角色：按业务需求动态创建智能体角色，获取
role_id。 - 查询角色列表：获取当前应用下已有角色，供业务侧选择或绑定。
设备绑定角色、设备角色查询等接口同样通过 OpenAPI 提供。完整接口说明见 Apifox 文档。业务服务端可以在设备维度维护默认 role_id，发起 AI 对讲时按设备查询本次会话使用的角色。
完成后台配置后，业务服务端即可为设备申请连接凭证。下一步请阅读 服务端集成。