对话知识抽取

对话知识抽取服务适用于客服-消费者在线聊天场景,从对话内容中抽取出客服问-客户答、客户问-客服答等客服话术和用户问题,可用于后续的用户热点问题分析或构建客服话术库,优化客服机器人。

说明

本服务由NLP自学习平台提供,直接调用API即可使用。

服务开通与资源包购买

使用前,请确认是否已经开通服务,开通后可购买资源包。

服务调用与调试

模型调用文档参考:模型调用

SDK示例文档参考:SDK示例

调试

您可以在OpenAPI开发者门户中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI开发者门户可以自动生成SDK代码示例。

通过环境变量配置访问凭证(AKSK)

  1. 说明:

    1. 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。

    2. 强烈建议不要把AccessKey和AccessKeySecret保存到代码里,会存在密钥泄漏风险,在此提供通过配置环境变量的方式来保存和访问aksk

  2. Linux和macOS系统配置方法

    export NLP_AK_ENV=<access_key_id>
    export NLP_SK_ENV=<access_key_secret>

    其中<access_key_id>替换为已准备好的AccessKey ID,<access_key_secret>替换为AccessKey Secret,AccessKey ID和AccessKey Secret的获取方式见步骤二:获取账号的AccessKey

  3. Windows系统配置方法

    1. 新建环境变量文件,添加环境变量NLP_AK_ENVNLP_SK_ENV,并写入已准备好的AccessKey ID和AccessKey Secret。

    2. 重启Windows系统。

Java代码示例

class MsgDO{
            private String role;
            private String content;
            public MsgDO(String role,String content) {
                this.role = role;
                this.content = content;
            }
            public String getRole() {
                return role;
            }
            public void setRole(String role) {
                this.role = role;
            }
            public String getContent() {
                return content;
            }
            public void setContent(String content) {
                this.content = content;
            }
        }
/**
 * 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
 * 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
 * 强烈建议不要把AccessKey和AccessKeySecret保存到代码里,会存在密钥泄漏风险
 */
String accessKeyId = System.getenv("NLP_AK_ENV");
String accessKeySecret = System.getenv("NLP_SK_ENV");
DefaultProfile defaultProfile = DefaultProfile.getProfile("cn-hangzhou",accessKeyId,accessKeySecret);
IAcsClient client = new DefaultAcsClient(defaultProfile);
Map<String, Object> obj = new HashMap<String, Object>();
List<MsgDO> msgs = new ArrayList<MsgDO>();
msgs.add(new MsgDO("客服","喂,你好。"));
msgs.add(new MsgDO("客户","喂,你好。"));
msgs.add(new MsgDO("客服","我是菜鸟驿站的服务专员。你有包裹送到菜鸟驿站这边了,请问有空了,方便来拿吗。"));
msgs.add(new MsgDO("客户","哪里的菜鸟驿站。"));
msgs.add(new MsgDO("客服","稍等给您报一下驿站的地址。我们在卢春小区2-16号小区门口诊所隔壁。"));
msgs.add(new MsgDO("客服","地址,待会会短信发给您,您看有空的时候随时来拿可以吗。"));
msgs.add(new MsgDO("客户","嗯。"));
msgs.add(new MsgDO("客户","驿站在哪里呀。"));
msgs.add(new MsgDO("客服","这样,您可以看一下短信中的地址是否方便过来,有问题再联系我好吗。"));
msgs.add(new MsgDO("客户","好。"));
obj.put("msgs",msgs);
RunPreTrainServiceRequest request = new RunPreTrainServiceRequest();
request.setServiceName("NLP-dialog-knowledge");
request.setPredictContent(JSON.toJSONString(obj));
RunPreTrainServiceResponse response = client.getAcsResponse(request);
System.out.println(response.getPredictResult());

Python代码示例

# 安装依赖
pip install aliyun-python-sdk-core
pip install aliyun-python-sdk-nlp-automl
# -*- coding: utf8 -*-
import json
import os

from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.acs_exception.exceptions import ClientException
from aliyunsdkcore.acs_exception.exceptions import ServerException
from aliyunsdknlp_automl.request.v20191111 import RunPreTrainServiceRequest

/**
 * 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
 * 此处以把AccessKey和AccessKeySecret保存在环境变量为例说明。您也可以根据业务需要,保存到配置文件里。
 * 强烈建议不要把AccessKey和AccessKeySecret保存到代码里,会存在密钥泄漏风险
 */
access_key_id = os.environ['NLP_AK_ENV']
access_key_secret = os.environ['NLP_SK_ENV']

# Initialize AcsClient instance
client = AcsClient(
  access_key_id,
  access_key_secret,
  "cn-hangzhou"
);
content = {
    "msgs": [
      {
        "role": "客服",
        "content": "喂,你好。"
      },
      {
        "role": "客户",
        "content": "喂,你好。"
      },
      {
        "role": "客服",
        "content": "我是菜鸟驿站的服务专员。你有包裹送到菜鸟驿站这边了,请问有空了,方便来拿吗。"
      },
      {
        "role": "客户",
        "content": "哪里的菜鸟驿站。"
      },
      {
        "role": "客服",
        "content": "稍等给您报一下驿站的地址。我们在某某小区2-16号小区门口诊所隔壁。"
      },
      {
        "role": "客服",
        "content": "地址,待会会短信发给您,您看有空的时候随时来拿可以吗。"
      },
      {
        "role": "客户",
        "content": "嗯。"
      },
      {
        "role": "客户",
        "content": "驿站在哪里呀。"
      },
      {
        "role": "客服",
        "content": "这样,您可以看一下短信中的地址是否方便过来,有问题再联系我好吗。"
      },
      {
        "role": "客户",
        "content": "你帮我把我的手机到我这里来拿眼镜的那笔。"
      },
      {
        "role": "客服",
        "content": "嗯,好的,您凭短信过来拿包裹就好了,有问题您再联系我们。"
      }
    ]
}
# Initialize a request and set parameters
request = RunPreTrainServiceRequest.RunPreTrainServiceRequest()
request.set_ServiceName('NLP-dialog-knowledge')
request.set_PredictContent(json.dumps(content))
# Print response
response = client.do_action_with_exception(request)
resp_obj = json.loads(response)
predict_result = json.loads(resp_obj['PredictResult'])
print(predict_result)

PredictContent内容示例

{
    "msgs": [
      {
        "role": "客服",
        "content": "喂,你好。"
      },
      {
        "role": "客户",
        "content": "喂,你好。"
      },
      {
        "role": "客服",
        "content": "我是菜鸟驿站的服务专员。你有包裹送到菜鸟驿站这边了,请问有空了,方便来拿吗。"
      },
      {
        "role": "客户",
        "content": "哪里的菜鸟驿站。"
      },
      {
        "role": "客服",
        "content": "稍等给您报一下驿站的地址。我们在某某小区2-16号小区门口诊所隔壁。"
      },
      {
        "role": "客服",
        "content": "地址,待会会短信发给您,您看有空的时候随时来拿可以吗。"
      },
      {
        "role": "客户",
        "content": "嗯。"
      },
      {
        "role": "客户",
        "content": "驿站在哪里呀。"
      },
      {
        "role": "客服",
        "content": "这样,您可以看一下短信中的地址是否方便过来,有问题再联系我好吗。"
      },
      {
        "role": "客户",
        "content": "你帮我把我的手机到我这里来拿眼镜的那笔。"
      },
      {
        "role": "客服",
        "content": "嗯,好的,您凭短信过来拿包裹就好了,有问题您再联系我们。"
      }
    ]
}

PredictResult内容示例

{
  "code": 1000,
  "data": {
    "cost": "14.822ms",
    "knowledges": [
      {
        "hits": [
          [
            "哪里的菜鸟驿站。",
            "稍等给您报一下驿站的地址。我们在某某小区2-16号小区门口诊所隔壁。"
          ],
          [
            "驿站在哪里呀。",
            "这样,您可以看一下短信中的地址是否方便过来,有问题再联系我好吗。"
          ]
        ],
        "name": "用户问-客服答"
      },
      {
        "hits": [
          [
            "我是菜鸟驿站的服务专员。你有包裹送到菜鸟驿站这边了,请问有空了,方便来拿吗。",
            "哪里的菜鸟驿站。"
          ]
        ],
        "name": "客服问-用户答"
      }
    ]
  },
  "message": "OK",
  "tracerID": "2020-10-30 06:17:55.485426"
}

入参说明

参数

说明

msgs

客服-客户在线聊天过程中的消息列表,不超过20句

role

说话人的角色,当前仅客服、客户两种角色

content

说话人的说话内容

出参说明

参数

说明

knowledges

抽取到的知识

name

知识类型名称,当前包括客服问-客户答、客户问-客服答两种类型

hits

命中当前知识类型的具体内容列表,例如name=“客服问-客户答”时,hit是为对话中所有命中该模式的对话内容列表,每个元素都是“客服问内容-客户答内容”