背景
微信开放平台提供了「智能对话」相关能力,分为两大部分:
-
智能客服(对话平台):通过 APPID+Token 接入机器人,支持批量导入问答、发布机器人、调用智能对话(支持富文本:图片/音频/视频/小程序/H5/流式文本/合并回答)
-
知识助理(WeKnoraGateway):AI知识库管理,支持创建/管理知识、上传文件、检索等
现有 WxJava 实现情况
已实现:在 weixin-java-mp 中有 WxMpAiOpenService,覆盖旧版语音识别和微信翻译(接口路径 cgi-bin/media/voice/*),对应旧版文档。
完全缺失:
- 智能客服(对话平台)6个接口:
/v2/token、/v2/async/fetch、/v2/bot/import/json、/v2/bot/publish、/v2/bot/effective_progress、/v2/bot/query
- 知识助理全量 API
建议
新建独立模块 weixin-java-aispeech,完整承接以上能力。建议包结构如下:
me.chanjar.weixin.aispeech
├── api/
│ ├── WxAispeechService.java # 主入口,含子服务注入
│ ├── WxAispeechDialogService.java # 智能客服(对话平台)- 6个方法
│ └── WxAispeechKnowledgeService.java # 知识助理(WeKnoraGateway)
├── bean/
│ ├── dialog/ # 对话相关Bean(DialogResult/PublishProgress等)
│ └── knowledge/ # 知识相关Bean(KnowledgeInfo/FileParseResult等)
├── config/
│ └── WxAispeechConfigStorage.java # 配置存储
└── util/
└── WxAispeechSignUtil.java # 签名工具(AES加密+MD5签名)
WxAispeechDialogService 方法清单(6个)
public interface WxAispeechDialogService {
// 认证
String getAccessToken(String appid, String account) throws WxErrorException;
// 机器人管理
String importBotJson(int mode, List<BotIntent> data) throws WxErrorException; // /v2/bot/import/json
String publishBot() throws WxErrorException; // /v2/bot/publish
PublishProgress getPublishProgress(String env) throws WxErrorException; // /v2/bot/effective_progress
AsyncTaskResult queryAsyncTask(String taskId) throws WxErrorException; // /v2/async/fetch
// 核心对话(需AES加密)
DialogResult query(DialogQueryRequest request) throws WxErrorException; // /v2/bot/query
}
WxAispeechKnowledgeService 方法清单
包含知识管理(创建/列表/详情/更新/删除)、知识文件(上传/解析状态/启用/禁用/摘要)、检索等能力。
与现有模块的关系
| 模块 |
说明 |
weixin-java-mp |
现有 WxMpAiOpenService 保留,覆盖旧版AI能力(语音识别+翻译),接口路径不同 |
weixin-java-aispeech(新建) |
新增独立模块,覆盖智能对话+知识助理全套能力,使用独立Base URL和认证体系 |
两个模块面向不同 API 域,不会产生冲突。
环境信息
背景
微信开放平台提供了「智能对话」相关能力,分为两大部分:
智能客服(对话平台):通过 APPID+Token 接入机器人,支持批量导入问答、发布机器人、调用智能对话(支持富文本:图片/音频/视频/小程序/H5/流式文本/合并回答)
https://openaiapi.weixin.qq.com知识助理(WeKnoraGateway):AI知识库管理,支持创建/管理知识、上传文件、检索等
现有 WxJava 实现情况
已实现:在
weixin-java-mp中有WxMpAiOpenService,覆盖旧版语音识别和微信翻译(接口路径cgi-bin/media/voice/*),对应旧版文档。完全缺失:
/v2/token、/v2/async/fetch、/v2/bot/import/json、/v2/bot/publish、/v2/bot/effective_progress、/v2/bot/query建议
新建独立模块
weixin-java-aispeech,完整承接以上能力。建议包结构如下:WxAispeechDialogService 方法清单(6个)
WxAispeechKnowledgeService 方法清单
包含知识管理(创建/列表/详情/更新/删除)、知识文件(上传/解析状态/启用/禁用/摘要)、检索等能力。
与现有模块的关系
weixin-java-mpWxMpAiOpenService保留,覆盖旧版AI能力(语音识别+翻译),接口路径不同weixin-java-aispeech(新建)两个模块面向不同 API 域,不会产生冲突。
环境信息