

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á.

# Criar um vocabulário personalizado usando uma lista
<a name="custom-vocabulary-create-list"></a>

**Importante**  
[Os vocabulários personalizados em formato de lista estão se tornando obsoletos. Portanto, se você estiver criando um vocabulário personalizado, é altamente recomendável usar o formato de tabela](custom-vocabulary-create-table.md).

Você pode criar vocabulários personalizados a partir de listas usando os AWS SDKs Console de gerenciamento da AWS AWS CLI, ou.
+ **Console de gerenciamento da AWS**: você deve criar e carregar um arquivo de texto contendo o vocabulário personalizado. Você pode usar entradas separadas por linha ou vírgula. Observe que sua lista deve ser salva como um arquivo de texto (\*.txt). `LF`Tanto as terminações `CRLF` de linha quanto as terminações de linha são suportadas.
+ **AWS CLI** e **SDKs da AWS **: você deve incluir o vocabulário personalizado como entradas separadas por vírgula na chamada de API usando a sinalização [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases).

Se uma entrada contiver várias palavras, você deverá hifenizar cada uma. Por exemplo, você inclui “Los Angeles” como **Los-Angeles** e “Andorra la Vella” como **Andorra-la-Vella**.

Veja alguns exemplos dos dois formatos de lista válidos. Consulte [Criar listas de vocabulário personalizado](#custom-vocabulary-create-list-examples) para obter exemplos específicos do método.
+ Comma-separated entradas:

  ```
  Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
  ```
+ Line-separated entradas:

  ```
  Los-Angeles
  CLI
  Eva-Maria
  ABCs
  Andorra-la-Vella
  ```

**Importante**  
Você só pode usar caracteres compatíveis com seu idioma. Consulte o [conjunto de caracteres](charsets.md) do seu idioma para obter detalhes.

As listas de vocabulário personalizado não aceitam a operação [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html). Se estiver criando um vocabulário médico personalizado, você deve usar um formato de tabela. Consulte [Criar um vocabulário personalizado usando uma tabela](custom-vocabulary-create-table.md) para obter instruções.

## Criar listas de vocabulário personalizado
<a name="custom-vocabulary-create-list-examples"></a>

Para processar uma lista de vocabulário personalizada para uso com Amazon Transcribe, veja os exemplos a seguir:

### AWS CLI
<a name="vocab-create-list-cli"></a>

Este exemplo usa o comando [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) com um arquivo de vocabulário personalizado formatado em lista. Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).

```
aws transcribe create-vocabulary \ 
--vocabulary-name {{my-first-vocabulary}} \ 
--language-code {{en-US}} \ 
--phrases {{{CLI,Eva-Maria,ABCs}}}
```

Veja a seguir outro exemplo usando o comando [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) e um corpo de solicitação que cria o vocabulário personalizado.

```
aws transcribe create-vocabulary \
--cli-input-json file://{{filepath}}/{{my-first-vocab-list}}.json
```

O arquivo *my-first-vocab-list.json* contém o corpo de solicitação a seguir.

```
{
  "VocabularyName": "{{my-first-vocabulary}}",
  "LanguageCode": "{{en-US}}",
  "Phrases": [
        "{{CLI}}","{{Eva-Maria}}","{{ABCs}}"
  ]
}
```

Assim que `VocabularyState` muda de `PENDING` para `READY`, seu vocabulário personalizado estará pronto para ser usado com uma transcrição. Execute o comando para visualizar o status atual do vocabulário personalizado:

```
aws transcribe get-vocabulary \
--vocabulary-name {{my-first-vocabulary}}
```

### AWS SDK para Python (Boto3)
<a name="vocab-create-list-python-batch"></a>

Este exemplo usa o AWS SDK para Python (Boto3) para criar um vocabulário personalizado a partir de uma lista usando o método [create\_vocabulary](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).

Para ver exemplos adicionais de uso dos AWS SDKs, incluindo exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo. [Exemplos de código para o Amazon Transcribe usando AWS SDKs](service_code_examples.md)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', '{{us-west-2}}')
vocab_name = "{{my-first-vocabulary}}"
response = transcribe.create_vocabulary(
    LanguageCode = '{{en-US}}',
    VocabularyName = vocab_name,
    Phrases = [
        '{{CLI}}','{{Eva-Maria}}','{{ABCs}}'
    ]
)

while True:
    status = transcribe.get_vocabulary(VocabularyName = vocab_name)
    if status['VocabularyState'] in ['READY', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

**nota**  
Se você criar um novo Amazon S3 bucket para seus arquivos de vocabulário personalizados, certifique-se de que a IAM função que faz a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)solicitação tenha permissões para acessar esse bucket. Se o perfil não tiver as permissões corretas, sua solicitação falhará. Opcionalmente, você pode especificar uma IAM função em sua solicitação incluindo o `DataAccessRoleArn` parâmetro. Para obter mais informações sobre IAM funções e políticas em Amazon Transcribe, consulte[Amazon Transcribe exemplos de políticas baseadas em identidade](security_iam_id-based-policy-examples.md).