通話後の文字起こしカテゴリの作成

通話後分析ではカスタムカテゴリの作成がサポートされているため、特定のビジネスニーズに合わせてトランスクリプト分析を調整できます。

さまざまなシナリオをカバーするカテゴリをいくつでも作成できます。作成するカテゴリごとに、1 から 20 のルールを作成する必要があります。各ルールは、中断、キーワード、非通話時間、感情という 4 つの基準のいずれかに基づいています。CreateCallAnalyticsCategory オペレーションでこれらの基準を使用する詳細については、「通話後分析カテゴリのルールの条件 セクション」を参照してください。

メディア内のコンテンツが、指定したカテゴリのすべてのルールに一致する場合、 Amazon Transcribe は出力にそのカテゴリのラベル付けを行います。出力のカテゴリ一致の例については、「呼び出しカテゴリ化JSON出力」を参照してください。

カスタムカテゴリを使用してできるその他の例を紹介します。

通話後カテゴリとリアルタイムカテゴリ

新しいカテゴリを作成する場合、通話後分析カテゴリ (POST_CALL) として作成するか、リアルタイム通話分析カテゴリ (REAL_TIME) として作成するかを指定できます。オプションを指定しない場合、カテゴリはデフォルトで通話後カテゴリとして作成されます。通話後分析カテゴリマッチは、通話後分析の文字起こしが完了すると、出力に表示されます。

通話後分析用の新しいカテゴリを作成するには、AWS Management Console、AWS CLI、または を使用できますAWS SDKs。例については、以下を参照してください。

aws transcribe create-call-analytics-category \
--cli-input-json file://filepath/my-first-analytics-category.json

{
  "CategoryName": "my-new-category",
  "InputType": "POST_CALL",
  "Rules": [
        {
            "InterruptionFilter": {
                "AbsoluteTimeRange": {
                    "First": 60000
                },
                "Negate": false,
                "ParticipantRole": "CUSTOMER",
                "Threshold": 10000
            }
        },
        {
            "NonTalkTimeFilter": {
                "Negate": false,
                "RelativeTimeRange": {
                    "EndPercentage": 80,
                    "StartPercentage": 10
                },
                "Threshold": 20000
            }
        },
        {
            "SentimentFilter": {
                "ParticipantRole": "AGENT",
                "Sentiments": [
                    "NEGATIVE"                    
                ]
            }
        },
        {
            "TranscriptFilter": {
                "Negate": true,
                "AbsoluteTimeRange": {
                    "First": 10000
                },
                "Targets": [
                    "welcome",
                    "hello"
                ],
                "TranscriptFilterType": "EXACT"
            }
        }
    ]
}

from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
category_name = "my-new-category"
transcribe.create_call_analytics_category(
    CategoryName = category_name,
    InputType = POST_CALL,
    Rules = [
        {
            'InterruptionFilter': {
                'AbsoluteTimeRange': {
                    'First': 60000
                },
                'Negate': False,
                'ParticipantRole': 'CUSTOMER',
                'Threshold': 10000
            }
        },
        {
            'NonTalkTimeFilter': {
                'Negate': False,
                'RelativeTimeRange': {
                    'EndPercentage': 80,
                    'StartPercentage': 10
                },
                'Threshold': 20000
            }
        },
        {
            'SentimentFilter': {
                'ParticipantRole': 'AGENT',
                'Sentiments': [
                    'NEGATIVE'                    
                ]
            }
        },
        {
            'TranscriptFilter': {
                'Negate': True,
                'AbsoluteTimeRange': {
                    'First': 10000
                },
                'Targets': [
                    'welcome',
                    'hello'
                ],
                'TranscriptFilterType': 'EXACT'
            }
        }
    ]
    
)

result = transcribe.get_call_analytics_category(CategoryName = category_name)    
print(result)

通話後分析カテゴリのルールの条件

このセクションでは、 CreateCallAnalyticsCategoryAPIオペレーションを使用して作成できるカスタムPOST_CALLルールのタイプについて説明します。

中断マッチ

中断 (InterruptionFilter データタイプ) を使用するルールは、以下と一致するように設計されています。

InterruptionFilter で使用できるパラメータの例を以下に示します。

"InterruptionFilter": { 
    "AbsoluteTimeRange": { 
       Specify the time frame, in milliseconds, when the match should occur
    },
    "RelativeTimeRange": { 
       Specify the time frame, in percentage, when the match should occur
    },
    "Negate": Specify if you want to match the presence or absence of interruptions,
    "ParticipantRole": Specify if you want to match speech from the agent, the customer, or both,    
    "Threshold": Specify a threshold for the amount of time, in seconds, interruptions occurred during the call
},

これらのパラメータとそれぞれに関連する有効な値の詳細については、「CreateCallAnalyticsCategory」および「InterruptionFilter」を参照してください。

キーワードマッチ

キーワード (TranscriptFilter データタイプ) を使用するルールは、以下と一致するように設計されています。

TranscriptFilter で使用できるパラメータの例を以下に示します。

"TranscriptFilter": { 
    "AbsoluteTimeRange": { 
       Specify the time frame, in milliseconds, when the match should occur
    },
    "RelativeTimeRange": { 
       Specify the time frame, in percentage, when the match should occur
    },
    "Negate": Specify if you want to match the presence or absence of your custom keywords,
    "ParticipantRole": Specify if you want to match speech from the agent, the customer, or both,
    "Targets": [ The custom words and phrases you want to match ],
    "TranscriptFilterType": Use this parameter to specify an exact match for the specified targets
}

これらのパラメータとそれぞれに関連する有効な値の詳細については、「CreateCallAnalyticsCategory」および「TranscriptFilter」を参照してください。

非通話時間マッチ

非通話時間 (NonTalkTimeFilter データタイプ) を使用するルールは、以下と一致するように設計されています。

NonTalkTimeFilter で使用できるパラメータの例を以下に示します。

"NonTalkTimeFilter": { 
    "AbsoluteTimeRange": { 
 Specify the time frame, in milliseconds, when the match should occur
 },
    "RelativeTimeRange": { 
 Specify the time frame, in percentage, when the match should occur
 },
    "Negate": Specify if you want to match the presence or absence of speech,      
    "Threshold": Specify a threshold for the amount of time, in seconds, silence (or speech) occurred during the call
},

これらのパラメータとそれぞれに関連する有効な値の詳細については、「CreateCallAnalyticsCategory」および「NonTalkTimeFilter」を参照してください。

感情マッチ

感情 (SentimentFilter データタイプ) を使用するルールは、以下と一致するように設計されています。

SentimentFilter で使用できるパラメータの例を以下に示します。

"SentimentFilter": { 
    "AbsoluteTimeRange": { 
    Specify the time frame, in milliseconds, when the match should occur
    },
    "RelativeTimeRange": { 
    Specify the time frame, in percentage, when the match should occur
    },
    "Negate": Specify if you want to match the presence or absence of your chosen sentiment,
    "ParticipantRole": Specify if you want to match speech from the agent, the customer, or both,    
    "Sentiments": [ The sentiments you want to match ]
},

これらのパラメータとそれぞれに関連する有効な値の詳細については、「CreateCallAnalyticsCategory」および「SentimentFilter」を参照してください。