Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) em vez disso.
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á.
# Exportar e importar em formato do Amazon Lex
Para exportar bots, intenções e tipos de slot do Amazon Lex com a intenção de reimportá-los no Amazon Lex, você cria um arquivo JSON no formato do Amazon Lex. Você pode editar os recursos neste arquivo e reimportá-los no Amazon Lex. Por exemplo, você pode adicionar declarações a uma intenção e reimportar a intenção alterada para a conta. Você também pode usar o formato JSON para compartilhar um recurso. Por exemplo, você pode exportar um bot de uma região da AWS e, em seguida, importá-lo para outra região. Ou você pode enviar o arquivo JSON a um colega para compartilhar um bot.
**Topics**
+ [Exportar em formato do Amazon Lex](export-to-lex.md)
+ [Importar em formato do Amazon Lex](import-from-lex.md)
+ [Formato JSON para importação e exportação](import-export-format.md)
# Exportar em formato do Amazon Lex
Exporte seus bots, intenções e tipos de slots do Amazon Lex para um formato que você possa importar para uma AWS conta. Você pode exportar os seguintes recursos:
+ Um bot, inclusive todas as intenções e os tipos de slot personalizados usados pelo bot
+ Uma intenção, inclusive todos os tipos de slot personalizados usados pela intenção
+ Um tipo de slot personalizado, inclusive todos os valores do tipo de slot
Você só pode exportar uma versão numerada de um recurso. Você não pode exportar uma versão `$LATEST` do recurso.
A exportação é um processo assíncrono. Quando a exportação é concluída, você obtém um URL pré-assinado do Amazon S3. O URL fornece o local de um arquivo .zip que contém o recurso exportado em formato JSON.
Você usa o console ou a operação [GetExport](API_GetExport.md) para exportar bots, intenções e tipos de slot personalizados.
O processo para exportar um bot, uma intenção ou um tipo de slot é o mesmo. Nos procedimentos a seguir, substitua a intenção ou o tipo de slot do bot.
## Exportar um bot
**Para exportar um bot**
1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Escolha **Bots** e o bot a ser exportado.
1. No menu **Ações**, escolha **Export** (Exportar).
1. Na caixa de diálogo **Export Bot** (Exportar bot), escolha a versão do bot a ser exportada. Em **Plataforma**, escolha **Amazon Lex**.
1. Escolha **Exportar**.
1. Faça download e salve o arquivo .zip.
O Amazon Lex exporta o bot para um arquivo JSON contido no arquivo .zip. Para atualizar o bot, modifique o texto JSON e o reimporte para o Amazon Lex.
**Próxima etapa**
[Importar em formato do Amazon Lex](import-from-lex.md)
# Importar em formato do Amazon Lex
Depois de exportar um recurso para um arquivo JSON no formato Amazon Lex, você pode importar o arquivo JSON contendo o recurso em uma ou mais contas. AWS Por exemplo, você pode exportar um bot e, em seguida, importá-lo para outra região da AWS. Ou você pode enviar o bot para uma colega, de maneira que ela possa importá-lo para a respectiva conta.
Ao importar um bot, uma intenção ou um tipo de slot, você deve decidir se deseja substituir a versão `$LATEST` de um recurso, como uma intenção ou um tipo de slot, durante a importação, ou se deseja que a importação falhe caso queira preservar o recurso que está na conta. Por exemplo, se estivesse fazendo upload de uma versão editada de um recurso para a conta, você optaria por substituir a versão `$LATEST`. Se estiver fazendo upload de um recurso enviado por um colega, você poderá optar por fazer a importação falhar se houver conflitos de recurso. Dessa maneira, os próprios recursos não são substituídos.
Durante a importação de um recurso, as permissões atribuídas ao usuário que está fazendo a solicitação de importação se aplicam. O usuário deve ter permissões para todos os recursos na conta afetada pela importação. O usuário também deve ter permissão para as operações [GetBot](API_GetBot.md), [PutBot](API_PutBot.md), [GetIntent](API_GetIntent.md) [PutIntent](API_PutIntent.md), [GetSlotType](API_GetSlotType.md), [PutSlotType](API_PutSlotType.md). Para obter mais informações sobre permissões, consulte [Como o Amazon Lex funciona com o IAM](security_iam_service-with-iam.md).
A importação relata erros ocorridos durante o processamento. Alguns erros são relatados antes do início da importação, outros são relatados durante o processo de importação. Por exemplo, se a conta que estiver importando uma intenção não tiver permissão para chamar uma função do Lambda usada pela intenção, a importação falhará antes das alterações serem feitas nos tipos de slot ou nas intenções. Se uma importação falhar durante o processo de importação, a versão `$LATEST` de qualquer intenção ou tipo de slot importado antes do processo ter falhado será modificada. Você não pode reverter alterações feitas na versão `$LATEST`.
Quando você importa um recurso, todos os recursos dependentes são importados para a versão `$LATEST` do recurso e, em seguida, recebem uma versão numerada. Por exemplo, se um bot usar uma intenção, ela receberá uma versão numerada. Se uma intenção usar um tipo de slot personalizado, ele receberá uma versão numerada.
Um recurso é importado somente uma vez. Por exemplo, se o bot contiver uma intenção `OrderPizza` e uma intenção `OrderDrink` em que ambas dependam do tipo de slot personalizado `Size`, o tipo de slot `Size` será importado uma vez e usado em ambas as intenções.
**nota**
Se você exportou seu bot com o parâmetro `enableModelImprovements` definido como `false`, deverá abrir o arquivo .zip contendo a definição do bot e alterar o parâmetro `enableModelImprovements` para `true` nas seguintes regiões:
Ásia-Pacífico (Singapura) (ap-southeast-1)
Ásia Pacific (Tóquio) (ap-northeast-1)
Europa (Frankfurt) (eu-central-1)
Europa (Londres) (eu-west-2)
O processo para importar um bot, uma intenção ou um tipo de slot personalizado é o mesmo. Nos procedimentos a seguir, substitua a intenção ou o tipo de slot, conforme apropriado.
## Importar um bot
**Para importar um bot**
1. Faça login no AWS Management Console e abra o console do Amazon Lex em [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Escolha **Bots** e o bot a ser importado. Para importar um novo bot, ignore esta etapa.
1. Em **Ações**, escolha **Import** (Importar).
1. Em **Import Bot** (Importar bot), escolha o arquivo .zip que contém o arquivo JSON que contém o bot a ser importado. Se você quiser ver conflitos de mesclagem antes de mesclar, escolha **Notify me of merge conflicts** (Notificar-me de conflitos de mesclagem). Se você desativar a verificação de conflitos, a versão `$LATEST` de todos os recursos usados pelo bot será substituída.
1. Escolha **Importar**. Se você tiver optado por ser notificado sobre conflitos de mesclagem e houver conflitos, será exibida uma caixa de diálogo os listando. Para substituir a versão `$LATEST` de todos os recursos conflitantes, escolha **Overwrite and continue (Substituir e continuar)**. Para interromper a importação, escolha **Cancelar**.
Você já pode testar o bot na conta.
# Formato JSON para importação e exportação
Os exemplos a seguir mostram a estrutura JSON para exportar e importar tipos de slot, intenções e bots em formato do Amazon Lex.
## Estrutura do tipo de slot
Esta é a estrutura JSON para tipos de slot personalizados. Use essa estrutura ao importar ou exportar tipos de slot, além de exportar intenções que dependam de tipos de slot personalizados.
```
{
"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"
}
}
```
## Estrutura da intenção
Esta é a estrutura JSON para intenções. Use essa estrutura ao importar ou exportar intenções e bots que dependam de uma intenção.
## Estrutura do bot
Esta é a estrutura JSON para bots. Use essa estrutura ao importar ou exportar bots.