T/CES 158-2022 面向电力业务的对话机器人服务集成规范

以下是对《面向电力业务的对话机器人服务集成规范》（T/CES 158-2022）主要内容的详细结构化总结：

​​1. 范围与适用性​​

• ​​适用范围​​：规范电力业务场景和移动终端应用集成到电力对话机器人服务平台的流程、要求、方法及接口。
• ​​核心目标​​：指导业务开发人员完成业务场景集成开发工作。

​​2. 总体架构​​

系统架构分为四层（见图1）：

• ​​移动终端​​：用户交互入口，支持文本、音频、图片、视频四种消息格式。
• ​​电力对话机器人​​：核心处理层，负责消息解析、意图识别、会话管理及业务流程驱动。
• ​​电力开放服务​​：提供基础AI能力（语音识别ASR、图像识别、意图识别）。
• ​​业务系统​​：提供业务数据接口，完成具体业务逻辑（如售电量查询）。

​​3. 业务场景接入规范​​

​​(1) 业务定义（JSON格式）​​

• ​​核心参数​​：意图编码（code）、版本号（version）、动作列表（action transitions）。
• ​​动作类型​​：
  • ​​REST动作​​：调用业务系统数据接口（必填URL、HTTP方法、响应属性）。
  • ​​消息发送动作​​：向用户返回文本/音频/图片/视频消息（需定义消息类型及内容）。
  • ​​Groovy动作​​：执行脚本操作会话数据。
  • ​​组合动作​​：串联多个动作按序执行。
• ​​消息格式​​：
  • 文本消息：包含内容（content）、收发方身份标识。
  • 非文本消息（音频/图片/视频）：需通过临时素材库中转，传递素材ID（mediaId）。

​​(2) 数据接口规范​​

• ​​协议​​：HTTP POST + JSON格式（媒体类型 application/json）。
• ​​安全保障​​：OAuth2.0授权（请求头添加 Authorization: Bearer <token>）。
• ​​请求/响应示例​​：

  // 请求示例（售电量查询）{"time": "11月"}// 成功响应（200）{"message": "浙江:655345.000", "type": "text"}// 错误响应（500）{"message": "业务系统异常", "status": 500}

​​4. 移动终端接入规范​​

​​(1) 集成要求​​

• 实现四种消息格式（文本、音频、图片、视频）。
• 非结构化文件（音频/图片/视频）需通过临时素材库中转。
• 禁止直接暴露服务接口到互联网。

​​(2) 核心接口​​

1. ​​语音识别接口（ASR）​​

   • 方法：POST /open/v1/asr/convert
   • 输入：语音文件（表单字段 file，格式限制：AMR/≤2MB/≤60s）。
   • 输出：SM4加密文本（需解密后使用）。

2. ​​意图识别接口​​

   • 方法：POST /open/v1/semantic/analyze
   • 输入：JSON格式用户文本（textContext）。
   • 输出：结构化意图数据（如 {"intent":"查询售电量", "result": {"time":"11月"}}）。

3. ​​临时素材库接口​​

   • 方法：POST /open/v1/media/upload?type=TYPE
   • 支持类型：image（JPG/PNG）、voice（AMR）、video（MP4）。
   • 响应：返回素材ID（media_id），有效期3天。

​​(3) 安全保障​​

• 所有接口调用需OAuth2.0访问令牌。
• 敏感数据传输采用SM4加密。

​​5. 集成流程与验收标准​​

​​(1) 业务场景集成流程​​

1. ​​确定场景​​：梳理适合对话机器人的业务清单。
2. ​​设计对话流程​​：定义实体（如查询时间）、引导用户输入。
3. ​​实现接口​​：业务系统提供数据接口（符合第6.3节规范）。
4. ​​制定业务定义​​：用JSON描述意图、动作及流转逻辑。

​​(2) 接口验收标准​​

​​6. 附录资源​​

• ​​业务定义示例​​：JSON格式的售电量查询流程（附录A）。
• ​​接口调用示例​​：伪代码演示加密请求、语音识别等流程（附录B）。
• ​​时序图示例​​：展示用户语音查询售电量时各组件交互流程（图C.1）：
  

​​关键价值点​​

• ​​行业适配​​：针对电力专业词汇和设备图像识别优化AI模型。
• ​​安全可控​​：OAuth2.0+SM4加密保障数据安全。
• ​​灵活扩展​​：支持组合动作、Groovy脚本满足复杂业务逻辑。
• ​​标准化集成​​：统一接口规范降低业务系统接入成本。

注：本文档首次发布于2022年12月，归口单位为中国电工技术学会标准工作委员会能源智慧化工作组。