

Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le [guide Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 

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.

# Exportation et importation au format Amazon Lex
<a name="import-export-lex"></a>

Pour exporter des robots, des intentions et des types d'emplacements depuis Amazon Lex dans le but de les réimporter dans Amazon Lex, vous devez créer un fichier JSON au format Amazon Lex. Vous pouvez modifier vos ressources dans ce fichier et le réimporter dans Amazon Lex. Par exemple, vous pouvez ajouter des énoncés à une intention, puis réimporter l'intention modifiée dans votre compte. Vous pouvez également utiliser le format JSON pour partager une ressource. Par exemple, vous pouvez exporter un bot depuis une région AWS, puis l'importer dans une autre région. Sinon, vous pouvez envoyer le fichier JSON à un collègue afin de partager un bot.

**Topics**
+ [Exportation au format Amazon Lex](export-to-lex.md)
+ [Importation au format Amazon Lex](import-from-lex.md)
+ [Format &JSON pour l'importation et l'exportation](import-export-format.md)

# Exportation au format Amazon Lex
<a name="export-to-lex"></a>

Exportez vos bots, intentions et types d'emplacements Amazon Lex dans un format que vous pouvez importer dans un AWS compte. Vous pouvez exporter les ressources suivantes :
+ Un bot, y compris toutes les intentions et tous les types d'option personnalisés utilisés par celui-ci
+ Une intention, y compris tous les types d'option personnalisés utilisés par celle-ci
+ Un type d'option personnalisé, y compris toutes les valeurs du type d'option

Vous pouvez exporter uniquement une version numérotée d'une ressource. Il n'est pas possible d'exporter la version `$LATEST` de la ressource.

L'exportation est un processus asynchrone. Lorsque l'exportation est terminée, vous obtenez une URL présignée Amazon S3. L'URL indique l'emplacement d'une archive .zip qui contient la ressource exportée au format JSON. 

Vous pouvez utiliser soit la console, soit l'opération [GetExport](API_GetExport.md) pour exporter des bots, des intentions et des types d'option personnalisés. 

Le processus d'exportation est le même pour les bots, les intentions et les types d'option. Dans les procédures suivantes, remplacez le bot par l'intention ou le type d'option, selon vos besoins. 

## Exportation d'un robot
<a name="export-console"></a>

**Pour exporter un 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 **Bots**, puis sélectionnez le bot à exporter.

1. Dans le menu **Actions**, sélectionnez **Export** (Exporter).

1. Dans la boîte de dialogue **Export Bot** (Exporter le bot), choisissez la version du bot à exporter. Pour **Platform** (Plateforme), choisissez **Amazon Lex**.

1. Cliquez sur **Exporter**.

1. Téléchargez et enregistrez l'archive .zip.

Amazon Lex exporte le bot vers un fichier JSON contenu dans l'archive .zip. Pour mettre à jour le bot, modifiez le texte JSON, puis réimportez-le dans Amazon Lex.

**Étape suivante**  
[Importation au format Amazon Lex](import-from-lex.md)

# Importation au format Amazon Lex
<a name="import-from-lex"></a>

Après avoir exporté une ressource vers un fichier JSON au format Amazon Lex, vous pouvez importer le fichier JSON contenant la ressource dans un ou plusieurs AWS comptes. Par exemple, vous pouvez exporter un bot, puis l'importer dans une autre région AWS. Ou vous pouvez envoyer le bot à un collègue pour qu'il puisse l'importer dans son compte. 

Lorsque vous importez un bot, une intention ou un type d'option, vous devez décider si vous souhaitez remplacer la version `$LATEST` d'une ressource, par exemple une intention ou un type d'option, lors de l'importation, ou si vous préférez que l'importation échoue afin de conserver la ressource figurant dans votre compte. Par exemple, si vous chargez une version modifiée d'une ressource dans votre compte, vous devez choisir de remplacer la version `$LATEST`. Si vous chargez une ressource qui vous a été envoyée par un collègue, vous pouvez préférer que l'importation échoue en cas de conflit entre les ressources afin que votre propre ressource ne soit pas remplacée.

Lors de l'importation d'une ressource, les autorisations attribuées à l'utilisateur à l'origine de la demande d'importation s'appliquent. L'utilisateur doit disposer d'autorisations pour toutes les ressources du compte qui sont concernées par l'importation. L'utilisateur doit également disposer d'une autorisation pour les opérations [GetBot](API_GetBot.md), [PutBot](API_PutBot.md), [GetIntent](API_GetIntent.md) [PutIntent](API_PutIntent.md), [GetSlotType](API_GetSlotType.md) et [PutSlotType](API_PutSlotType.md). Pour en savoir plus sur les autorisations, consultez [Comment Amazon Lex fonctionne avec IAM](security_iam_service-with-iam.md).

L'importation signale les erreurs qui se produisent au cours du traitement. Certaines erreurs sont signalées avant que l'importation commence, d'autres sont signalées au cours du processus d'importation. Par exemple, si le compte qui importe une intention n'est pas autorisé à appeler une fonction Lambda utilisée par l'intention, l'importation échoue avant que des modifications ne soient apportées aux types d'emplacements ou aux intentions. Si une importation échoue pendant le processus d'importation, la version `$LATEST` de toute intention ou tout type d'option importé avant que le processus échoue est modifiée. Vous ne pouvez pas annuler les modifications apportées à la version `$LATEST`.

Lorsque vous importez une ressource, toutes les ressources dépendantes sont importées dans la version `$LATEST` de la ressource, puis une version numérotée leur est attribuée. Par exemple, si un bot utilise une intention, l'intention reçoit une version numérotée. Si une intention utilise un type d'option personnalisé, le type d'option reçoit une version numérotée.

Une ressource n'est importée qu'une seule fois. Par exemple, si le bot contient une intention `OrderPizza` et une intention `OrderDrink` qui dépendent toutes deux du type d'option personnalisé `Size`, le type d'option `Size` est importé une seule fois et utilisé pour les deux intentions.

**Note**  
Si vous avez exporté votre bot avec le `enableModelImprovements` paramètre défini sur`false`, vous devez ouvrir le fichier .zip contenant la définition du bot et remplacer le `enableModelImprovements` paramètre par `true` dans les régions suivantes :  
Asie-Pacifique (Singapour) (ap-southeast-1)
Asie-Pacifique (Tokyo) (ap-northeast-1)
EU (Francfort) (eu-central-1)
EU (Londres) (eu-west-2)

Le processus d'importation est le même pour les bots, les intentions et les types d'option personnalisés. Dans les procédures suivantes, remplacez le bot par l'intention ou le type d'option en fonction de vos besoins. 

## Importation d'un robot
<a name="import-console"></a>

**Pour importer un 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 **Bots**, puis sélectionnez le bot à importer. Pour importer un nouveau bot, ignorez cette étape.

1. Pour **Actions**, choisissez **Import** (Importer).

1. Pour **Import Bot** (Importer un bot), choisissez l'archive .zip qui contient le fichier JSON dans lequel se trouve le bot à importer. Si vous souhaitez afficher les conflits de fusion avant de lancer l'opération, choisissez l'option **Notify me of merge conflicts** (M'avertir en cas de conflit de fusion). Si vous désactivez la vérification des conflits, la version `$LATEST` de toutes les ressources utilisées par le bot est remplacée.

1. Choisissez **Importer**. Si vous avez choisi de recevoir une notification en cas de conflit de fusion et qu'il existe des conflits, une boîte de dialogue s'affiche et les répertorie. Pour remplacer la version `$LATEST` de toutes les ressources en conflit, choisissez **Overwrite and continue (Remplacer et continuer)**. Pour arrêter l'importation, choisissez **Cancel** (Annuler).

Vous pouvez désormais tester le bot dans votre compte. 

# Format &JSON pour l'importation et l'exportation
<a name="import-export-format"></a>

Les exemples suivants montrent la structure JSON pour l'exportation et l'importation de types d'emplacements, d'intentions et de bots au format Amazon Lex.

## Structure du type d'option
<a name="import-export-slot-type"></a>

La séquence suivante illustre la structure JSON pour les types d'options personnalisés. Utilisez cette structure lorsque vous importez ou exportez des types d'option, et lorsque vous exportez des intentions qui dépendent de types d'option personnalisés.

```
{
  "metadata": {
    "schemaVersion": "1.0",
    "importType": "LEX",
    "importFormat": "JSON"
  },
  "resource": {
    "name": "slot type name",
    "version": "version number",
    "enumerationValues": [
      {
        "value": "enumeration value",
        "synonyms": []
      },
      {
        "value": "enumeration value",
        "synonyms": []
      }
    ],
    "valueSelectionStrategy": "ORIGINAL_VALUE or TOP_RESOLUTION"
  }
}
```

## Structure de l'intention
<a name="import-export-intent"></a>

La séquence suivante illustre la structure JSON pour les intentions. Utilisez cette structure lorsque vous importez ou exportez des intentions et des bots qui dépendent d'une intention.

## Structure de bot
<a name="import-export-bot"></a>

La séquence suivante illustre la structure JSON pour les bots. Utilisez cette structure lorsque vous importez ou exportez des bots.