Resolução de problemas de tradução

As secções seguintes indicam os passos que os utilizadores podem seguir para resolver problemas de erros do Vertex AI Translation.

AITR2030 - TranslationServiceInvalidArgument

Os argumentos do pedido do serviço de tradução são inválidos. Este é um código de erro predefinido para um argumento inválido no pedido. Consulte os detalhes e os registos de erros para mais informações.

AITR2031 - TextTranslationInvalidArgument

Os argumentos do pedido de tradução de texto são inválidos.

Exemplos de mensagens de erro:

  • Conteúdo vazio no pedido de tradução.

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

    • O campo mime_type no seu pedido de tradução é inválido.
    • Os valores suportados são text/plain e text/html.
    • Se o campo mime_type estiver vazio, text/html é o valor predefinido.
  • Par de idiomas não suportado.

    • O par de idiomas de origem e de destino não é suportado pelo serviço de tradução.
    • O idioma de destino tem de ser o inglês. Consulte os idiomas suportados para ver uma lista de idiomas de origem.
    • O método getSupportedLanguages devolve todos os idiomas suportados.
  • Idioma vazio.

    • O código do idioma de origem ou de destino no pedido está vazio.
    • Verifique o campo de código do idioma de origem ou de destino no seu pedido de tradução e certifique-se de que não está vazio. Consulte os idiomas suportados para ver uma lista de idiomas de origem e códigos.
  • Idioma desconhecido.

    • O código de idioma de origem ou de destino no pedido não é um código de idioma BCP-47 e é inválido.
    • Verifique o campo do código de idioma de origem ou de destino no seu pedido de tradução e certifique-se de que usa um código de idioma BCP-47.

AITR2033 - GlossaryInvalidArgument

Os argumentos do pedido de glossário são inválidos.

Exemplos de mensagens de erro:

  • 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 estiver a usar gRPC, verifique o formato do campo de glossário no pedido.
    • Se estiver a usar o GET HTTP, certifique-se de que 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 um formato incorreto é projects/PROJECT_ID. Para um URL HTTP, um formato incorreto pode ser projects/PROJECT_ID/glossaries.
    • Se estiver a usar gRPC, verifique o valor no campo principal do pedido para garantir que o formato está correto.
    • Se estiver a usar o HTTP, certifique-se de que 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 da lista de glossários só suporta a filtragem por idiomas de origem e de destino. Por exemplo, src=frou src=fre tgt=en.
    • Se estiver a usar gRPC, verifique o campo de filtro no pedido e certifique-se de que está correto.
    • Se estiver a usar o GET HTTP, certifique-se de que tem o URL correto. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries?filter=XXXX.
  • Símbolo de página inválido.

    • O token da página da lista de glossários é inválido. O valor do campo page_token deve ser igual ao valor do campo next_page_token devolvido pela resposta dos glossários list anterior. O token pode mudar ou ter alguns carateres em falta.
    • Se estiver a usar gRPC, verifique se o valor do campo page_token é igual ao valor do campo next_page_token devolvido pela resposta da lista anterior.
    • Se estiver a usar 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 ficheiro CSV.

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

    • Existem, pelo menos, duas colunas que partilham o mesmo código de idioma.
    • Verifique os detalhes do erro e identifique as colunas problemáticas.
  • Não existem idiomas válidos suficientes no ficheiro CSV.

    • Tem de ter termos para, pelo menos, dois idiomas diferentes.
    • O ficheiro de entrada do glossário tem de ter, pelo menos, dois idiomas diferentes.

AITR2034 - JobInvalidArgument

Exemplos de mensagens de erro:

  • Nome da operação inválido.

    • Verifique o nome da operação.
    • Espera-se que esteja no formato projects/PROJECT/operations/OPERATION_ID.
  • Nome do projeto inválido.

    • O nome do projeto tem de seguir este formato: projects/PROJECT_ID.
    • O URL HTTP tem de seguir o formato projects/YOUR_PROJECT_ID/glossaries.
    • Se estiver a usar gRPC, verifique o campo principal no pedido para garantir que segue o formato correto.
    • Se estiver a usar o HTTP, certifique-se de que o URL segue este formato: /v1alpha1/projects/PROJECT_ID/glossaries.
  • Símbolo de página inválido.

    • Certifique-se de que o valor do campo list_token é numérico na chamada do método ListOperationRequest.
    • Se estiver a usar gRPC, verifique se o valor do campo page_token é igual ao valor do campo next_page_token da resposta da lista anterior.
    • Se estiver a usar 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 do pedido de deteção de idioma são inválidos.

Exemplos de mensagens de erro:

  • O parâmetro mime_type é inválido.

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

    • Certifique-se de que o campo content no pedido não está vazio.

AITR2053 - GlossaryNotFound

Não foi possível encontrar o servidor ao processar o pedido 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 ID glossary_id no projeto indicado não existe. O glossário tem de ser criado antes de ser consultado.
    • Verifique se o glossário foi criado antes de o consultar.
    • Se estiver a usar gRPC, verifique o campo de glossário no pedido para se certificar de que está correto.
    • Se estiver a usar o GET HTTP, certifique-se de que tem o URL correto. Por exemplo, o formato correto é /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID.

AITR2054 - JobNotFound

Exemplo de mensagem de erro:

  • Não foi encontrado nenhum trabalho para o ID.
    • Não foi possível encontrar uma operação async específica.
    • A operação async não existe na base de dados:
      • Verifique o ID da operação no pedido.
      • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2060 - TranslationServiceAlreadyExists

Já existe alguma entidade.

  • Volte a tentar o pedido.
  • Contacte o seu especialista de apoio técnico para receber assistência adicional.

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 de destino.

    • Quando traduz com um glossário, algumas entradas no glossário partilham o mesmo texto de origem e de destino.
    • Certifique-se de que o glossário no serviço de base de dados não tem entradas duplicadas com o mesmo texto de origem e de destino.
  • Já existe um glossário com este 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:

  • Não existem ficheiros correspondentes quando cria um contexto de alinhamento.
    • O serviço de alinhamento é um dos serviços que a Tradução executa. O serviço de alinhamento não foi executado porque faltavam os ficheiros do modelo.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2093 - GlossaryFailedPrecondition

O serviço de tradução está a tentar usar um glossário, mas não se encontra no estado necessário para que a operação funcione com êxito.

Exemplo de mensagem de erro:

  • Foi encontrada uma entrada do glossário demasiado grande.
    • O ficheiro 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 o respetivo comprimento não exceda max_bytes.

AITR2130 - TranslationServiceInternal

Exemplo de mensagem de erro:

  • Falha ao iniciar a transação da base de dados.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Falha ao terminar a transação da base de dados.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Falha ao reverter a transação de base de dados não comprometida.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Falha ao traduzir o texto.

    • O comprimento máximo de entrada de 1024 carateres foi excedido.
    • Siga as recomendações em Considerações.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2133 - GlossaryInternal

Exemplos de mensagens de erro:

  • Falha ao obter os glossários.

    • Não é possível obter o glossário da base de dados devido a problemas de ligação.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não é possível descompactar os metadados do glossário de eliminação.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não é possível descompactar os metadados de criação do glossário.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não é possível descompactar a especificação de criação do glossário.

    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não foi possível criar transações de base de dados para o serviço de tradução.

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

    • Falha ao criar as tabelas de tradução para armazenar as entradas do glossário.
    • Verifique o estado do serviço de base de dados e reinicie o servidor de tradução.
  • A tabela do glossário não existe.

    • As tabelas necessárias do glossário de tradução não existem.
    • Reiniciar o servidor volta a tentar a criação da tabela.
  • O certificado do servidor S3 não pode estar vazio.

    • As informações necessárias para estabelecer ligação ao StorageGrid não estão preenchidas corretamente no servidor de tradução.
    • Verifique o estado do StorageGrid e reinicie o servidor de tradução.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • O ID de acesso ao S3 não pode estar vazio.

    • As informações necessárias para estabelecer ligação ao StorageGrid não estão preenchidas corretamente no servidor de tradução.
    • Verifique o estado do StorageGrid e reinicie o servidor de tradução.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • O segredo de acesso ao S3 não pode estar vazio.

    • As informações necessárias para estabelecer ligação ao StorageGrid não estão preenchidas corretamente no servidor de tradução.
    • Verifique o estado do StorageGrid e reinicie o servidor de tradução.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2134 - JobInternal

Exemplos de mensagens de erro:

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

  • Falha ao definir uma tarefa para o estado de processamento.

    • As operações de leitura ou escrita falharam em relação aos registos de tarefas porque a transação da base de dados falhou.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não é possível atualizar trabalhos concluídos.

  • Falha ao consultar ou executar async operação(ões).

    • Não é possível consultar nem atualizar as operações async devido a um dos seguintes motivos:
      • Problemas de ligação à base de dados.
      • Os dados são inválidos e não foram analisados para uma resposta.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Falha ao ler as tarefas.

    • As operações de leitura ou escrita nos registos de tarefas falharam devido a uma falha na transação da base de dados.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Não foi possível eliminar uma tarefa da base de dados.

    • As operações de leitura ou escrita nos registos de tarefas falharam devido a uma falha na transação da base de dados.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.
  • Devolve mais de uma tarefa com o mesmo job_id.

    • Verifique a sua base de dados para garantir que cada job_id aparece uma vez.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2135 - DetectLanguageInternal

Exemplo de mensagem de erro:

  • O resultado da deteção de idioma está em falta.
    • O detetor de idiomas não consegue identificar o idioma do conteúdo de entrada.
    • Verifique o conteúdo no pedido; certifique-se de que os carateres são válidos e que nenhuma das palavras está em idiomas misturados.
    • Volte a tentar o pedido.
    • Contacte o seu especialista de apoio técnico para receber assistência adicional.

AITR2140 - TranslationServiceUnavailable

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

  • Confirme se o servidor de front-end de tradução está em execução.
  • Para mais informações, consulte o artigo sobre como ativar APIs pré-preparadas.