本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 启动通话后分析转录
<a name="tca-start-batch"></a>

在开始通话后分析转录之前，您必须创建 Amazon Transcribe 要在音频中匹配的所有[类别](tca-categories-batch.md)。

**注意**  
呼叫分析转录无法追溯性地与新类别匹配。只有您在启动呼叫分析转录*之前*创建的类别才能应用于该转录输出。

如果您创建了一个或多个类别，并且您的音频与至少一个类别中的所有规则匹配， Amazon Transcribe 会使用匹配的类别来标记您的输出。如果您选择不使用类别，或者您的音频与类别中指定的规则不匹配，则不会标记您的转录。

要开始通话后分析转录，你可以使用**AWS 管理控制台**AWS CLI****、或 **AWS SDKs**；有关示例，请参阅以下内容：

## AWS 管理控制台
<a name="analytics-start-console-batch"></a>

使用以下过程启动通话后分析作业。符合类别定义的所有特点的通话将使用该类别进行标记。

1. 在导航窗格中的 Amazon Transcribe 呼叫分析下，选择**呼叫分析作业**。

1. 请选择**创建任务**。  
![\[Amazon Transcribe 控制台屏幕截图：“呼叫分析作业” 页面。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start.png)

1. 在**指定作业详细信息**页面上，提供有关您的呼叫分析作业的信息，包括输入数据的位置。  
![\[Amazon Transcribe 控制台屏幕截图：“指定任务详细信息” 页面。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-settings1.png)

   指定输出数据的所需 Amazon S3 位置以及要使用的 IAM 角色。  
![\[Amazon Transcribe 控制台屏幕截图：“访问权限” 面板。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-settings2.png)

1. 选择**下一步**。

1. 对于**配置作业**，请打开要包含在呼叫分析作业中的所有可选特征。如果您之前创建了类别，则它们会显示在**类别**面板中，并自动应用于您的呼叫分析作业。  
![\[Amazon Transcribe 控制台屏幕截图：显示所有自定义类别的 “配置作业” 页面。\]](http://docs.aws.amazon.com/zh_cn/transcribe/latest/dg/images/analytics-start-configure.png)

1. 请选择**创建任务**。

## AWS CLI
<a name="analytics-start-cli"></a>

此示例使用[start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html)命令和`channel-definitions`参数。有关更多信息，请参阅[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)和[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html)。

```
aws transcribe start-call-analytics-job \
--region us-west-2 \
--call-analytics-job-name my-first-call-analytics-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-location s3://amzn-s3-demo-bucket/my-output-files/ \
--data-access-role-arn arn:aws:iam::111122223333:role/ExampleRole \
--channel-definitions ChannelId=0,ParticipantRole=AGENT ChannelId=1,ParticipantRole=CUSTOMER
```

以下是另一个使用[start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html)命令的示例，以及为该任务启用 Call Analytics 的请求正文。

```
aws transcribe start-call-analytics-job \
--region us-west-2 \
--cli-input-json file://filepath/my-call-analytics-job.json
```

*my-call-analytics-job.json* 文件包含以下请求正文。

```
{
      "CallAnalyticsJobName": "my-first-call-analytics-job",
      "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole",
      "Media": {
          "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
      },
      "OutputLocation": "s3://amzn-s3-demo-bucket/my-output-files/",
      "ChannelDefinitions": [
          {
              "ChannelId": 0,
              "ParticipantRole": "AGENT"
          },
          {
              "ChannelId": 1,
              "ParticipantRole": "CUSTOMER"
          }
      ]
}
```

## 适用于 Python (Boto3) 的 AWS SDK
<a name="analytics-start-python-batch"></a>

此示例使用 start\$1call\$1analytics [\$1job 方法启动呼叫](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_call_analytics_job)分析作业。 适用于 Python (Boto3) 的 AWS SDK 有关更多信息，请参阅[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)和[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ChannelDefinition.html)。

有关使用的其他示例 AWS SDKs，包括特定功能、场景和跨服务示例，请参阅本章。[使用 Amazon Transcribe 的代码示例 AWS SDKs](service_code_examples.md)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-call-analytics-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
output_location = "s3://amzn-s3-demo-bucket/my-output-files/"
data_access_role = "arn:aws:iam::111122223333:role/ExampleRole"
transcribe.start_call_analytics_job(
     CallAnalyticsJobName = job_name,
     Media = {
        'MediaFileUri': job_uri
     },
     DataAccessRoleArn = data_access_role,
     OutputLocation = output_location,
     ChannelDefinitions = [
        {
            'ChannelId': 0, 
            'ParticipantRole': 'AGENT'
        },
        {
            'ChannelId': 1, 
            'ParticipantRole': 'CUSTOMER'
        }
     ]
)
    
 while True:
   status = transcribe.get_call_analytics_job(CallAnalyticsJobName = job_name)
   if status['CallAnalyticsJob']['CallAnalyticsJobStatus'] in ['COMPLETED', 'FAILED']:
     break
   print("Not ready yet...")
   time.sleep(5)
 print(status)
```