创建购车客户画像任务的API参考。
前提条件
已开通服务并获取与配置 API Key,请配置API Key到环境变量,而非硬编码在代码中,防范因代码泄露导致的安全风险。
当您需要为第三方应用或用户提供临时访问权限,或者希望严格控制敏感数据访问、删除等高风险操作时,建议使用临时鉴权Token。与长期有效的 API Key 相比,临时鉴权 Token 具备时效性短(60秒)、安全性高的特点,适用于临时调用场景,能有效降低API Key泄露的风险。使用方式:在代码中,将原本用于鉴权的 API Key 替换为获取到的临时鉴权 Token 即可。
接入地址
请求方式
post方法请求
请求头
创建任务
创建购车客户画像分析任务。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| model | string | 是 | 定义业务类型,固定为tingwu-automotive-customer-profile | tingwu-automotive-customer-profile |
| input | object | 是 | 传入相关业务参数 | |
| input.fileUrl | string | 3选1 | 待分析文件oss URL地址 | https://.oss-cn-hangzhou.aliyuncs.com/%E8%AF%95%E9%A9%BE%E6%A1%88%E4%BE%8Bsmall.wav?OSSAccessKeyId=YOUR_ACCESS_KEY_ID&Expires=&Signature=YOUR_SIGNATURE |
| input.text | string | 待分析文本 | 每行必须按照如下格式:${发言人名称}: ${发言人内容}例子比如: | |
| input.dataId | string | 关联已经上传并解析完成的任务 | ||
| input.appId | string | 是 | 应用id | |
| input.task | string | 是 | 定义任务类型,固定为createTask,表示创建任务 | createTask |
| parameters | object | 否 | 客户画像控制参数 | |
| parameters.identityRecognition | object | 否 | 角色设定 | |
| parameters.identityRecognition.identityContents | list[] | 是 | 角色设定列表,包含身份名称和描述,列表最大长度为5 | |
| parameters.identityRecognition.identityContents[i].Name | string | 是 | 角色身份名称 | 客户 |
| parameters.identityRecognition.identityContents[i].Description | string | 是 | 角色身份描述 | 对车辆提出疑问,表达使用感受 |
| parameters.contentExtraction | object | 否 | 客户详细关注点提取参数对象 | |
| parameters.contentExtraction.extractionContents | list[] | 是 | 客户详细关注点提取的提取维度列表,包含提取项的名称和定义个数不超过150 | |
| parameters.contentExtraction.extractionContents[i].title | string | 是 | 客户详细关注点提取的提取维度名称 | 订车相关 |
| parameters.contentExtraction.extractionContents[i].content | string | 是 | 客户详细关注点提取的维度定义 | 定制颜色要多久? |
| parameters.contentExtraction.extractionContents[i].identity | string | 是 | 客户的角色名称 | 客户 |
返回参数
名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
output | object | ||
output.dataId | string | 任务id | lsA*** |
output.status | string | 任务状态:
| 0 |
usage | object | 用量 | {} |
code | string | 错误码 | InvalidParameter |
message | string | 错误信息 | Agent Input text format error. |
request_id | string | 请求id | f97ee37d-0f9c-9b93-b6bf-bd263a232bf9 |