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

# Amazon Connect 봇 지표 및 분석
<a name="bot-metrics"></a>

[흐름 및 대화형 봇 성능 대시보드](flows-performance-dashboard.md) 및 [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html)에서 다음 흐름 기반 지표를 사용할 수 있습니다.

## 평균 봇 대화 시간
<a name="average-bot-conversation-time-metric"></a>

이 지표는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화의 평균 기간을 측정합니다.

**지표 유형**: 문자열(*hh:mm:ss*)

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `AVG_BOT_CONVERSATION_TIME`

   `BOT_CONVERSATION_OUTCOME_TYPE` 지표 수준 필터를 사용하여 특정 대화 결과를 기준으로 필터링할 수 있습니다.

**계산 로직**:
+ 합계(대화 시작 시간 - 필터링된 모든 대화의 대화 종료 시간)/(필터링된 모든 대화의 수)

**참고**:
+ 이 지표의 데이터는 2024년 12월 2일 0:00:00(GMT)부터 사용할 수 있습니다.

## 평균 봇 대화 턴 수
<a name="average-bot-conversation-turns-metric"></a>

이 지표는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화의 평균 턴 수를 제공합니다.

한 번의 턴은 클라이언트 애플리케이션의 요청과 봇의 응답으로 구성됩니다.

**지표 유형**: 배정밀도

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `AVG_BOT_CONVERSATION_TURNS`

   `BOT_CONVERSATION_OUTCOME_TYPE` 지표 수준 필터를 사용하여 특정 대화 결과를 기준으로 필터링할 수 있습니다.

**계산 로직**:
+ 합계(필터링된 모든 대화 턴 수)/(필터링된 모든 대화의 수)

**참고**:
+ 이 지표의 데이터는 2024년 12월 2일 0:00:00(GMT)부터 사용할 수 있습니다.

## 봇 대화 완료
<a name="bot-conversations-completed-metric"></a>

이 지표는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화 수를 제공합니다. 대화 종료 시간은 지정된 종료 시간 이후일 수 있습니다.

예를 들어 시작 시간이 오전 9시이고 종료 시간이 오전 10시인 이 지표를 요청하는 경우 결과에는 간접 호출 리소스(흐름 또는 흐름 모듈)가 다음과 같은 대화가 포함됩니다.
+ 오전 9시 15분에 시작되어 오전 9시 40분에 종료됨
+ 오전 9시 50분에 시작되어 오전 10시 10분에 종료됨

그러나 간접 호출 리소스(흐름 또는 흐름 모듈)가 다음에 해당하는 대화를 제외합니다.
+ 오전 8시 50분에 시작되어 오전 9시 10분에 종료됨

**지표 유형**: 정수

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `BOT_CONVERSATIONS_COMPLETED`

  `BOT_CONVERSATION_OUTCOME_TYPE` 지표 수준 필터를 사용하여 다음 대화 결과를 기준으로 필터링할 수 있습니다.
  + 성공: 대화의 최종 의도는 *성공*으로 분류됩니다.
  + 실패: 대화의 최종 의도가 실패했습니다. Amazon Lex V2의 기본값이 인 경우에도 대화가 실패합니다`AMAZON.FallbackIntent`.
  + 중단됨: 대화가 *성공* 또는 *실패*로 분류되기 전에 고객이 응답하지 않습니다.

**계산 로직**:
+ 전체 대화 수입니다.

**참고**:
+ 이 지표의 데이터는 2024년 12월 2일 0:00:00(GMT)부터 사용할 수 있습니다.

## 봇 의도 완료됨
<a name="bot-intents-completed-metric"></a>

이 지표는 완료된 의도의 수를 제공합니다. 여기에는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화의 의도가 포함됩니다.

**지표 유형**: 정수

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `BOT_INTENTS_COMPLETED`

  `BOT_CONVERSATION_OUTCOME_TYPE` 지표 수준 필터를 사용하여 다음 대화 결과를 기준으로 필터링할 수 있습니다.

  `BOT_INTENTS_OUTCOME_TYPE` 지표 수준 필터를 사용하여 다음 의도 결과를 기준으로 필터링할 수 있습니다.
  + 성공: 봇이 의도를 성공적으로 처리했습니다. 다음 상황 중 하나가 참이어야 합니다.
    + 의도 *상태*는 *ReadyForFulfillment*이고 *dialogAction* 유형은 *Close*입니다.
    + 의도 `state`는 `Fulfilled`이고, `dialogAction`의 유형은 `Close`입니다.
  + 실패: 봇이 의도를 처리하지 못했습니다. 의도 상태. 다음 상황 중 하나가 참이어야 합니다.
    + 의도 `state`는 `Failed`이고, `dialogAction`의 `type`은 `Close`입니다(예: 사용자가 확인 프롬프트를 거부한 경우).
    + 봇은 의도가 완료되기 전에 `AMAZON.FallbackIntent`로 전환합니다.
  + 전환됨: 원래 의도가 *성공* 또는 *실패*로 분류되기 전에 봇이 다른 의도를 인식하고 대신 해당 의도로 전환합니다.
  + 중단됨: 의도가 *성공* 또는 *실패*로 분류되기 전에 고객이 응답하지 않습니다.

**계산 로직**:
+ 총 의도 수입니다.

**참고**:
+ 이 지표의 데이터는 2024년 12월 2일 0:00:00(GMT)부터 사용할 수 있습니다.

## 봇 대화 결과 비율
<a name="percent-bot-conversations-outcome-metric"></a>

이 지표는 지표 수준 필터(`BOT_CONVERSATION_OUTCOME_TYPE`)에 지정된 특정 결과 유형으로 종료된 전체 대화의 비율을 제공합니다. 여기에는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화만 포함됩니다.

**지표 유형**: 퍼센트

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `PERCENT_BOT_CONVERSATIONS_OUTCOME`

** Amazon Connect 관리자 웹 사이트를 사용하여에 액세스하는 방법**: 

**계산 로직**:
+ (BOT\$1CONVERSATION\$1OUTCOME\$1TYPE을 가진 대화 수)/(전체 대화 수) \$1 100

**참고**:
+ 이 지표의 데이터는 2024년 12월 2일 0:00:00(GMT)부터 사용할 수 있습니다.

## 봇 의도 결과 비율
<a name="percent-bot-intents-outcome-metric"></a>

이 지표는 지표 수준 필터(`BOT_INTENT_OUTCOME_TYPE`)에 지정된 특정 결과 유형으로 종료된 의도의 비율을 제공합니다. 여기에는 지정된 시작 시간과 종료 시간 사이에 간접 호출 리소스(흐름 또는 흐름 모듈)가 시작된 완료된 대화의 의도가 포함됩니다.

**지표 유형**: 퍼센트

**지표 범주**: 흐름 기반 지표

**Amazon Connect API를 사용하여 액세스하는 방법**: 
+ [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) API 지표 식별자: `PERCENT_BOT_INTENTS_OUTCOME`

** Amazon Connect 관리자 웹 사이트를 사용하여에 액세스하는 방법**: 

**계산 로직**:
+ (BOT\$1INTENT\$1OUTCOME\$1TYPE을 가진 의도 수)/(전체 의도 수) \$1 100