Solução de problemas de tradução

As seções a seguir listam as etapas que os usuários podem seguir para resolver problemas de erros da Vertex AI Translation.

AITR2030 - TranslationServiceInvalidArgument

Os argumentos da solicitação do serviço de tradução são inválidos. Este é um código de erro padrão para um argumento inválido na solicitação. Confira os detalhes e registros de erros para mais informações.

AITR2031: TextTranslationInvalidArgument

Os argumentos da solicitação de tradução de texto são inválidos.

Exemplos de mensagens de erro:

  • Conteúdo vazio na solicitação de tradução.

    • O campo contents na sua solicitação de tradução está vazio.
    • Adicione o texto da frase no campo contents da solicitação.
  • O parâmetro mime_type é inválido.

    • O campo mime_type na sua solicitação de tradução é inválido.
    • Os valores aceitos são text/plain e text/html.
    • Se o campo mime_type estiver vazio, text/html será o valor padrão.
  • Par de idiomas não disponível.

    • O par de idiomas de origem e de destino não é compatível com o serviço de tradução.
    • O idioma de destino precisa ser o inglês. Confira os idiomas disponíveis para uma lista de idiomas de origem.
    • O método getSupportedLanguages retorna todos os idiomas disponíveis.
  • Idioma vazio.

    • O código do idioma de origem ou de destino na solicitação está vazio.
    • Verifique se o campo de código do idioma de origem ou de destino na sua solicitação de tradução não está vazio. Confira os idiomas compatíveis para ver uma lista de idiomas de origem e códigos.
  • Idioma desconhecido.

    • O código de idioma de origem ou de destino na solicitação não é um código BCP-47 e é inválido.
    • Verifique o campo de código de idioma de origem ou de destino na sua solicitação de tradução e confira se ele usa um código de idioma BCP-47.

AITR2033: GlossaryInvalidArgument

Os argumentos da solicitação de glossário são inválidos.

Exemplos de mensagens de erro:

  • O nome do glossário é inválido.

    • O nome do glossário ou o URL GET HTTP não está no formato correto. Por exemplo, o formato correto é projects/PROJECT_ID/glossaries/GLOSSARY_ID.
    • Se você estiver usando gRPC, verifique o formato do campo de glossário na solicitação.
    • Se você estiver usando GET HTTP, verifique se o URL segue este formato: /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID.
  • Nome do projeto inválido.

    • O nome do projeto não está no formato correto. Um exemplo de formato incorreto é projects/PROJECT_ID. Para um URL HTTP, um formato incorreto pode ser projects/PROJECT_ID/glossaries.
    • Se você estiver usando gRPC, verifique o valor no campo principal da solicitação para garantir que o formato esteja correto.
    • Se você estiver usando o HTTP, verifique se o URL está correto. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries.
  • Filtro inválido.

    • O filtro da lista de glossários é inválido. O filtro de lista de glossários só é compatível com a filtragem por idiomas de origem e de destino. Por exemplo, src=frou src=fre tgt=en.
    • Se você estiver usando gRPC, verifique o campo de filtro na solicitação e confira se ele está correto.
    • Se você estiver usando o GET HTTP, verifique se o URL está correto. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries?filter=XXXX.
  • Token de página inválido.

    • O token da página da lista de glossários é inválido. O valor do campo page_token precisa ser igual ao valor do campo next_page_token retornado da resposta anterior de glossários list. O token pode mudar ou ter alguns caracteres faltando.
    • Se você estiver usando gRPC, verifique se o valor do campo page_token é o mesmo do campo next_page_token retornado da resposta da lista anterior.
    • Se você estiver usando HTTP, verifique se o valor do campo page_token está correto no URL. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX.
  • Linha de dados incorreta no arquivo CSV.

    • Há pelo menos uma linha no arquivo de entrada do glossário com dados incorretos.
    • Verifique o arquivo de entrada do glossário e confira se os dados usam um formato válido.
  • Colunas duplicadas para o código do idioma, {language code, column info}.

    • Há pelo menos duas colunas compartilhando o mesmo código de idioma.
    • Confira os detalhes do erro e identifique as colunas problemáticas.
  • Não há idiomas válidos suficientes no arquivo CSV.

    • Precisa ter termos em pelo menos dois idiomas diferentes.
    • O arquivo de entrada do glossário precisa ter pelo menos dois idiomas diferentes.

AITR2034 - JobInvalidArgument

Exemplos de mensagens de erro:

  • Nome de operação inválido.

    • Verifique o nome da operação.
    • Ele precisa estar no formato projects/PROJECT/operations/OPERATION_ID.
  • Nome do projeto inválido.

    • O nome do projeto precisa seguir este formato: projects/PROJECT_ID.
    • O URL HTTP precisa seguir o formato projects/YOUR_PROJECT_ID/glossaries.
    • Se você estiver usando gRPC, verifique o campo "parent" na solicitação para garantir que ele siga o formato correto.
    • Se você estiver usando HTTP, verifique se o URL segue este formato: /v1alpha1/projects/PROJECT_ID/glossaries.
  • Token de página inválido.

    • Verifique se o valor do campo list_token é numérico na chamada do método ListOperationRequest.
    • Se você estiver usando gRPC, verifique se o valor do campo page_token é igual ao valor do campo next_page_token da resposta da lista anterior.
    • Se você estiver usando HTTP, verifique se o valor do campo page_token está correto no URL. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX.

AITR2035: DetectLanguageInvalidArgument

Os argumentos da solicitação de detecção de idioma são inválidos.

Exemplos de mensagens de erro:

  • O parâmetro mime_type é inválido.

    • O parâmetro mime_type na solicitação detectLanguage é inválido.
    • Use o valor text/plain ou text/html. O valor text/html é o padrão.
  • O campo content na chamada do método detectLanguage está vazio.

    • Verifique se o campo content na solicitação não está vazio.

AITR2053: GlossaryNotFound

O servidor não foi encontrado ao processar a solicitação de glossário.

Exemplo de mensagem de erro:

  • O glossário {project_id: PROJECT_ID, glossary_id: GLOSSARY_ID} não existe.
    • Glossário: {project_id: PROJECT_ID, GLOSSARY_ID} não existe.
    • O glossário com o glossary_id no projeto especificado não existe. O glossário precisa ser criado antes de ser consultado.
    • Verifique se o glossário foi criado antes de consultá-lo.
    • Se você estiver usando gRPC, verifique se o campo de glossário na solicitação está correto.
    • Se você estiver usando o GET HTTP, verifique se o URL está correto. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID.

AITR2054: JobNotFound

Exemplo de mensagem de erro:

  • Nenhum job encontrado para o ID.
    • Não foi possível encontrar uma operação async específica.
    • A operação async não existe no banco de dados:
      • Verifique o ID da operação na solicitação.
      • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2060: TranslationServiceAlreadyExists

Alguma entidade já existe.

  • Tente fazer a solicitação novamente.
  • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2063: GlossaryAlreadyExists

O glossário já existe.

Exemplos de mensagens de erro:

  • Já existe uma entrada de glossário com o mesmo texto de origem e destino.

    • Ao traduzir usando um glossário, algumas entradas compartilham o mesmo texto de origem e de destino.
    • Verifique se o glossário no Database Service não tem entradas duplicadas com o mesmo texto de origem e destino.
  • Já existe um glossário com esse nome.

    • Já existe outro glossário com o mesmo nome.
    • Use um nome diferente para o novo glossário.

AITR2090 - TranslationServiceFailedPrecondition

O serviço de tradução não está no estado necessário para a operação.

Exemplo de mensagem de erro:

  • Nenhum arquivo corresponde ao criar um contexto de alinhador.
    • O serviço de alinhamento é um dos serviços executados pela Tradução. O serviço de alinhamento não foi executado porque os arquivos do modelo estavam ausentes.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2093: GlossaryFailedPrecondition

O serviço de tradução está tentando usar um glossário, mas ele não está no estado necessário para que a operação funcione.

Exemplo de mensagem de erro:

  • Encontrou uma entrada de glossário muito grande.
    • O arquivo de entrada do glossário contém entradas com um tamanho (bytes) que excede o número máximo de bytes (max_bytes) permitido.
    • Atualize o glossário para que ele não exceda max_bytes.

AITR2130: TranslationServiceInternal

Exemplo de mensagem de erro:

  • Falha ao iniciar a transação do banco de dados.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível encerrar a transação do banco de dados.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível reverter a transação do banco de dados não confirmada.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível traduzir o texto.

    • O tamanho máximo de entrada de 1.024 caracteres foi excedido.
    • Siga as recomendações em Considerações.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2133: GlossaryInternal

Exemplos de mensagens de erro:

  • Falha ao receber os glossários.

    • Não é possível recuperar o glossário do banco de dados devido a problemas de conexão.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível descompactar os metadados de exclusão do glossário.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível descompactar os metadados de criação do glossário.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível descompactar a especificação de criação do glossário.

    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível criar transações de banco de dados para o serviço de tradução.

    • Não foi possível criar o banco de dados para armazenar o glossário.
    • Verifique o status do serviço de banco de dados e reinicie o servidor de tradução.
  • Falha ao criar tabelas para o serviço de tradução.

    • Não foi possível criar as tabelas de tradução para armazenar as entradas do glossário.
    • Verifique o status do serviço de banco de dados e reinicie o servidor de tradução.
  • A tabela de glossário não existe.

    • As tabelas obrigatórias do glossário de tradução não existem.
    • Reiniciar o servidor vai tentar criar a tabela novamente.
  • O certificado do servidor S3 não pode ficar em branco.

    • As informações necessárias para se conectar ao StorageGrid não foram preenchidas corretamente no servidor de tradução.
    • Verifique o status do StorageGrid e reinicie o servidor de tradução.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • O ID de acesso ao S3 não pode ficar em branco.

    • As informações necessárias para se conectar ao StorageGrid não foram preenchidas corretamente no servidor de tradução.
    • Verifique o status do StorageGrid e reinicie o servidor de tradução.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • O campo "Segredo de acesso ao S3" não pode ficar em branco.

    • As informações necessárias para se conectar ao StorageGrid não foram preenchidas corretamente no servidor de tradução.
    • Verifique o status do StorageGrid e reinicie o servidor de tradução.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2134 - JobInternal

Exemplos de mensagens de erro:

  • Não é possível atualizar jobs concluídos.

  • Falha ao definir o status de processamento de um job.

    • As operações de leitura ou gravação falharam nos registros de jobs porque a transação do banco de dados falhou.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não é possível atualizar jobs concluídos.

  • Não foi possível consultar ou executar as operações async.

    • Não é possível consultar ou atualizar as operações async por um dos seguintes motivos:
      • Problemas de conexão com o banco de dados.
      • Os dados são inválidos e não puderam ser analisados para uma resposta.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Falha ao ler jobs.

    • As operações de leitura ou gravação nos registros de jobs falharam devido a uma falha na transação do banco de dados.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Não foi possível excluir um job do banco de dados.

    • As operações de leitura ou gravação nos registros de jobs falharam devido a uma falha na transação do banco de dados.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.
  • Retorna mais de um job com o mesmo job_id.

    • Verifique se cada job_id aparece apenas uma vez no banco de dados.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2135: DetectLanguageInternal

Exemplo de mensagem de erro:

  • O resultado da detecção de idioma está faltando.
    • O detector de idioma não consegue identificar o idioma do conteúdo de entrada.
    • Verifique o conteúdo da solicitação. Confirme se os caracteres são válidos e se nenhuma das palavras está em idiomas mistos.
    • Tente fazer a solicitação novamente.
    • Entre em contato com seu especialista de suporte para receber mais ajuda.

AITR2140: TranslationServiceUnavailable

O serviço de tradução está indisponível.