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

APIs 분석에 사용

이 섹션에서는 봇에 대한 분석을 검색하는 데 사용하는 API 작업에 대해 설명합니다.

결과 필터링

분석 API 요청을 수행하려면 startTime 및 를 지정해야 합니다endTime. 는 이후에 시작startTime되어 이전에 종료된 세션, 의도, 의도 단계 또는 발화를 API 반환합니다endTime.

filters 는 분석 API 요청의 선택적 필드입니다. AnalyticsSessionFilter, AnalyticsIntentFilterAnalyticsIntentStageFilter, 또는 AnalyticsUtteranceFilter 객체 목록에 매핑됩니다. 각 객체에서 필드를 사용하여 필터링 기준으로 사용할 식을 만드십시오. 예를 들어 목록에 다음 필터를 추가하면 봇은 30초 이상의 대화를 검색합니다.

{
    "name": "Duration",
    "operator": "GT",
    "value": "30 sec",
}

봇에 대한 지표 검색

ListSessionMetrics, ListIntentMetrics, ListIntentStageMetrics 및 ListUtteranceMetrics 작업을 사용하여 세션, 의도, 의도 단계 및 발화에 대한 요약 지표를 검색할 수 있습니다.

이러한 작업의 경우 다음 필수 필드를 채우십시오.

요청의 나머지 필드는 선택 사항입니다. 다음과 같은 방법으로 결과를 필터링하고 구성할 수 있습니다.

다음 필드를 사용하여 응답 표시를 처리하세요.

ListUtteranceMetrics를 사용하는 경우 attributes 필드에 반환할 속성을 지정할 수 있습니다. 이 필드는 단일 AnalyticsUtteranceAttribute 객체가 포함된 목록에 매핑됩니다. 발화 당시 Amazon Lex V2가 사용 중인 인텐트를 반환하려면 name 필드에 LastUsedIntent를 지정하세요.

응답에서 results 필드는 , AnalyticsSessionResult, AnalyticsIntentResult AnalyticsIntentStageResult또는 AnalyticsUtteranceResult 객체 목록에 매핑됩니다. 각 객체에는 지정한 메서드에서 만든 구간차원 또는 그룹 외에도 요청한 지표에 대한 요약 통계 값을 반환하는 metrics 필드가 포함되어 있습니다.

봇의 세션 및 발화에 대한 메타데이터 검색

ListSessionAnalyticsData 및 ListUtteranceAnalyticsData 작업을 사용하여 개별 세션 및 발화에 대한 메타데이터를 검색합니다.

필수 startTime 및 endTime 필드를 입력하여 결과를 검색할 시간 범위를 정의합니다.

요청의 나머지 필드는 선택 사항입니다. 결과를 필터링하고 정렬하는 방법:

다음 필드를 사용하여 응답 표시를 처리하세요.

응답에서 sessions 또는 utterances 필드는 SessionSpecification 또는 UtteranceSpecification 객체 목록에 매핑됩니다. 각 객체에는 단일 세션 또는 발화에 대한 메타데이터가 들어 있습니다.

봇의 세션 및 발화에 대한 메타데이터 검색

ListIntentPaths 작업을 사용하여 고객이 봇과 대화할 때 의도의 순서에 대한 지표를 검색합니다.

이 작업을 수행하려면 다음 필수 필드를 채우십시오.

선택적인 filters 필드를 사용하여 결과를 필터링할 수 있습니다. 자세한 내용은 결과 필터링를 참조하세요.

Lex V2 대화의 발화 통계 보기

발화 통계를 사용하여 사용자가 봇에 보내는 발화를 확인할 수 있습니다. Amazon Lex V2에서 성공적으로 감지한 발화와 감지하지 못한 발화를 모두 볼 수 있습니다. 이 정보를 사용하여 봇을 조정하는 데 도움을 줄 수 있습니다.

예를 들어, 사용자가 Amazon Lex V2에서 놓친 내용을 보내는 것을 발견한 경우 해당 발화를 의도에 추가할 수 있습니다. 의도의 초안 버전이 새 말로 업데이트되므로 봇에 배포하기 전에 테스트할 수 있습니다.

Amazon Lex V2가 해당 발화를 봇용으로 구성된 의도를 호출하려는 시도로 인식하면 발화가 감지됩니다. Amazon Lex V2가 표현을 인식하지 못하고 대신 AMAZON.FallbackIntent를 호출하면 표현을 놓친 것입니다.

및 ListAggregatedUtterance 를 사용하여 비관 통계ListUtteranceMetricsAPI를 볼 수 있습니다API.

다음 조건에서는 를 사용하여 비관 통계ListUtteranceMetricsAPI가 생성되지 않습니다.

는 다음과 같은 추가 기능을 ListUtteranceMetrics API 제공합니다.

다음 조건에서는 를 사용하여 비관 통계ListAggregatedUtteranceAPI가 생성되지 않습니다.

는 다음과 같은 기능을 ListAggregatedUtterance API 제공합니다.

발화 통계를 사용하면 봇 상호 작용에서 해당 발화가 마지막으로 사용된 시간과 함께 특정 발화가 감지되었는지 또는 누락되었는지 확인할 수 있습니다.

Amazon Lex V2는 사용자가 봇과 상호 작용하는 동안 지속적으로 발화를 저장합니다. 콘솔 또는 ListAggregatedUtterances 작업을 사용하여 통계를 쿼리할 수 있습니다. 데이터 보존 기간은 15일이며, 사용자가 데이터 스토리지에서 옵트아웃한 경우에는 사용할 수 없습니다. DeleteUtterances 작업을 사용하거나 데이터 스토리지에서 옵트아웃하여 발화를 삭제할 수 있습니다. AWS 계정을 닫으면 모든 발화가 삭제됩니다. 저장된 발화는 서버에서 관리하는 키로 암호화됩니다.

봇 버전을 삭제하면 ListUtteranceMetrics를 사용하여 최대 30일 동안 버전에 대한 발화 통계를 사용할 수 있고 ListAggregatedUtterances를 사용하여 15일 동안 사용할 수 있습니다. Amazon Lex V2 콘솔에서는 삭제된 버전에 대한 통계를 볼 수 없습니다. 삭제된 버전의 통계를 보려면 ListAggregatedUtterances 및 ListUtteranceMetrics 작업을 모두 사용할 수 있습니다.

ListAggregatedUtterances 및 ListUtteranceMetrics 를 모두 사용하면 APIs발화가 발화의 텍스트로 집계됩니다. 예를 들어 고객이 “피자를 주문하고 싶어요”라는 문구를 사용한 모든 인스턴스는 응답에서 동일한 행으로 집계됩니다. RecognizeUtterance 작업을 사용할 때 사용되는 텍스트는 입력 트랜스크립트입니다.

ListAggregatedUtterances 및 ListUtteranceMetrics 를 사용하려면 역할에 다음 정책을 APIs적용합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "ListAggregatedUtterancesPolicy",
            "Effect": "Allow",
            "Action": "lex:ListAggregatedUtterances",
            "Resource": "*"
        }
    ]
}