This API reference describes how to query the status and result of a customer profile task.
Prerequisites
Activate the service and obtain and configure an API key. To prevent security risks from code leaks, configure the API key as an environment variable instead of hard coding it in your code.
Endpoint
Request method
POST
Request headers
Get task result
Retrieves the result of a customer profile analysis task.
Request parameters
Name | Type | Required | Description | Example |
|---|---|---|---|---|
model | string | Yes | The business type. Set the value to | tingwu-automotive-customer-profile |
input | object | Yes | Specify the relevant business parameters. | |
input.task | string | Yes | The task type. Set the value to | |
input.dataId | string | Yes | The ID of the audio task to query. | wkb*** |
Response parameters
Name | Type | Description | Example/Parsing protocol |
|---|---|---|---|
code | string | The error code. | |
message | string | The error message. | |
request_id | string | The request ID. | f97ee37d-0f9c-9b93-b6bf-bd263a232bf9 |
usage | object | The usage. | {} |
output | object | The business response body. | |
output.status | string | The task status.
| 0 |
output.errorCode | string | The error code returned when the task is submitted but fails to run. This parameter is returned only when | "TSC.FileError" |
output.errorMessage | string | The error message returned when the task is submitted but fails to run. This parameter is returned only when | "File cannot be read." |
output.customerProfilePath | string | The OSS URL of the analysis result. For more information, see Parsing protocol for output.customerProfilePath. | For information about the parsing protocols for the content of the files corresponding to the OSS URLs, see: |
output.transcriptionPath | string | The OSS URL of the speech-to-text result. For more information, see Parsing protocol for output.transcriptionPath. | |
output.identityRecognitionPath | string | The OSS URL of the role recognition result. For more information, see Parsing protocol for output.identityRecognitionPath. | |
output.contentExtractionsPath | string | A collection of one or more OSS URLs for the extraction results of customer points of interest. For more information, see Parsing protocol for output.contentExtractionsPath. |
Parsing protocol for output.transcriptionPath
The root element is an object. The following table describes its fields:
Name | Type | Description | Example |
|---|---|---|---|
paragraphs | Array | A list of paragraphs. | |
paragraphs[0].paragraphId | String | The paragraph ID. | 16987422100275***** |
paragraphs[0].speakerId | String | The speaker ID. | 1 |
paragraphs[0].words | Array | A list of words. | |
paragraphs[0].words[0].id | Integer | The word number. | 10 |
paragraphs[0].words[0].sentenceId | Integer | The sentence ID. | 1 |
paragraphs[0].words[0].start | Integer | The start time in milliseconds. | 4970 |
paragraphs[0].words[0].end | Integer | The end time in milliseconds. | 5560 |
paragraphs[0].words[0].text | String | The word text. | Hello, |
Parsing protocol for output.customerProfilePath
The root element is an object. The following table describes its fields:
Name | Type | Description | Example |
|---|---|---|---|
saleClueClassify | Object | The sales lead classification. | |
saleClueClassify.classify | String | The lead category. | B |
saleClueClassify.evidence | String | The basis for the classification. | The customer only expressed interest in learning about SUVs and had no clear intention to purchase a car. |
customerNotMentioned | Integer | The number of items not mentioned by the customer. | 46 |
tryDriveIntentionEvaluation | Object | The test drive intention assessment. | |
tryDriveIntentionEvaluation.score | Integer | The score. | 0 |
tryDriveIntentionEvaluation.evidence | String | The basis for the assessment. | The customer did not mention any intention to take a test drive and only asked about the price. |
customerConcerned | Integer | The number of customer points of interest. | 4 |
oneSentenceSumUp | String | A summary of the customer's points of interest. | Customer's points of interest: SUV model, exterior design, interior quality, specific configurations, battery range, and estimated time of arrival at the store. Concerns: Price transparency during the purchase process, after-sales service, and whether the actual vehicle performance matches the advertisement. |
Parsing protocol for output.identityRecognitionPath
The outermost layer is an Object that contains the following fields:
Name | Type | Description | Example |
|---|---|---|---|
identityResults | Array | A list of identity recognition results. | |
identityResults[0].identity | String | The recognized identity. | Customer |
identityResults[0].speakerId | String | The speaker ID. | 1 |
Parsing protocol for output.contentExtractionsPath
The outermost layer is a JSONArray containing the following elements:
Name | Type | Description | Example |
|---|---|---|---|
result | String | The result description. | Car purchase cost |
matchedSentenceIds | Array<Integer> | A list of matched sentence IDs. | [1, 2] |
title | String | The title. | Cost of ownership |
remarks | String | The remarks. | The customer expressed concern about the car purchase cost during the conversation and asked about the price. |
Request example
In the Authorization request header, replace sk-*** with your Alibaba Cloud Model Studio API key.