使用指南 - 阿里云百炼

准备工作

开通通义听悟 Agent 服务。

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

一、创建应用

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

二、调试配置

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

1. 选择音频输入方式

内容来源
音频类型
转写模型
转写配置

选择以下任一内容来源：

录音文件识别：支持mp3、wav、m4a、wma、aac、ogg、amr、flac、aiff格式的音频文件和mp4、wmv、m4v、flv、rmvb、dat、mov、mkv、webm、avi、mpeg、3gp、ogg格式的视频文件。文件大小不超过6 GB。
实时转写：采集音频并进行实时转写。
通义听悟任务：填写当前应用历史已完成的转写任务ID（TaskID），可节省语音转文字成本。
任务创建成功后，系统将在响应中返回TaskID字段。
会议文本内容：按格式录入对话内容文本，也可节省语音转文字成本。

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

2. 设定大模型参数

分析模型
分析项

目前支持以下模型：

默认项（官方搭配最佳效果的模型组合）
tingwu-plus
qwen-plus
qwq

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

完成上述配置后，即可点击立即分析按钮进行调试（步骤3. API 调用配置仅在接口调用时需要参考）。如需查看调试效果和测试记录，请参见体验效果。

3. API 调用配置

回调方式
应用名称
应用ID
应用描述

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

HTTP post 协议：需要您输入对应 URL 地址，通义听悟会向配置的HTTP URL发送post请求，返回的HTTP status为200则检查通过。
不设置回调（主动轮询）：如果您选择不设置回调，自行主动轮询，可使用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": "***"
  }
}