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.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.参数校验失败,指定参数缺失。
403CCAI.IllegalPermission.NoAuthUser not authorized to operate on the specified resource %s .该用户未被授权可操作指定资源
500CCAI.InternalErrorThe request processing has failed due to some unknown error, exception or failure.系统内部错误,请稍后重试

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