GetUtterancesView - Amazon Lex V1

Amazon Lex V2를 사용하는 경우 Amazon Lex V2 가이드를 대신 참조하십시오.

 

Amazon Lex V1을 사용하는 경우 봇을 Amazon Lex V2로 업그레이드하는하는 것이 좋습니다. 더 이상 V1에 새로운 기능을 추가하지 않으므로 모든 새 봇에 V2를 사용할 것을 강력히 권장합니다.

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

GetUtterancesView

GetUtterancesView 작업을 사용하여 사용자가 봇에 대해 한 표현 정보를 가져옵니다. 이 목록을 사용하여 봇이 반응하는 표현을 조정할 수 있습니다.

예를 들어 꽃을 주문하는 봇을 만들었다고 가정합니다. 사용자가 한동안 봇을 사용한 후 GetUtterancesView 작업을 사용하여 요청한 내용과 성공 여부를 확인하세요. “꽃을 원해요”라는 표현이 인식되지 않을 수도 있습니다. 이 표현을 OrderFlowers 의도에 추가하여 봇이 해당 표현을 인식하도록 할 수 있습니다.

새 버전의 봇을 게시한 후에는 이전 버전과 새 버전에 대한 정보를 얻을 수 있으므로 두 버전의 성능을 비교할 수 있습니다.

표현 통계는 매일 한 번 생성됩니다. 데이터는 지난 15일 동안 사용할 수 있습니다. 각 요청에서 최대 5개 버전의 봇에 대한 정보를 요청할 수 있습니다. Amazon Lex는 봇이 지난 15일 동안 가장 자주 받은 표현을 반환합니다. 응답에는 각 버전에 대한 최대 100개의 표현에 대한 정보가 포함됩니다.

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

  • 봇이 생성될 때 childDirected 필드는 참으로 설정되었습니다.

  • 하나 이상의 슬롯에서 슬롯 난독화 기능을 사용하고 있습니다.

  • Amazon Lex 개선에 참여하지 않기로 선택했습니다.

이 작업에는 lex:GetUtterancesView 액션에 대한 권한이 필요합니다.

Request Syntax

GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1

URI 요청 파라미터

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

botname

표현 정보를 반환해야 하는 봇의 이름.

길이 제약: 최소 길이는 2. 최대 길이는 50.

패턴: ^([A-Za-z]_?)+$

필수 사항 여부: Yes

botVersions

표현 정보를 반환해야 하는 봇 버전의 배열. 요청당 5개 버전으로 제한됩니다.

배열 멤버: 최소 항목 수는 1개. 최대 항목 수는 5개.

길이 제약: 최소 길이는 1. 최대 길이는 64.

패턴: \$LATEST|[0-9]+

필수 사항 여부: Yes

statusType

인식되고 처리된 표현을 반환하려면 Detected을 사용하십시오. 인식되지 않은 표현을 반환하려면 Missed을 사용하십시오.

유효 값: Detected | Missed

필수 사항 여부: Yes

Request Body

해당 요청에는 본문이 없습니다.

Response Syntax

HTTP/1.1 200 Content-type: application/json { "botName": "string", "utterances": [ { "botVersion": "string", "utterances": [ { "count": number, "distinctUsers": number, "firstUtteredDate": number, "lastUtteredDate": number, "utteranceString": "string" } ] } ] }

응답 요소

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

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

botName

표현 정보를 반환해야 하는 봇의 이름.

타입: 문자열

길이 제한: 최소 길이는 2. 최대 길이는 50.

패턴: ^([A-Za-z]_?)+$

utterances

UtteranceList 객체에는 봇이 처리한 표현을 설명하는 UtteranceData 객체 목록이 들어 있는 객체 배열입니다. 응답에는 각 버전당 최대 100개의 UtteranceData 객체가 포함됩니다. Amazon Lex는 봇이 지난 15일 동안 가장 자주 받은 표현을 반환합니다.

타입: UtteranceList 객체 배열

Errors

BadRequestException

요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.

HTTP 상태 코드: 400

InternalFailureException

내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.

HTTP 상태 코드: 500

LimitExceededException

요청이 한도를 초과했습니다. 다시 요청해 보세요.

HTTP 상태 코드: 429

참고 항목

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