기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # CreateCallAnalyticsCategory 새 통화 분석 범주를 만듭니다. 모든 카테고리는 Call Analytics 트랜스크립션에 자동으로 적용됩니다. 참고로, 카테고리는 소급 적용할 수 없으므로 트랜스크립션 요청을 제출하기 전에 카테고리를 생성해야 합니다. 새 범주를 작성할 때`InputType` 매개변수를 사용하여 범주에 A`POST_CALL``REAL_TIME` 또는 범주로 레이블을 지정할 수 있습니다. `POST_CALL`카테고리는 통화 후 트랜스크립션에만 적용할 수 있으며`REAL_TIME` 카테고리는 실시간 트랜스크립션에만 적용할 수 있습니다. `InputType`포함하지 않으면 기본적으로 범주가`POST_CALL` 범주로 생성됩니다. 통화 분석 카테고리는 규칙으로 구성됩니다. 각 범주에 대해 1\$120개 사이의 규칙을 만들어야 합니다. 규칙에는[InterruptionFilter](API_InterruptionFilter.md),[NonTalkTimeFilter](API_NonTalkTimeFilter.md)[SentimentFilter](API_SentimentFilter.md), 및 매개 변수가 포함될 수[TranscriptFilter](API_TranscriptFilter.md) 있습니다. 기존 범주를 업데이트하려면 을 참조하십시오[UpdateCallAnalyticsCategory](API_UpdateCallAnalyticsCategory.md). Call Analytics 카테고리에 대해 자세히 알아보려면 [통화 후 트랜스크립션을 위한 카테고리 만들기 및 실시간 트랜스크립션을](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-batch.html) [위한 카테고리 만들기를](https://docs.aws.amazon.com/transcribe/latest/dg/tca-categories-stream.html) 참조하세요. ## 요청 구문 ``` { "CategoryName": "string", "InputType": "string", "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] } ``` ## 요청 파라미터 모든 동작에 공통되는 매개 변수에 대한 자세한 내용은 [일반 매개 변수를](CommonParameters.md) 참조하십시오. 요청은 JSON 형식의 다음 데이터를 받습니다. ** [CategoryName](#API_CreateCallAnalyticsCategory_RequestSyntax) ** 통화 분석 카테고리에서 사용자가 선택한 고유한 이름입니다. future 이해할 수 있는 상세한 이름 지정 시스템을 사용하는 것이 좋습니다. 예를 들어, 와 같은 일반 이름보다 카테고리에 사용하는`sentiment-positive-last30seconds` 것이 좋습니다`test-category`. 범주 이름은 대/소문자를 구분합니다. 유형: String 길이 제약: 최소 길이는 1입니다. 최대 길이는 200입니다. 패턴: `^[0-9a-zA-Z._-]+` 필수 항목 여부: 예 ** [InputType](#API_CreateCallAnalyticsCategory_RequestSyntax) ** Call Analytics 트랜스크립션에 실시간 또는 통화 후 카테고리를 만들지 여부를 선택하세요. 지정하면 통화 후 트랜스크립션에 카테고리가`POST_CALL` 할당됩니다. 이 입력 유형의 카테고리는 스트리밍 (실시간) 트랜스크립션에 적용할 수 없습니다. 지정하면 스트리밍 트랜스크립션에 카테고리가`REAL_TIME` 할당됩니다. 이 입력 유형의 카테고리는 통화 후 트랜스크립션에 적용할 수 없습니다. `InputType`포함하지 않으면 기본적으로 카테고리가 통화 후 카테고리로 생성됩니다. 유형: String 유효한 값:` REAL_TIME | POST_CALL` Required: No ** [Rules](#API_CreateCallAnalyticsCategory_RequestSyntax) ** 규칙은 통화 분석 범주를 정의합니다. 새 범주를 만들 때는 해당 범주에 대해 1\$120개 사이의 규칙을 만들어야 합니다. 각 규칙에서 호출 속성에 적용할 필터를 지정합니다. 예를 들어, 통화 마지막 30초 동안 고객의 감정이 긍정적이었는지 감지하는 감정 필터를 선택할 수 있습니다. 유형: [Rule](API_Rule.md) 객체 배열 배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다. 필수 항목 여부: 예 ## 응답 구문 ``` { "CategoryProperties": { "CategoryName": "string", "CreateTime": number, "InputType": "string", "LastUpdateTime": number, "Rules": [ { "InterruptionFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "NonTalkTimeFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Threshold": number }, "SentimentFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Sentiments": [ "string" ] }, "TranscriptFilter": { "AbsoluteTimeRange": { "EndTime": number, "First": number, "Last": number, "StartTime": number }, "Negate": boolean, "ParticipantRole": "string", "RelativeTimeRange": { "EndPercentage": number, "First": number, "Last": number, "StartPercentage": number }, "Targets": [ "string" ], "TranscriptFilterType": "string" } } ] } } ``` ## 응답 요소 작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [CategoryProperties](#API_CreateCallAnalyticsCategory_ResponseSyntax) ** 새 카테고리의 속성 (관련 규칙 포함) 을 제공합니다. 유형: [CategoryProperties](API_CategoryProperties.md) 객체 ## 오류 모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오[일반적인 오류](CommonErrors.md). ** BadRequestException ** 요청이 하나 이상의 검증 테스트를 통과하지 못했습니다. 이는 삭제하려는 개체가 존재하지 않거나 비터미널 상태 (예:`IN PROGRESS`) 일 때 발생할 수 있습니다. 자세한 내용은 예외 메시지 필드를 참조하십시오. HTTP 상태 코드: 400 ** ConflictException ** 이 이름을 가진 리소스가 이미 있습니다. 리소스 이름은 내에서 고유해야AWS 계정 합니다. HTTP 상태 코드: 400 ** InternalFailureException ** 에 내부 오류가 발생했습니다. 오류 메시지를 확인하고 문제를 해결한 다음 요청을 다시 시도하세요. HTTP 상태 코드: 500 ** LimitExceededException ** 요청을 너무 많이 보냈거나 입력 파일이 너무 깁니다. 요청을 재시도하기 전에 기다리거나 더 작은 파일을 사용하여 요청을 다시 시도하세요. HTTP 상태 코드: 400 ## 참고 항목 이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요. + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWSSDK를 위한 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/CreateCallAnalyticsCategory) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/CreateCallAnalyticsCategory)