主题
E. 平台配置字段速查
平台侧(运营平台)配置项的字典式速查。按配置模块分组,每项标注:位置 / 必填 / 来源章节。
C.1 企业与型号
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| vendorId(企业 ID) | 个人信息 > 企业信息 | 是 | 注册企业审核通过后获取 | 3.2 step1 |
| 产品型号 | 资源管理 > 型号库 > 新建 | 是 | 型号值唯一不可重复;品类不确定选「通用」 | 3.2 step1 |
| 产品品类 | 新建型号 | 否 | 一类产品统称,不确定选「通用」 | 6.1 |
| 产品部件 | 新建型号 | 否 | 型号内可独立控制的子结构(主灯/氛围灯) | 6.1 |
| IoT 平台 | 新建型号 | 否 | 指令需经 IOT 平台转发时选;直达设备可不选 | 6.1 |
C.2 应用配置
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| appId(应用 ID) | 应用管理 > 应用卡片下方 | 是 | 一个应用对应一个产品型号 | 3.2 step2 |
| 接入类型 | 新建应用 | 是 | 语音智能体接入(推荐)/ 文本智能体接入 | 3.2 step2 |
| 默认音色 | 应用配置 | 否 | 系统音色或自定义音色 | 7.1 |
| 全局人设 | 应用配置 > 全局人设编辑 | 否 | 提示词定义角色;可插系统变量(${systemTime}/${location}/${memoBaseContent}) | 3.2 step2 |
| 开场白 | 交互策略 | 否 | 首次建联问候语,轮播最多 5 条 | 7.2.1 |
| 静默推送 | 交互策略 | 否 | 沉默超阈值触发;系统内置提示词不可自定义;5 组时段控制 | 7.2.2 |
| 事件反馈 | 交互策略 | 否 | 变量引用动态生成回复,配 extInfo | 7.2.3 |
C.3 技能与指令
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| 系统技能 | 应用 > 技能列表 | 否 | 闲聊/天气等开箱即用,可微调提示词 | 3.2 step2 |
| 自定义技能 | 资源管理 > 技能库 > 新建 | 否 | 技能准入描述(意图+触发条件+不可触发+正反例) | 6.6.3 |
| 指令集 | 资源管理 > 指令库 > 新建 | 否 | 绑定型号;含是否需要执行反馈开关 | 6.1.2 |
| 控制项指令 | 指令集下新建 | — | 标准功能点(开关/亮度/音量),数据类型 SWITCH/ENUM/NUMERIC | 6.1.3 |
| 非控制项指令 | 指令集下新建 | — | 私有协议(机器人动作),含槽位提取 | 6.1.3 |
| 任务规划器 | AIot 技能配置 | 否 | 开启并行下发 / 关闭串行 instructions[] | 6.1.4 |
| 垫句列表 | AIot 技能配置 | 否 | 规划器开启时显示;清空+关执行反馈=静默 | 6.1.5 |
C.4 音色
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| 系统音色 | 应用/设备配置 | 否 | 不可编辑不可删除 | 7.1 |
| 自定义音色 | 资源管理 > 音色库 > 新建 | 否 | 3-15 秒单段音频复刻;同企业唯一 | 7.1 |
| 隐私授权 | 音色复刻 | 是 | 勾选"已获得录音素材合法授权" | 7.1 |
C.5 设备
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| botId(设备 ID) | 设备管理 | 是 | WS 建联必需,注册设备后生成 | 3.2 step3 |
| type | 新建设备 | 是 | APP_ROBOT 测试 / PHYSICAL_ROBOT 生产 | 4.2 设备注册 |
| deviceId / SN | 新建设备 | 是 | 建议用设备 SN,厂商保证唯一 | 4.2 设备注册 |
| deviceModel | 新建设备 | 否 | 非标准参数,使用需向 JoyInside 团队申请 | 4.2 设备注册 |
| 设备音色 | 新建/编辑设备 | 否 | 单设备覆盖应用默认音色 | 7.1 |
C.6 外部 API(自定义技能用)
| 配置项 | 位置 | 必填 | 说明 | 章节 |
|---|---|---|---|---|
| API 名称 | 开发者中心 > 第三方服务 | 是 | 仅字母/数字/下划线,最多 20 字符 | 6.6.2 |
| 技能 URL | 新建 API | 是 | 后端完整接口地址 | 6.6.2 |
| 鉴权方式 | 新建 API | 是 | 固定 Service Token(唯一支持) | 6.6.2 |
| Token 位置 | 新建 API | 是 | Header 或 Query | 6.6.2 |
| 状态 | API 列表 | 是 | 必须拨到"启"才能被技能选用 | 6.6.2 |