ListAggregatedUtterances - Amazon Lex

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

ListAggregatedUtterances

사용자가 봇에 보낸 발언 목록을 제공합니다.

발언은 발화의 텍스트에 의해 집계됩니다. 예를 들어 고객이 “피자를 주문하고 싶습니다”라는 문구를 사용한 모든 인스턴스는 응답에서 같은 줄로 집계됩니다.

감지된 발언과 놓친 발언을 모두 볼 수 있습니다. 탐지된 발언은 봇이 발언을 올바르게 인식하고 관련 의도를 활성화한 곳입니다. 놓친 발언은 봇에 의해 인식되지 않았으며 인텐트를 활성화하지 않았습니다.

발언은 봇 별칭이나 봇 버전에 대해 집계될 수 있지만 동시에 둘 다 집계할 수는 없습니다.

다음 조건에서는 발화 통계가 생성되지 않습니다.

  • childDirected봇이 생성될 때 필드가 true로 설정되었습니다.

  • 하나 이상의 슬롯이 있는 슬롯 난독화를 사용하고 있습니다.

  • Amazon Lex 개선에 참여하지 않으셨습니다.

요청 구문

POST /bots/botId/aggregatedutterances/ HTTP/1.1 Content-type: application/json { "aggregationDuration": { "relativeAggregationDuration": { "timeDimension": "string", "timeValue": number } }, "botAliasId": "string", "botVersion": "string", "filters": [ { "name": "string", "operator": "string", "values": [ "string" ] } ], "localeId": "string", "maxResults": number, "nextToken": "string", "sortBy": { "attribute": "string", "order": "string" } }

URI 요청 파라미터

요청은 다음의 URI 파라미터를 사용합니다.

botId

이 요청과 연결된 봇의 고유 식별자입니다.

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

: 필수 예

요청 본문

요청은 JSON 형식의 다음 데이터를 받습니다.

aggregationDuration

발화 정보를 집계하기 위한 시간 창입니다. 한 시간에서 2주 사이의 시간을 지정할 수 있습니다.

유형: UtteranceAggregationDuration 객체

: 필수 예

botAliasId

이 요청과 연결된 봇 별칭의 식별자입니다. 봇 별칭을 지정하는 경우 봇 버전을 지정할 수 없습니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^(\bTSTALIASID\b|[0-9a-zA-Z]+)$

: 필수 아니요

botVersion

이 요청과 연결된 봇 버전의 식별자입니다. 봇 버전을 지정하는 경우 봇 별칭을 지정할 수 없습니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.

Pattern: ^(DRAFT|[0-9]+)$

: 필수 아니요

filters

응답의 발언을 필터 사양과 일치하는 문자로만 제한하는 데 사용되는 필터의 사양을 제공합니다. 필터링할 필터 하나와 문자열 하나만 지정할 수 있습니다.

Type: 배열AggregatedUtterancesFilter사물

배열 멤버: 고정 항목 수는 1개입니다.

: 필수 아니요

localeId

발언이 수집된 언어 및 로케일의 식별자입니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어.

Type: 문자열

: 필수 예

maxResults

결과의 각 페이지에서 반환할 최대 발언 수입니다. 최대 페이지 크기보다 결과가 적으면 실제 결과 수만 반환됩니다. 를 지정하지 않은 경우maxResults매개 변수, 1,000개의 결과가 반환됩니다.

Type: 정수

유효 범위: 최소값 1입니다. 최대값 1000입니다.

: 필수 아니요

nextToken

에서 응답하는 경우ListAggregatedUtterances작업에 지정된 더 많은 결과가 포함되어 있습니다.maxResults매개 변수를 사용하면 토큰이 응답에서 반환됩니다. 에서 해당 토큰을 사용합니다.nextToken결과의 다음 페이지를 반환하는 매개 변수입니다.

Type: 문자열

: 필수 아니요

sortBy

발화 목록에 대한 정렬 매개 변수를 지정합니다. 적중 횟수, 누락된 횟수 또는 발언이 나타난 별개의 세션 수를 기준으로 정렬할 수 있습니다.

유형: AggregatedUtterancesSortBy 객체

: 필수 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "aggregatedUtterancesSummaries": [ { "containsDataFromDeletedResources": boolean, "hitCount": number, "missedCount": number, "utterance": "string", "utteranceFirstRecordedInAggregationDuration": number, "utteranceLastRecordedInAggregationDuration": number } ], "aggregationDuration": { "relativeAggregationDuration": { "timeDimension": "string", "timeValue": number } }, "aggregationLastRefreshedDateTime": number, "aggregationWindowEndTime": number, "aggregationWindowStartTime": number, "botAliasId": "string", "botId": "string", "botVersion": "string", "localeId": "string", "nextToken": "string" }

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

aggregatedUtterancesSummaries

집계된 발언 데이터의 요약입니다. 각 응답에는 해당 기간 동안 발언이 표시된 횟수, 감지 또는 누락되었는지 여부, 해당 기간 동안 발언이 표시되었는지에 대한 정보가 포함되어 있습니다.

Type: 배열AggregatedUtterancesSummary사물

aggregationDuration

발화 데이터를 집계하는 데 사용되는 기간입니다.

유형: UtteranceAggregationDuration 객체

aggregationLastRefreshedDateTime

집계된 데이터가 수집된 마지막 날짜와 시간입니다. 기간은 집계 창의 길이에 따라 달라집니다.

  • 시간- 1 시간 창, 30 분마다; 그렇지 않으면 매 시간마다.

  • - 6시간마다

  • - 1 주일 시간 동안, 12 시간마다; 그렇지 않으면 매일

Type: 타임스탬프

aggregationWindowEndTime

합산 윈도우가 끝나는 날짜와 시간입니다. 시작 시간과 종료 시간 사이에 수집된 데이터만 결과에 반환됩니다.

Type: 타임스탬프

aggregationWindowStartTime

합산 윈도우가 시작되는 날짜와 시간입니다. 이 시간 이후에 수집된 데이터만 결과에 반환됩니다.

Type: 타임스탬프

botAliasId

발언이 포함된 봇 별칭의 식별자입니다. 봇 버전을 지정한 경우 봇 별칭 ID가 반환되지 않습니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^(\bTSTALIASID\b|[0-9a-zA-Z]+)$

botId

발언이 포함된 봇의 식별자입니다.

Type: 문자열

길이 제약 조건: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

botVersion

발언이 포함된 봇 버전의 식별자입니다. 봇 별칭을 지정한 경우 봇 버전이 반환되지 않습니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 5입니다.

Pattern: ^(DRAFT|[0-9]+)$

localeId

발언이 속해 있는 언어 및 로케일의 식별자입니다.

Type: 문자열

nextToken

에 대한 응답으로 반환할 결과가 더 있는지 여부를 나타내는 토큰ListAggregatedUtterances작업. 만약nextToken필드가 있으면 내용을 다음과 같이 보냅니다.nextTokena 매개 변수ListAggregatedUtterances결과의 다음 페이지를 가져오는 작업 요청입니다.

Type: 문자열

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

InternalServerException

서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 500

PreconditionFailedException

하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.

HTTP 상태 코드: 412

ThrottlingException

요청량이 너무 높습니다. 요청 횟수를 줄입니다.

HTTP 상태 코드: 429

ValidationException

요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.