지원 종료 공지: 2025년 9월 15 AWS 일에는 Amazon Lex V1에 대한 지원을 중단할 예정입니다. 2025년 9월 15일 이후에는 Amazon Lex V1 콘솔 또는 Amazon Lex V1 리소스에 더 이상 액세스할 수 없습니다. Amazon Lex V2를 사용하는 경우 대신 [Amazon Lex V2 가이드를](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 참조하세요.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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](#API_GetUtterancesView_RequestSyntax) **
표현 정보를 반환해야 하는 봇의 이름.
길이 제약: 최소 길이는 2. 최대 길이는 50.
패턴: `^([A-Za-z]_?)+$`
필수 여부: 예
** [botVersions](#API_GetUtterancesView_RequestSyntax) **
표현 정보를 반환해야 하는 봇 버전의 배열. 요청당 5개 버전으로 제한됩니다.
배열 멤버: 최소 항목 수는 1개. 최대 항목 수는 5개.
길이 제약: 최소 길이는 1. 최대 길이는 64.
패턴: `\$LATEST|[0-9]+`
필수 여부: 예
** [statusType](#API_GetUtterancesView_RequestSyntax) **
인식되고 처리된 표현을 반환하려면 `Detected`을 사용하십시오. 인식되지 않은 표현을 반환하려면 `Missed`을 사용하십시오.
유효한 값: `Detected | Missed`
필수 사항 여부: 예
## 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](#API_GetUtterancesView_ResponseSyntax) **
표현 정보를 반환해야 하는 봇의 이름.
유형: 문자열
길이 제한: 최소 길이는 2. 최대 길이는 50.
패턴: `^([A-Za-z]_?)+$`
** [utterances](#API_GetUtterancesView_ResponseSyntax) **
각 [UtteranceList](API_UtteranceList.md) 객체에는 봇이 처리한 표현을 설명하는 [UtteranceData](API_UtteranceData.md) 객체 목록이 들어 있는 객체 배열입니다. 응답에는 각 버전당 최대 100개의 `UtteranceData` 객체가 포함됩니다. Amazon Lex는 봇이 지난 15일 동안 가장 자주 받은 표현을 반환합니다.
타입: [UtteranceList](API_UtteranceList.md) 객체 배열
## Errors
** BadRequestException **
요청이 제대로 구성되지 않았습니다. 예를 들어, 값이 유효하지 않거나 필수 필드가 누락된 경우입니다. 필드 값을 확인한 후 다시 시도하세요.
HTTP 상태 코드: 400
** InternalFailureException **
내부 Amazon Lex 오류가 발생했습니다. 요청을 다시 시도하세요.
HTTP 상태 코드: 500
** LimitExceededException **
요청이 한도를 초과했습니다. 다시 요청해 보세요.
HTTP 상태 코드: 429
## 참고 항목
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)