

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Métricas e analytics de bots do Amazon Connect
<a name="bot-metrics"></a>

As seguintes métricas orientadas por fluxo estão disponíveis na [Painel Fluxos e desempenho de bots conversacionais](flows-performance-dashboard.md) e na [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html).

## Tempo médio de conversa de bots
<a name="average-bot-conversation-time-metric"></a>

Essa métrica mede a duração média das conversas concluídas nas quais o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados. 

**Tipo de métrica**: string (*hh:mm:ss*)

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `AVG_BOT_CONVERSATION_TIME`

   Ela pode ser filtrada com base em resultados específicos de conversas com o filtro ao nível da métrica `BOT_CONVERSATION_OUTCOME_TYPE`.

**Lógica de cálculo**:
+ Soma [(Hora de início da conversa - Hora de término da conversa) de todas as conversas filtradas] / (Contagem de todas as conversas filtradas).

**Observações:**
+ Os dados dessa métrica foram disponibilizados em 2 de dezembro de 2024 à 0h GMT.

## Média de turnos de conversa do bot
<a name="average-bot-conversation-turns-metric"></a>

Essa métrica fornece o número médio de turnos de conversas concluídas nas quais o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados. 

Um turno é representado por uma solicitação da aplicação cliente e uma resposta do bot.

**Tipo de métrica**: duplo

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `AVG_BOT_CONVERSATION_TURNS`

   Ela pode ser filtrada com base em resultados específicos de conversas com o filtro ao nível da métrica `BOT_CONVERSATION_OUTCOME_TYPE`.

**Lógica de cálculo**:
+ Soma (Turnos de todas as conversas filtradas) / (Contagem de todas as conversas filtradas).

**Observações:**
+ Os dados dessa métrica foram disponibilizados em 2 de dezembro de 2024 à 0h GMT.

## Conversas de bot concluídas
<a name="bot-conversations-completed-metric"></a>

Essa métrica fornece o número médio de conversas concluídas nas quais o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados. O horário de término da conversa pode estar além do horário de término especificado. 

Por exemplo, se você solicitar essa métrica com horário de início às 9h e horário de término às 10h, o resultado incluirá conversas em que o recurso de invocação (fluxo ou módulo de fluxo):
+ começou às 9h15 e terminou às 9h40
+ começou às 9h50 e terminou às 10h10

Mas excluirá conversas para as quais o recurso de invocação (fluxo ou módulo de fluxo):
+ começou às 8h50 e terminou às 9h10

**Tipo de métrica**: valor inteiro

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `BOT_CONVERSATIONS_COMPLETED`

  Ela pode ser filtrada com base nos resultados de conversa a seguir usando o filtro ao nível da métrica `BOT_CONVERSATION_OUTCOME_TYPE`.
  + SUCCESS: a intenção final da conversa é classificada como *êxito*.
  + FAILED: a intenção final da conversa falhou. A conversa também falhará se o Amazon Lex V2 usar como padrão o. `AMAZON.FallbackIntent`
  + DROPPED: o cliente não respondeu antes que a conversa fosse classificada como *êxito* ou *falha*.

**Lógica de cálculo**:
+ Contagem total de conversas.

**Observações:**
+ Os dados dessa métrica foram disponibilizados em 2 de dezembro de 2024 à 0h GMT.

## Intenções de bot concluídas
<a name="bot-intents-completed-metric"></a>

Essa métrica fornece a contagem de intenções concluídas. Inclui intenções de conversas concluídas em que o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados.

**Tipo de métrica**: valor inteiro

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `BOT_INTENTS_COMPLETED`

  Ela pode ser filtrada com base nos resultados de conversa a seguir usando o filtro ao nível da métrica `BOT_CONVERSATION_OUTCOME_TYPE`.

  Ela pode ser filtrada com base nos resultados de intenção a seguir usando o filtro ao nível da métrica `BOT_INTENTS_OUTCOME_TYPE`.
  + SUCCESS: o bot atendeu com êxito à intenção. Um dos valores a seguir é verdadeiro:
    + *O *estado* da intenção é *ReadyForFulfillment*e o tipo de *DialogAction* é Fechar.*
    + `state` da intenção é `Fulfilled` e o tipo de `dialogAction` é `Close`.
  + FAILED: o bot não cumpriu a intenção. O estado da intenção. Um dos valores a seguir é verdadeiro:
    + A intenção `state` é `Failed` e o `type` de `dialogAction` é `Close` (por exemplo, o usuário recusou a solicitação de confirmação).
    + O bot alterna para o `AMAZON.FallbackIntent` antes que a intenção seja concluída.
  + SWITCHED: o bot reconhece uma intenção diferente e alterna para ela, antes que a intenção original seja classificada como *êxito* ou *falha*.
  + DROPPED: o cliente não respondeu antes que a intenção fosse classificada como *êxito* ou *falha*.

**Lógica de cálculo**:
+ Contagem total de intenções.

**Observações:**
+ Os dados dessa métrica foram disponibilizados em 2 de dezembro de 2024 à 0h GMT.

## Porcentagem de resultados de conversas do bot
<a name="percent-bot-conversations-outcome-metric"></a>

Essa métrica fornece a porcentagem do total de conversas que terminaram no tipo de resultado específico determinado no filtro ao nível da métrica (`BOT_CONVERSATION_OUTCOME_TYPE`). Inclui conversas concluídas em que o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados. 

**Tipo de métrica**: porcentagem

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `PERCENT_BOT_CONVERSATIONS_OUTCOME`

**Como acessar usando o site Amazon Connect administrativo**: 

**Lógica de cálculo**:
+ (Contagem de conversas com BOT\$1CONVERSATION\$1OUTCOME\$1TYPE) / (Contagem total de conversas) \$1 100

**Observações:**
+ Os dados dessa métrica foram disponibilizados em 2 de dezembro de 2024 à 0h GMT.

## Resultado percentual de intenções do bot
<a name="percent-bot-intents-outcome-metric"></a>

Essa métrica fornece a porcentagem de intenções que terminaram no tipo de resultado específico determinado no filtro ao nível da métrica (`BOT_INTENT_OUTCOME_TYPE`). Inclui intenções de conversas concluídas em que o recurso de invocação (fluxo ou módulo de fluxo) começou entre os horários de início e término especificados.

**Tipo de métrica**: porcentagem

**Categoria da métrica**: métrica baseada em fluxos

**Como acessar usando a API do Amazon Connect**: 
+ GetMetricDataIdentificador métrico da API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html): `PERCENT_BOT_INTENTS_OUTCOME`

**Como acessar usando o site Amazon Connect administrativo**: 

**Lógica de cálculo**:
+ (Contagem de intenções com BOT\$1INTENT\$1OUTCOME\$1TYPE)/(Contagem total de intenções) \$1 100