StartCallAnalyticsJob - Amazon Transcribe
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

StartCallAnalyticsJob

启动异步分析作业,该作业不仅转录来电人和座席的音频录制,而且还返回更多的见解。这些见解包括来电者或代理人说话的速度或大声。要通过分析工作获取其他见解,请创建类别。类别是一种基于属性(例如客户的情绪或通话期间使用的特定短语)对分析工作进行分类的方法。有关更多信息,请参阅 。CreateCallAnalyticsCategoryoperation.

请求语法

{ "CallAnalyticsJobName": "string", "ChannelDefinitions": [ { "ChannelId": number, "ParticipantRole": "string" } ], "DataAccessRoleArn": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "OutputEncryptionKMSKeyId": "string", "OutputLocation": "string", "Settings": { "ContentRedaction": { "RedactionOutput": "string", "RedactionType": "string" }, "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageModelName": "string", "LanguageOptions": [ "string" ], "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }

请求参数

有关所有操作通用的参数的信息,请参阅常见参数.

请求接受采用 JSON 格式的以下数据。

CallAnalyticsJobName

通话分析任务的名称。您不能使用字符串 “。” 或 “..” 自己作为任务名称。该名称还必须在Amazonaccount. 如果你尝试创建与之前的通话分析工作同名的呼叫分析作业,你会得到ConflictException错误消息。

类型: 字符串

长度约束:最小长度为 1。最大长度为 200。

模式:^[0-9a-zA-Z._-]+

:必需 是

ChannelDefinitions

开始呼叫分析工作时,必须传递一个阵列,将座席和客户映射到特定音频频道。您可以分配给频道的值为 0 和 1。代理商和客户必须各自拥有自己的渠道。您不能为代理商或客户分配多个渠道。

类型: 数组ChannelDefinition对象

数组成员:修复 2 项。

:必需 否

DataAccessRoleArn

角色的 Amazon 资源名称 (ARN),此角色具有访问包含输入文件的 S3 存储桶的权限。Amazon Transcribe 承担此角色来读取队列中的音频文件。如果您为转录结果指定了输出 S3 存储桶,则此角色也应该有权访问输出存储桶。

类型: 字符串

长度约束:最小长度为 20。长度上限为 2048。

模式:^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

:必需 是

Media

描述在转录请求中媒体文件。

类型:Media 对象

:必需 是

OutputEncryptionKMSKeyId

的 Amazon 资源名称 (ARN)Amazon用于加密呼叫分析作业输出的密钥管理服务密钥。调用StartCallAnalyticsJob操作必须具有使用指定 KMS 密钥的权限。

您可以使用以下任一选项来标识Amazon当前账户中的 KMS 密钥:

  • KMS 密钥 ID:“1234abcd-12ab-34cd-56ef-1234567890ab”

  • KMS 密钥别名:“alias/ExampleAlias”

您可以使用以下任意方法来标识当前账户或其他账户中的 KMS 密钥:

  • 当前账户或其他账户中 KMS 密钥的 Amazon 资源名称 (ARN):“arn: aws: kms: 区域:AcID: key/1234CD-34CD-34CD-34CD-56ef12345890ab”

  • KMS 密钥别名的 ARN:“arn:aws:kms:region:account ID:alias/ExampleAlias”

如果未指定加密密钥,则将使用默认 Amazon S3 密钥 (SSE-S3) 对呼叫分析作业的输出进行加密。

如果指定 KMS 密钥来加密输出,您还必须在OutputLocation参数。

类型: 字符串

约束:最小长度为 1。长度上限为 2048。

模式:^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

:必需 否

OutputLocation

存储呼叫分析任务输出的 Amazon S3 位置。您可以提供以下位置类型来存储呼叫分析作业的输出:

  • S3://DOCET1

    如果指定存储桶,Amazon Transcribe 会将分析作业的输出保存为 JSON 文件,位于存储桶的根级。

  • s3: //doc-示例bucket1/folder/

    如果您指定路径,Amazon Transcribe 会将分析作业的输出保存为 s3://doc-示例-bucket1/folder/你的转录作业名称.json

    如果指定文件夹,则必须提供尾随斜杠。

  • s3: //doc-示例bucket1/文件夹/filename.json

    如果您提供的路径指定了文件名,Amazon Transcribe 会将分析作业的输出保存为 s3: //doc-exampleBucket1/folder/filename.json

您可以指定Amazon用于加密分析作业输出的密钥管理服务 (KMS) 密钥,使用OutputEncryptionKMSKeyId参数。如果您未指定 KMS 密钥,Amazon Transcribe 将使用默认 Amazon S3 密钥对 S3 存储桶中放置的分析作业输出进行服务器端加密。

类型: 字符串

约束:最小长度为 1。长度上限为 2000。

模式:(s3://|http(s*)://).+

:必需 否

Settings

一个Settings为呼叫分析作业提供可选设置的对象。

类型:CallAnalyticsJobSettings 对象

:必需 否

响应语法

{ "CallAnalyticsJob": { "CallAnalyticsJobName": "string", "CallAnalyticsJobStatus": "string", "ChannelDefinitions": [ { "ChannelId": number, "ParticipantRole": "string" } ], "CompletionTime": number, "CreationTime": number, "DataAccessRoleArn": "string", "FailureReason": "string", "IdentifiedLanguageScore": number, "LanguageCode": "string", "Media": { "MediaFileUri": "string", "RedactedMediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "Settings": { "ContentRedaction": { "RedactionOutput": "string", "RedactionType": "string" }, "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageModelName": "string", "LanguageOptions": [ "string" ], "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" }, "StartTime": number, "Transcript": { "RedactedTranscriptFileUri": "string", "TranscriptFileUri": "string" } } }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

CallAnalyticsJob

包含异步调用分析任务详细信息的对象。

类型:CallAnalyticsJob 对象

Errors

有关所有操作常见错误的信息,请参阅常见错误.

BadRequestException

您的请求没有通过一个或多个验证测试。例如,如果您尝试删除的实体不存在,或者它处于非终端状态(例如,它 “正在进行中”)。查看异常Message字段以获取更多信息。

HTTP 状态代码:400

ConflictException

已经有一个具有该名称的资源。

HTTP 状态代码:400

InternalFailureException

发生内部服务器错误。检查错误消息并再次尝试请求。

HTTP 状态代码:500

LimitExceededException

要么您已经发送过多的请求或您的输入文件中包含过长的请求。等待,然后再重新发送您的请求,或使用较小的文件,然后重新发送请求。

HTTP 状态代码:400

另请参阅

有关在特定语言的Amazon软件开发工具包中使用此 API 的更多信息,请参阅以下内容: