接入说明

您可以通过如下说明快速了解接入业务流程与API调用方案。

接入流程

开发者接入新零售智能助理,公测期间按照如下流程实现:

步骤1 申请公测资格

  • 新零售智能助理产品公测期间,暂不开放自助接入。

  • 开发者需在阿里云新零售智能助理产品详情页提交公测接入申请。

  • 经双方业务团队沟通确认后,新零售智能助理将为开发者开通公测权限。

步骤2 确认客户解决方案与业务需求

  • 双方团队结合客户业务需求及已有能力,确认具体合作方案(包括计费与结算方案)、接入能力清单、目标客户与客户需求、客户实施与服务流程等。

步骤3 系统对接

  • 开发者按照开发文档完成新零售智能助理PaaS服务接入与联调。

  • 开发者结合企业已有能力、客户需求,封装、发布面向零售企业的SaaS产品。

步骤4 部署配置

  • 开发者或零售企业根据客户业务需求完成服务部署。

OpenAPI接入说明

Endpoint说明

中国内地环境:retailbot.cn-zhangjiakou.aliyuncs.com

步骤1 初始化机器人实例

  • 需要先为客户创建1个BOT,后续所有操作均需要指定ROBOTCODE。

  • 相关API:

    • 创建机器人 (CreateRobot)

步骤2 对接业务数据

  • 根据客户多渠道部署需求,完成客户业务数据的对接,包括:商品、订单、用户、对话数据等

  • MVP版本仅支持淘系渠道,可跳过本步骤

步骤3 为机器人订阅系统内置行业包

  • 根据客户实际业务情况,为客户订阅对应的多个行业包,建议为所有客户默认订阅通用包。

  • 相关api:

    • 查询全部行业包(ListIndustryPackages)

    • 订阅行业包 (InstallPackage)

    • 取消订阅行业包 (UninstallPackage)

步骤4 为机器人配置商家域知识

  • 系统内置行业包无法覆盖商家全部业务问题,也可能会出现商家对场景的理解和系统内置行业包场景定义不完全一致的情况。为提升机器人覆盖率和客户业务匹配度,可为机器人补充商家域知识。

  • 当前版本暂不包含商家域知识能力,公测期间会补充FAQ、商家私有模型、平台模型修正等商家域能力。开发者可通过相关OpenAPI,及可视化知识挖掘工具、模型训练工具完成配置。

步骤5 为机器人配置知识答案

  • 开发者调用知识相关API,为BOT已订阅的行业包及商家域知识写入答案。

  • 相关API:

    • 查询商家官方场景列表(ListSubscribedPackageKnowledges)

    • 新增答案(AddSolution)

步骤6 接入线上问答服务

  • 开发者对接渠道获取对话数据,调用RetailBot实时问答服务获取应答结果。

  • 相关API:

    • 实时问答 (RecognizeMessage)

    • 测试窗 (RecognizeMessageForTest)

步骤7 回流对话数据

  • 开发者回流对话日志、模型打标日志,辅助RetailBot提升问答效果

  • 相关API:

    • 人机对话数据回流(SyncRobotMessag)

    • 人人对话数据回流(SyncMessage)

    • 标注数据回流(UploadLabelData)