Skip to content

[Feature Request] 新建 weixin-java-aispeech 模块,承接智能对话(客服+知识助理)API #4008

@binarywang

Description

@binarywang

背景

微信开放平台提供了「智能对话」相关能力,分为两大部分:

  1. 智能客服(对话平台):通过 APPID+Token 接入机器人,支持批量导入问答、发布机器人、调用智能对话(支持富文本:图片/音频/视频/小程序/H5/流式文本/合并回答)

  2. 知识助理(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 域,不会产生冲突。

环境信息

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions