使用指南

本文介绍如何配置并使用通义听悟-购车客户画像 Agent。

准备工作

开通通义听悟 Agent 服务。

说明

开通后即可使用阿里云百炼平台全系通义听悟 Agent 服务。

一、创建应用

点击控制台页面中间或右上角的创建应用按钮,进行应用创建,支持创建多个应用。

1

二、调试配置

完成调试配置后,您可多次体验效果,确认效果满足预期后再发布应用,并参照API接入进行实际开发调用。

1. 提供待洞察的内容

2

内容来源

您选择以下任一方式输入内容:

  • 音频文件:支持 mp3、wav、m4a、wma、aac、ogg、amr、flac、aiff 格式的音频文件和 mp4、wmv、m4v、flv、rmvb、dat、mov、mkv、webm、avi、mpeg、3gp、ogg 格式的视频文件。文件大小不超过6GB。

  • 通义听悟任务:填写通义听悟 Agent 历史已完成的转写任务ID(TaskID),可节省语音转文字成本。

    说明

    任务创建成功后,系统将在响应中返回TaskID字段。

  • 对话内容:按格式录入对话内容文本,也可节省语音转文字成本。

    示例1:
    发言人1:对话内容。
    发言人2:对话内容。
    示例2:
    销售:对话内容。
    客户:对话内容。

转写模型

仅限内容来源为音频文件时需要选择转写模型:

  • 汽车领域模型(中英粤)

  • paraformer-v2(中英日韩粤)

  • paraformer-8k-v2(中文)

  • paraformer-v1(中英)

  • paraformer-8k-v1(中文)

  • 教育领域模型(中英)

音频类型

仅限内容来源为音频文件时需要选择音频类型:

  • 电话录音 或 16K及以上单声道

  • 16K及以上多声道(车载设备录制)

2. 制定客户画像规则

3

洞察模型

目前支持以下模型:

  • ccai-pro(默认,基于qwen-plus增强内容理解和指令遵循,效果最佳)

  • qwen-plus

  • qwq

场景描述

请输入品牌名称处填写需要洞察分析的品牌名称。

分析结果

勾选本次调试需要的客户画像分析结果维度:

  • 试驾意向评分

  • 销售线索评分

  • 一句话客户画像

  • 客户详细关注点分析(必选项)

关注点

  • 默认分析项:15大类62项(涵盖车辆信息、用户体验、产品配置、用车成本等)

  • 自定义分析项(上限100项):添加更匹配您业务场景的洞察分析关注点,添加时需要输入分析项名称、分析标准

角色设定

系统默认提供 客户销售导航车机助手 四个默认角色,您可以自定义编辑修改,删除某个角色以及创建新的角色。目前最多支持创建5个角色。请注意,客户 销售 角色默认不可删除。

  • 客户:对车辆提出疑问,表达使用感受、询问车型信息及价格等

  • 销售:介绍车辆的不同配置、性能与技术、舒适性与便利性、解释客户提问等

  • 导航:播报行驶路线,例如前方路口左拐,前方红绿灯直行

  • 车机助手:响应车内人员指令,例如已为您打开通风、空调已打开、已关闭音乐

说明

界面化的应用配置可对 API 生效,您同时也可在 API 中更新参数,覆盖界面应用配置。

完成上述配置后,即可点击立即分析按钮进行调试(步骤3. API 调用配置仅在接口调用时需要参考)。

如需查看调试效果测试记录,请参见体验效果

3. API 调用配置

4

回调方式

说明

此处回调方式设置请参考 如何通过回调获取异步任务结果

  • HTTP post 协议:需要您输入对应 URL 地址,通义听悟会向配置的HTTP URL发送post请求,返回的HTTP status200则检查通过。

  • 不设置回调(主动轮询):如果您选择不设置回调,自行主动轮询,可使用Agent任务的轮询接口:getTask;默认每个账户轮询的 QPS 为:100

  • 事件总线:处理结果将按事件总线北京 Region 的 default 配置,发送到您的服务(需要提前开通 阿里云事件总线

当服务端接收到回调消息,并返回200的 HTTP 状态码后,该应用项目才能创建成功,消息格式如下:

{
    "output": {
        "transcriptionPath": "https://***.oss-cn-hangzhou.aliyuncs.com/***",
        "status": 0
    },
    "requestId": "***",
    "taskInfo": {
        "dataId": "***",
        "userSpaceId": "llm-***",
        "appId": "***",
        "model": "tingwu-***",
        "userId": "***"
    }
}

应用名称

在此处复制或修改本应用名称。

应用ID

在此处查看或复制本应用ID。

应用描述

在此处添加本应用的描述信息。

三、体验效果

点击立即分析按钮后,稍等片刻,即可查看对话内容和分析结果。

5

对话内容

  • 若输入内容来源为音频文件通义听悟任务,则对话内容展示框中将呈现对应的音视频文字转写结果,并标识对话人ID和对话时间戳。

  • 若输入内容来源为对话内容文字输入,则可能无法展示对话时间戳信息,但不会影响洞察结果分析。

分析结果

在洞察结果分析展示框中,可查看试驾意向评分销售线索评分一句话客户画像客户关注点分析。其中客户关注点分析中会体现有命中未命中的分析结果,以及具体命中的原文内容。

分析项可在左侧进行配置,详见调试配置

试驾意向评分

销售线索评分

image

image

一句话客户画像

客户关注点分析

image

image

测试记录

当前应用的所有调试测试结果,将统一进行保存记录,点击控制台右上角的测试记录按钮可查看。

测试记录列表会展示多维度的信息,具体包括测试时间、任务ID、任务状态、转写模型、洞察模型、对话内容、洞察命中项,以及查看详情的操作按钮。

image

点击某条测试记录最右侧的详情按钮,可以查看完整详细的对话内容分析结果

image

四、发布应用

点击控制台右上角的发布按钮,输入版本描述信息,即可完成发布,应用发布后线上将立即生效。

6

版本管理

应用发布后,可在控制台右上角的版本管理中查看历史版本。选择某个历史版本,点击右下角覆盖当前草稿按钮,则该版本的配置信息将自动带入到当前草稿中。

9

五、API接入

应用发布完成后,稍等片刻,点击控制台顶部API 接入按钮,查看对应的 Java 和 Python 接入参考代码,然后接入到您的业务系统中。

7

六、删除应用

我的应用列表中,可删除某个应用。

删除后不可恢复,为避免影响您的线上业务,请务必谨慎操作。

8