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 tabela Usar um formato de tabela é a forma preferencial de criar um vocabulário personalizado. As tabelas de vocabulário devem consistir em quatro colunas (Phrase, SoundsLike, IPA, and DisplayAs), que podem ser incluídas em qualquer ordem: | Phrase | SoundsLike | IPA | DisplayAs | | --- | --- | --- | --- | | Obrigatório. Cada linha na tabela deve conter uma entrada nessa coluna.
Não use espaços nessa coluna.
Se a entrada tiver várias palavras, separe cada uma com um hífen (-). Por exemplo, **Andorra-la-Vella** ou **Los-Angeles**.
Para acrônimos, todas as letras pronunciadas devem ser separadas por um ponto. O ponto final também precisa ser pronunciado. Se o acrônimo estiver no plural, você deverá usar um hífen entre ele e o “s”. Por exemplo, “CLI” é **C.L.I.** (não **C.L.I**) e “ABCs” é **A.B.C.-s** (não **A.B.C-s**).
Se a frase consistir em uma palavra e um acrônimo, esses dois componentes devem ser separados por um hífen. Por exemplo, “DynamoDB” é **Dynamo-D.B.**.
Não inclua dígitos nessa coluna; os números devem ser escritos por extenso. Por exemplo, “VX02Q” é **V.X.-zero-two-Q.**. | `SoundsLike` não é mais compatível com vocabulário personalizado. Deixe a coluna em branco. Quaisquer valores nesta coluna serão ignorados. Removeremos o suporte para esta coluna no futuro. | `IPA` não é mais compatível com vocabulário personalizado. Deixe a coluna em branco. Quaisquer valores nesta coluna serão ignorados. Removeremos o suporte para esta coluna no futuro. | Opcional. As linhas nessa coluna podem ser deixadas vazias.
Não é possível usar espaços nessa coluna.
Define como você deseja que a entrada apareça na saída da transcrição. Por exemplo, **Andorra-la-Vella** na coluna `Phrase` está como **Andorra la Vella** na coluna `DisplayAs`.
Se uma linha nessa coluna estiver vazia, Amazon Transcribe usa o conteúdo da `Phrase` coluna para determinar a saída.
Você pode incluir dígitos (`0-9`) nessa coluna. | Fatores a observar ao criar a tabela: + Sua tabela deve conter todos os quatro cabeçalhos de coluna (Phrase, SoundsLike, IPA, and DisplayAs). A coluna `Phrase` deve conter uma entrada em cada linha. A capacidade de fornecer informações de pronúncia por meio de `IPA` e `SoundsLike` não é mais compatível e você pode deixar a coluna vazia. Quaisquer valores nessas colunas serão ignorados. + Cada coluna deve ser delineada com TAB ou vírgula (,); isso se aplica a todas as linhas do arquivo de vocabulário personalizado. Se uma linha tiver colunas vazias, você também deverá incluir um delineador (TAB ou vírgula) para cada coluna. + Os espaços só são permitidos nas colunas `IPA` e `DisplayAs`. Não use espaços para separar colunas. + `IPA` e `SoundsLike` não são mais compatíveis com vocabulário personalizado. Deixe a coluna em branco. Quaisquer valores nessa coluna serão ignorados. Removeremos o suporte para esta coluna no futuro. + A coluna `DisplayAs` aceita símbolos e caracteres especiais (por exemplo, C\+\+). Todas as outras colunas permitem os caracteres listados na página de [conjunto de caracteres](charsets.md) do seu idioma. + A `Phrase` coluna tem as seguintes regras de formatação: + Não é possível começar com um ponto (`.`), apóstrofo (`'`) ou hífen (). `-` Por exemplo, **-hello** e **.test** são inválidos. + Não pode terminar com um apóstrofo (`'`) ou hífen (). `-` Por exemplo, **hello-** e **world'** são inválidos. + Não pode conter hífens repetidos (`--`), pontos repetidos (`..`) ou apóstrofos repetidos (). `''` Por exemplo, **well--known** e **can''t** são inválidos. + Os pontos só podem ser usados para denotar acrônimos (letras únicas separadas por pontos, como). **A.B.C.** Um ponto não pode aparecer após dois ou mais caracteres não especiais consecutivos (por exemplo, **AB.C** é inválido) e não pode ser seguido por três ou mais caracteres não especiais consecutivos (por exemplo, **A.BCD** é inválido). + Somente caracteres listados no [conjunto de caracteres](charsets.md) do seu idioma são suportados. + Se quiser incluir números na coluna `Phrase`, você deve soletrá-los. Só é possível usar dígitos (`0-9`) na coluna `DisplayAs`. + Você deve salvar sua tabela como um arquivo de texto simples (\*.txt). `LF`Tanto as terminações `CRLF` de linha quanto as terminações de linha são suportadas. + Você deve carregar seu arquivo de vocabulário personalizado em um Amazon S3 bucket e processá-lo [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)antes de incluí-lo em uma solicitação de transcrição. Consulte [Criar tabelas de vocabulário personalizado](#custom-vocabulary-create-table-examples) para ver as instruções. **nota** Insira acrônimos ou outras palavras cujas letras devem ser pronunciadas individualmente como letras únicas separadas por pontos (**A.B.C.**). Para especificar a forma plural de um acrônimo, como “ABCs”, separe o “s” do acrônimo com um hífen (**A.B.C.-s**). É possível usar letras maiúsculas ou minúsculas para definir um acrônimo. Nem todos os idiomas aceitam acrônimos. Consulte [Idiomas oferecidos e recursos específicos do idioma](supported-languages.md). Veja um exemplo de tabela de vocabulário personalizado (em que **[TAB]** representa um caractere de tabulação): ``` Phrase[TAB]SoundsLike[TAB]IPA[TAB]DisplayAs Los-Angeles[TAB][TAB][TAB]Los Angeles Eva-Maria[TAB][TAB][TAB] A.B.C.-s[TAB][TAB][TAB]ABCs Amazon-dot-com[TAB][TAB][TAB]Amazon.com C.L.I.[TAB][TAB][TAB]CLI Andorra-la-Vella[TAB][TAB][TAB]Andorra la Vella Dynamo-D.B.[TAB][TAB][TAB]DynamoDB V.X.-zero-two[TAB][TAB][TAB]VX02 V.X.-zero-two-Q.[TAB][TAB][TAB]VX02Q ``` Para maior clareza visual, apresentamos a mesma tabela com colunas alinhadas. **Não** adicione espaços entre as colunas na tabela de vocabulário personalizado; a tabela deve ficar desalinhada, como no exemplo anterior. ``` Phrase [TAB]SoundsLike [TAB]IPA [TAB]DisplayAs Los-Angeles [TAB] [TAB] [TAB]Los Angeles Eva-Maria [TAB] [TAB] [TAB] A.B.C.-s [TAB] [TAB] [TAB]ABCs amazon-dot-com [TAB] [TAB] [TAB]amazon.com C.L.I. [TAB] [TAB] [TAB]CLI Andorra-la-Vella[TAB] [TAB] [TAB]Andorra la Vella Dynamo-D.B. [TAB] [TAB] [TAB]DynamoDB V.X.-zero-two [TAB] [TAB] [TAB]VX02 V.X.-zero-two-Q.[TAB] [TAB] [TAB]VX02Q ``` ## Criar tabelas de vocabulário personalizado Para processar uma tabela de vocabulário personalizada para uso com Amazon Transcribe, veja os exemplos a seguir: ### Console de gerenciamento da AWS 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, selecione **Vocabulário personalizado**. Isso abre a página **Vocabulário personalizado**, na qual você pode visualizar os vocabulários existentes ou criar um. 1. Selecione **Criar vocabulário**. ![Amazon Transcribe captura de tela do console: a página de 'vocabulário personalizado'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console.png) Isso abre a página **Criar vocabulário**. Insira um nome para o novo vocabulário personalizado. Aqui, você tem três opções: 1. Carregue um arquivo txt ou csv de seu computador. Você pode criar o vocabulário personalizado do zero ou baixar um modelo para ajudar você a começar. O vocabulário é preenchido automaticamente no painel **Visualize e edite o vocabulário**. ![Amazon Transcribe captura de tela do console: a página 'criar e importar vocabulário'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-upload.png) 1. Importe um arquivo txt ou csv de um Amazon S3 local. Você pode criar o vocabulário personalizado do zero ou baixar um modelo para ajudar você a começar. Carregue o arquivo do vocabulário finalizado em um bucket do Amazon S3 e especifique o URI dele em sua solicitação. O vocabulário é preenchido automaticamente no painel **Visualize e edite o vocabulário**. ![Amazon Transcribe captura de tela do console: a página 'criar e importar vocabulário'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-s3.png) 1. Crie manualmente o vocabulário no console. Role até o painel **Visualize e edite o vocabulário** e selecione **Adicionar 10 linhas**. Agora você pode inserir termos manualmente. ![Amazon Transcribe captura de tela do console: a página 'criar e importar vocabulário'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-manual.png) 1. É possível editar o vocabulário no painel **Visualize e edite o vocabulário**. Para fazer alterações, clique na entrada que deseja modificar. ![Amazon Transcribe captura de tela do console: o painel 'criar e editar vocabulário'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-edit2.png) Se cometer um erro, você receberá uma mensagem de erro detalhada para poder corrigir qualquer problema antes de processar o vocabulário. Observe que, se você não corrigir todos os erros antes de selecionar **Criar vocabulário**, a solicitação de vocabulário falhará. ![Amazon Transcribe captura de tela do console: o painel 'criar e editar vocabulário'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-edit3.png) Selecione a marca de seleção (✓) para salvar as alterações ou o “X” para descartá-las. 1. Se preferir, adicione tags ao vocabulário personalizado. Depois que você preencher todos os campos e estiver contente com o vocabulário, selecione **Criar vocabulário** na parte inferior da página. Isso leva você de volta à página **Vocabulário personalizado**, onde é possível ver o status do vocabulário personalizado. Quando o status muda de “Pendente” para “Pronto”, o vocabulário personalizado pode ser usado com uma transcrição. ![Amazon Transcribe captura de tela do console: vocabulário personalizado em status pendente durante o processamento.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-pending.png) 1. Se o status mudar para “Falhou”, selecione o nome do vocabulário personalizado para acessar a página de informações. ![Amazon Transcribe captura de tela do console: página de 'vocabulário personalizado' mostrando um vocabulário como completo e outro como falhado.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-failed.png) Há um banner **Motivo da falha** na parte superior dessa página que fornece informações sobre o motivo da falha do vocabulário personalizado. Corrija o erro no arquivo de texto e tente novamente. ![Amazon Transcribe captura de tela do console: a página de informações do vocabulário mostra o motivo da falha.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-create-console-failed2.png) ### AWS CLI 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 em formato de tabela. 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 usar um vocabulário personalizado existente em um trabalho de transcrição, defina o `VocabularyName` no [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)campo ao chamar a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)operação ou, a partir do Console de gerenciamento da AWS, escolha o vocabulário personalizado na lista suspensa. ``` aws transcribe create-vocabulary \ --vocabulary-name {{my-first-vocabulary}} \ --vocabulary-file-uri s3://{{amzn-s3-demo-bucket}}/{{my-vocabularies}}/{{my-vocabulary-file}}.txt \ --language-code {{en-US}} ``` 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-table}}.json ``` O arquivo *my-first-vocab-table.json* contém o corpo de solicitação a seguir. ``` { "VocabularyName": "{{my-first-vocabulary}}", "VocabularyFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-vocabularies}}/{{my-vocabulary-table}}.txt", "LanguageCode": "{{en-US}}" } ``` 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) Este exemplo usa o AWS SDK para Python (Boto3) para criar um vocabulário personalizado a partir de uma tabela 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 usar um vocabulário personalizado existente em um trabalho de transcrição, defina o `VocabularyName` no [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)campo ao chamar a [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)operação ou, a partir do Console de gerenciamento da AWS, escolha o vocabulário personalizado na lista suspensa. 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, VocabularyFileUri = 's3://{{amzn-s3-demo-bucket}}/{{my-vocabularies}}/{{my-vocabulary-table}}.txt' ) 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).