AnalyzeConversation - 通过任务类型调用通义晓蜜CCAI-对话分析AIO应用

获取对话摘要、标题生成、关键词、字段信息抽取、问题及解决方案、服务质检、代办事项、满意度、情绪检测、QA抽取、用户画像、标签分类等对话分析结果,应用调用支持 HTTP 调用来完成客户的响应。

接口说明

请确保在使用该接口前,已充分了解通义晓蜜 CCAI-对话分析 AIO 产品的收费方式和价格。

前提条件

  1. 已开通通义晓蜜 CCAI-对话分析 AIO 服务。
  2. 已创建应用:应用中心完成通义晓蜜 CCAI-对话分析 AIO 应用创建,并获取到 APP-ID 和 WORKSPACE-ID:获取APP-ID 和 WORKSPACE-ID

调试

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

授权信息

当前API暂无授权信息透出。

请求语法

POST /{workspaceId}/ccai/app/{appId}/analyze_conversation HTTP/1.1

请求参数

名称类型必填描述示例值
workspaceIdstring

工作空间 ID

llm-368******3ifum
appIdstring

应用 id。

a070a49c681f4a95a0f0*********35c
bodyobject

请求体。

categoryTagsarray<object>

标签分类列表

object
tagDescstring

标签描述

客服在服务客户过程中,基于已有的服务标准是否存在过度承诺的行为
tagNamestring

标签名称

客服过度承诺
dialogueobject

对话内容列表

sentencesarray<object>

对话内容

object
rolestring

通话角色:

  • user-客户

  • agent-客服

  • system-系统消息

user
textstring

对话文本

请问怎么申请新卡
sessionIdstring

客服会话 sessionId

session-01
examplesarray<object>

指令示例列表

object

指令示例

outputstring

输出示例

问题描述:询问2.2更新时间,处理方案:已告知
sentencesarray<object>

对话内容示例列表

object

对话内容示例

chatIdstring

每一轮对话 id

chat-01
rolestring

通话角色:

  • user-客户

  • agent-客服

  • system-系统消息

user
textstring

对话文本

什么时候更新
fieldsarray<object>

信息抽取时,需要抽取的字段列表

object

字段结构信息

codestring

字段编码

phoneNumber
descstring

字段描述

用户来电咨询的原因分类,主要有投诉、咨询、政策建议等。
enumValuesarray<object>

枚举值列表

object
descstring

枚举描述

客户有新的需求/新的场景,客服跟进沟通需求细节
enumValuestring

枚举值

新业务拓展
namestring

字段名称

来电原因类型
modelCodestring

模型 code

tyxmTurbo
resultTypesarray

指令任务类型

string

summary-对话摘要,title-标题生成、fields-字段信息抽取、keywords -关键字抽取,service_inspection-服务质检、question_solution-问题和解决方案、actions-代办事项、satisfaction-满意度、emotion_detection-情绪检测、questions_and_answer-QA 抽取、user_profile-用户画像、category_tag-标签分类

summary
sceneNamestring

场景名称

阿里云工单质检场景
serviceInspectionobject

服务质检结构信息

inspectionContentsarray<object>

服务质检维度结构列表

object

服务质检维度结构

contentstring

服务质检维度描述

客服在服务客户过程中,基于已有的服务标准是否存在过度承诺的行为,如:最快到货时间是12小时,无法给客户承诺更快的到货时间。
titlestring

服务质检维度名称

客服是否过度承诺
inspectionIntroductionstring

服务质检场景详细介绍及描述

请检测客服是否存在服务不当的行为,包括:过度承诺、故意套取客户隐私信息等
sceneIntroductionstring

服务质检场景

保险销售场景
streamboolean

必填。是否流式:true,流式返回答案;false,全量返回答案。

false
userProfilesarray<object>

用户画像列表

object
namestring

名称

sex
valuestring

描述

表示客户的性别,从列表[“男”, “女”]中选择一个值

返回参数

名称类型描述示例值
object

Schema of Response

errorCodestring

错误码

success
errorInfostring

错误信息

success
finishReasonstring

如果是流式输出,正在生成时为 null,生成结束时如果由于停止 token 导致则为 stop。

stop
requestIdstring

系统生成的标志本次请求的唯一性 ID

968A8634-FA2C-5381-9B3E-C552DED7E8BF
successboolean

请求是否成功

True
textstring

应用返回的结果。

这段对话似乎是客服与客户之间关于一个服务或产品的讨论,但具体内容难以明确理解,因为对话中的言语比较零散和抽象。

示例

正常返回示例

JSON格式

{
  "errorCode": "success",
  "errorInfo": "success",
  "finishReason": "stop",
  "requestId": "968A8634-FA2C-5381-9B3E-C552DED7E8BF",
  "success": true,
  "text": "这段对话似乎是客服与客户之间关于一个服务或产品的讨论,但具体内容难以明确理解,因为对话中的言语比较零散和抽象。",
  "inputTokens": "",
  "outputTokens": "",
  "totalTokens": ""
}

错误码

HTTP status code错误码错误信息描述
400CCAI.Throttling.QpsTrigger current QPS limit, pay API please buy higher QPS, the free API if you have special requirements, please contact us through the DingTalk group (62730018475).触发限流,付费API请购买更高QPS,免费API如有特殊需求,请通过钉钉群(62730018475)联系我们。
400CCAI.Throttling.QpmTrigger QPM flow restriction. Please purchase higher QPM for paid API. If free API has special requirements, please contact us through DingTalk group (62730018475).触发QPM限流,付费API请购买更高QPM,免费API如有特殊需求,请通过钉钉群(62730018475)联系我们。
400CCAI.InvalidParam.NotExistThe specified parameter %s is not valid.请求API的参数不存在
400CCAI.ParamInvalid.IllegalParamValueThe parameter value of the request API is illegal %s.请求API的参数不合法
403CCAI.IllegalPermission.NoAuthUser not authorized to operate on the specified resource.该用户未被授权可操作指定资源
403CCAI.TenantPermission.NoAuthThe current account does not have the permission to specify the business space. Please authorize the business space permission.当前账号没有指定业务空间的权限,请进行业务空间权限授权。
403CCAI.ParamNotfound.MissParamParameter verification failed, The specified parameter %s is missing.参数校验失败,指定参数缺失。
500CCAI.InternalErrorThe request processing has failed due to some unknown error, exception or failure.系统内部错误,请稍后重试

访问错误中心查看更多错误码。