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를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.