

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.

# Importation de transcriptions de conversation
<a name="designing-import"></a>

L'importation des transcriptions de conversation se fait en trois étapes : 

1. Préparez les transcriptions pour l'importation en les convertissant au format approprié. Si vous utilisez Contact Lens pour Amazon Connect, les transcriptions sont déjà au bon format. 

1. Téléchargez les transcriptions dans un compartiment Amazon S3. Si vous utilisez Contact Lens, vos transcriptions se trouvent déjà dans un compartiment S3.

1. Analysez les transcriptions à l'aide de la console Amazon Lex V2 ou des opérations d'API. Le temps nécessaire pour terminer la formation dépend du volume de transcriptions et de la complexité de la conversation. En général, 500 lignes de transcriptions sont analysées chaque minute.

Chacune de ces étapes est décrite dans les sections suivantes.

## Importation de transcriptions depuis Contact Lens pour Amazon Connect
<a name="import-connect"></a>

Le concepteur de chatbot automatisé Amazon Lex V2 est compatible avec les fichiers de transcription des lentilles de contact. Pour utiliser les fichiers de transcription de Contact Lens, vous devez activer Contact Lens et noter l'emplacement de ses fichiers de sortie. 

**Pour exporter des transcriptions depuis Contact Lens**

1. Activez Contact Lens dans votre instance Amazon Connect. Pour obtenir des instructions, consultez la section [Activer les lentilles de contact pour Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html) dans le *guide de l'administrateur Amazon Connect*.

1. Notez l'emplacement du compartiment S3 qu'Amazon Connect utilise pour votre instance. Pour connaître l'emplacement, ouvrez la page **Stockage des données** dans la console Amazon Connect. Pour obtenir des instructions, consultez la section [Mettre à jour les paramètres de l'instance](https://docs.aws.amazon.com/connect/latest/adminguide/update-instance-settings.html) dans le *guide de l'administrateur Amazon Connect*.

Après avoir activé les lentilles de contact et noté l'emplacement de vos fichiers de transcription, consultez les instructions [Analysez vos transcriptions à l'aide de la console Amazon Lex V2](#import-import) pour importer et analyser vos transcriptions.

## Préparer les transcriptions
<a name="import-prepare"></a>

Préparez vos transcriptions en créant des fichiers de transcription. 
+ Créez un fichier de transcription par conversation répertoriant les interactions entre les parties. Chaque interaction de la conversation peut s'étendre sur plusieurs lignes. Vous pouvez fournir des versions expurgées et non expurgées de la conversation.
+ Le fichier doit être au format JSON spécifié dans[Format de transcription d'entrée](designing-input-format.md).
+ Vous devez fournir au moins 1 000 tours de conversation. Pour améliorer la découverte de vos intentions et de vos types de machines à sous, vous devez prévoir environ 10 000 tours de conversation ou plus. Le concepteur de chatbot automatisé ne traitera que les 700 000 premiers tours. 
+ Il n'y a pas de limite au nombre de fichiers de transcription que vous pouvez télécharger, pas plus qu'il n'y a de restriction de taille de fichier.

Si vous prévoyez de filtrer les transcriptions que vous importez par date, les fichiers doivent se trouver dans la structure de répertoires suivante :

```
<path or bucket root>
   --> yyyy
      --> mm
         --> dd
            --> transcript files
```

 Le fichier de transcription doit contenir la date au format « yyyy-mm-dd » quelque part dans le nom du fichier. 

**Pour exporter des transcriptions depuis d'autres applications de centre de contact**

1. Utilisez les outils de votre application de centre d'appels pour exporter les conversations. La conversation doit contenir au moins les informations spécifiées dans[Format de transcription d'entrée](designing-input-format.md).

1. Transformez les transcriptions produites par votre application de centre de contact au format décrit dans[Format de transcription d'entrée](designing-input-format.md). Vous êtes responsable de la réalisation de la transformation.

Nous fournissons trois scripts pour préparer les transcriptions. Il s'agit des options suivantes :
+ Script permettant de combiner les transcriptions de lentilles de contact avec les journaux de conversation Amazon Lex V2. Les transcriptions de lentilles de contact n'incluent pas les parties des conversations Amazon Connect qui interagissent avec les robots Amazon Lex V2. Le script nécessite l'activation des journaux de conversation pour Amazon Lex V2 et les autorisations appropriées pour interroger les CloudWatch journaux des conversations et les compartiments Contact Lens S3.
+ Un script pour transformer les analyses d'appels Amazon Transcribe au format d'entrée Amazon Lex V2.
+ Un script pour transformer les transcriptions de chat Amazon Connect au format d'entrée Amazon Lex V2.

Vous pouvez télécharger les scripts depuis ce GitHub dépôt : [ https://github.com/aws-samples/amazon-lex-bot-recommendation-integration](https://github.com/aws-samples/amazon-lex-bot-recommendation-integration).

## Téléchargez vos transcriptions dans un compartiment S3
<a name="import-upload"></a>

Si vous utilisez Contact Lens, vos fichiers de transcription sont déjà contenus dans un compartiment S3. Pour connaître l'emplacement et les noms de fichiers de vos transcriptions, consultez la section [Exemples de fichiers de sortie pour lentilles de contact](https://docs.aws.amazon.com/connect/latest/adminguide/contact-lens-example-output-files.html) dans le *guide de l'administrateur Amazon Connect*.

Si vous utilisez une autre application de centre de contact et que vous n'avez pas configuré de compartiment S3 pour vos fichiers de transcription, suivez cette procédure. Sinon, si vous possédez déjà un compartiment S3, après vous être connecté à la console Amazon S3, suivez cette procédure en commençant par l'étape 5.

**Pour charger les fichiers dans un compartiment S3**

1. Connectez-vous à la console de gestion AWS et ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Choisissez **Créer un compartiment**.

1. Donnez un nom au compartiment et choisissez une région. La région doit être la même que celle que vous utilisez pour Amazon Lex V2. Définissez les autres options selon les besoins de votre cas d'utilisation.

1. Choisissez **Créer un compartiment**.

1. Dans la liste des buckets, choisissez un bucket existant ou le bucket que vous venez de créer

1. Choisissez **Charger**.

1. Ajoutez les fichiers de transcription que vous souhaitez télécharger.

1. Choisissez **Charger**.

## Analysez vos transcriptions à l'aide de la console Amazon Lex V2
<a name="import-import"></a>

Vous ne pouvez utiliser la conception automatique de robots que dans une langue vide. Vous pouvez ajouter une nouvelle langue à un bot existant ou en créer un nouveau. 

**Pour créer une nouvelle langue dans un nouveau bot**

1. Connectez-vous à la console de gestion AWS et ouvrez la console Amazon Lex à l'adresse [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).

1. Choisissez **Create bot**

1. Choisissez **Démarrer avec Automated Chatbot Designer**. Renseignez les informations pour créer votre nouveau bot.

1. Choisissez **Next** (Suivant)

1. Dans **Ajouter une langue pour le bot**, renseignez les informations relatives à la langue.

1. Dans la section **Emplacement du fichier de transcription sur S3**, choisissez le compartiment S3 qui contient vos fichiers de transcription et le chemin local vers les fichiers si nécessaire.

1. Vous pouvez éventuellement choisir les options suivantes :
   + Une AWS KMS clé pour chiffrer les données de transcription pendant le traitement. Si vous ne sélectionnez aucune clé, une AWS KMS clé de service est utilisée.
   + Pour filtrer les transcriptions selon une plage de dates spécifique. Si vous choisissez de filtrer les transcriptions, elles doivent se trouver dans la bonne structure de dossiers. Pour de plus amples informations, veuillez consulter [Préparer les transcriptions](#import-prepare).

1. Sélectionnez **Exécuté**.

Attendez qu'Amazon Lex V2 traite la transcription. Un message d'achèvement s'affiche lorsque l'analyse est terminée.

**Comment arrêter d'analyser votre relevé de notes**

Si vous devez arrêter l'analyse des transcriptions que vous avez téléchargées, vous pouvez arrêter une `BotRecommendation` tâche en cours, qui a le `BotRecommendationStatus` statut de traitement. Vous pouvez cliquer sur le bouton **Arrêter le traitement** présent sur la bannière après avoir soumis une tâche depuis la console ou en utilisant le SDK CLI pour l'`StopBotRecommendation`API. Pour de plus amples informations, consultez [StopBotRecommendation](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StopBotRecommendation.html).

Après avoir appelé le`StopBotRecommendation`, le système interne `BotRecommendationStatus` est réglé sur `Stopping` et vous n'êtes pas débité. Pour vous assurer que le travail s'est arrêté, vous pouvez appeler l'`DescribeBotRecommendation`API et vérifier que `BotRecommendationStatus` c'est le cas`Stopped`. Cela prend généralement 3 à 4 minutes.

Le traitement ne vous est pas facturé après l'appel de l'`StopBotRecommendation`API.