翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 通話の生成要約の有効化
<a name="tca-enable-summarization"></a>

**注記**  
 **Amazon Bedrock を利用:** AWS [自動不正検出](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html)を実装します。生成 AI によるコンタクト後の要約は Amazon Bedrock 上に構築されているため、ユーザーは Amazon Bedrock に実装されている制御を最大限に活用して、人工知能 (AI) の安全性、セキュリティ、責任ある使用を適用できます。

通話の生成要約を通話後の分析ジョブで使用するには、以下の例を参照してください。

## AWS マネジメントコンソール
<a name="analytics-summarization-console"></a>

[要約] パネルで、[通話の生成要約] を有効にすると、概要が出力に表示されます。

![Amazon Transcribe コンソールのスクリーンショット：「Call Analytics jobs」ページ。](http://docs.aws.amazon.com/ja_jp/transcribe/latest/dg/images/analytics-summarization.png)


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

この例では、[start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html) コマンドと `Settings` パラメータを `Summarization` のサブパラメータで使用しています。詳細については、「[https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com//transcribe/latest/APIReference/API_StartCallAnalyticsJob.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
--settings '{"Summarization":{"GenerateAbstractiveSummary":true}}'
```

次に、[start-call-analytics-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-call-analytics-job.html) コマンドと、ジョブの要約を有効にするリクエストボディを使用した別の例を示します。

```
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"
    }
  ],
  "Settings": {
    "Summarization":{
      "GenerateAbstractiveSummary": true
    }
  }
}
```

## AWS SDK for Python (Boto3)
<a name="analytics-summarization-python"></a>

この例では AWS SDK for Python (Boto3) 、 を使用して、[start\_call\_analytics\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_call_analytics_job) メソッドを使用して要約を有効にしたコール分析を開始します。詳細については、「[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartCallAnalyticsJob.html)」を参照してください。

機能固有の例、シナリオ例、クロスサービス例など、 AWS SDKs[SDK を使用した Amazon Transcribe のコード例 AWS SDKs](service_code_examples.md)「」の章を参照してください。

```
from __future__ import print_function
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'
    }
  ],
  Settings = {
    "Summarization":
      {
        "GenerateAbstractiveSummary": true
      }
  }
)
    
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)
```