

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Métriques et analytique relatives aux robots Amazon Connect
<a name="bot-metrics"></a>

Les métriques pilotées par le flux suivantes sont disponibles sur le [Tableau de bord des flux et des performances des bots conversationnels](flows-performance-dashboard.md) et le [GetMetricDataV2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html).

## Durée moyenne d’une conversation avec un bot
<a name="average-bot-conversation-time-metric"></a>

Cette métrique mesure la durée moyenne des conversations terminées pendant lesquelles la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et de fin spécifiée. 

**Type de métrique** : chaîne (*hh:mm:ss*)

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `AVG_BOT_CONVERSATION_TIME`

   Vous pouvez le filtrer en fonction de résultats de conversation spécifiques à l’aide d’un filtre `BOT_CONVERSATION_OUTCOME_TYPE` au niveau de la métrique.

**Logique de calcul** :
+ Somme (Heure de début de conversation - Heure de fin de toutes les conversations filtrées) / (Nombre total de conversations filtrées)

**Remarques** :
+ Les données de cette métrique sont disponibles depuis le 2 décembre 2024 à 00 h 00 GMT.

## Nombre moyen de tours de conversation avec un robot
<a name="average-bot-conversation-turns-metric"></a>

Cette métrique fournit le nombre moyen de tours pour les conversations terminées pendant lesquelles la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et l’heure de fin spécifiées. 

Un seul tour correspond à une demande de l’application cliente et à une réponse du robot.

**Type de métrique** : double

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `AVG_BOT_CONVERSATION_TURNS`

   Vous pouvez le filtrer en fonction de résultats de conversation spécifiques à l’aide d’un filtre `BOT_CONVERSATION_OUTCOME_TYPE` au niveau de la métrique.

**Logique de calcul** :
+ Somme (Tour de toutes les conversations filtrées) / (Nombre total de conversations filtrées)

**Remarques** :
+ Les données de cette métrique sont disponibles depuis le 2 décembre 2024 à 00 h 00 GMT.

## Conversations du bot terminées
<a name="bot-conversations-completed-metric"></a>

Cette métrique indique le nombre de conversations terminées pour lesquelles la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et de fin spécifiée. L’heure de fin de la conversation peut être ultérieure à l’heure de fin spécifiée. 

Par exemple, si vous demandez cette métrique avec l’heure de début 9 h et l’heure de fin 10 h, le résultat inclura les conversations dans lesquelles la ressource invocatrice (flux ou module de flux) :
+ a commencé à 9 h 15 et s’est terminé à 9 h 40
+ a commencé à 9 h 50 et s’est terminé à 10 h 10

mais exclura les conversations pour lesquelles la ressource invocatrice (flux ou module de flux) :
+ a commencé à 8 h 50 et s’est terminé à 9 h 10

**Type de métrique** : entier

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `BOT_CONVERSATIONS_COMPLETED`

  Vous pouvez filtrer cette valeur en fonction des résultats de conversation suivants à l’aide d’un filtre `BOT_CONVERSATION_OUTCOME_TYPE` au niveau de la métrique.
  + SUCCÈS : l’intention finale de la conversation est considérée comme un *succès*.
  + ÉCHEC : l’intention finale de la conversation a échoué. La conversation échoue également si Amazon Lex V2 utilise par défaut `AMAZON.FallbackIntent`.
  + ABANDONNÉ : le client ne répond pas avant que la conversation ne soit considérée comme un *succès* ou un *échec*.

**Logique de calcul** :
+ Nombre total de conversations.

**Remarques** :
+ Les données de cette métrique sont disponibles depuis le 2 décembre 2024 à 00 h 00 GMT.

## Les intentions du bot sont terminées
<a name="bot-intents-completed-metric"></a>

Cette métrique indique le nombre d’intentions terminées. Elle inclut les intentions relatives aux conversations terminées où la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et de fin spécifiée.

**Type de métrique** : entier

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `BOT_INTENTS_COMPLETED`

  Vous pouvez filtrer cette valeur en fonction des résultats de conversation suivants à l’aide d’un filtre `BOT_CONVERSATION_OUTCOME_TYPE` au niveau de la métrique.

  Le filtrage peut avoir lieu en fonction des résultats de l’intention suivante à l’aide d’un filtre `BOT_INTENTS_OUTCOME_TYPE` au niveau de la métrique.
  + SUCCÈS : le bot a bien exécuté l’intention. L’une des situations suivantes est vraie :
    + *L'*état* d'intention est *ReadyForFulfillment*et le type de *DialogAction* est Close.*
    + L’intention `state` est `Fulfilled` et le type de `dialogAction` est `Close`.
  + ÉCHEC : le robot n’a pas exécuté l’intention. État de l’intention. L’une des situations suivantes est vraie :
    + L’intention `state` est `Failed` et le `type` de `dialogAction` est toujours `Close` (par exemple, l’utilisateur a refusé l’invite de confirmation).
    + Le robot passe en mode `AMAZON.FallbackIntent` avant que l’intention ne soit satisfaite.
  + ÉCHANGÉ : le robot reconnaît une intention différente et passe à cette intention à la place, avant que l’intention initiale ne soit considérée comme un *succès* ou un *échec*.
  + ABANDONNÉ : le client ne répond pas avant que l’intention ne soit considérée comme un *succès* ou un *échec*.

**Logique de calcul** :
+ Nombre total d’intentions.

**Remarques** :
+ Les données de cette métrique sont disponibles depuis le 2 décembre 2024 à 00 h 00 GMT.

## Pourcentage de conversations du robot générées
<a name="percent-bot-conversations-outcome-metric"></a>

Cette métrique fournit le pourcentage du total des conversations qui se sont terminées par le type de résultat spécifique spécifié dans le filtre au niveau de la métrique (`BOT_CONVERSATION_OUTCOME_TYPE`). Elle inclut uniquement les conversations terminées pour lesquelles la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et de fin spécifiée. 

**Type de métrique** : pourcentage

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `PERCENT_BOT_CONVERSATIONS_OUTCOME`

**Comment y accéder via le site Web de l' Amazon Connect administrateur** : 

**Logique de calcul** :
+ (Nombre de conversations avec BOT\$1CONVERSATION\$1OUTCOME\$1TYPE) / (Nombre total de conversations) \$1 100

**Remarques** :
+ Les données de cette métrique sont disponibles depuis le 2 décembre 2024 à 00 h 00 GMT.

## Pourcentage d’intentions du robot satisfaites
<a name="percent-bot-intents-outcome-metric"></a>

Cette métrique fournit le pourcentage d’intentions qui ont abouti au type de résultat spécifique spécifié dans le filtre au niveau de la métrique (`BOT_INTENT_OUTCOME_TYPE`). Elle inclut les intentions dans les conversations terminées où la ressource invocatrice (flux ou module de flux) a débuté entre l’heure de début et de fin spécifiée.

**Type de métrique** : pourcentage

**Catégorie de métrique** : métrique basée sur les flux

**Accès à l’aide de l’API Amazon Connect** : 
+ GetMetricDataIdentifiant métrique de l'API [V2](https://docs.aws.amazon.com/connect/latest/APIReference/API_GetMetricDataV2.html) : `PERCENT_BOT_INTENTS_OUTCOME`

**Comment y accéder via le site Web de l' Amazon Connect administrateur** : 

**Logique de calcul** :
+ (Nombre d’intentions avec BOT\$1INTENT\$1OUTCOME\$1TYPE) / (Nombre total d’intentions) \$1 100