Este artigo resume problemas comuns, etapas de solução de problemas e o escopo do suporte técnico disponível para ajudar a localizar rapidamente problemas como "fila parada, falha na tarefa, falha na entrega e faturamento anormal".
I. Perguntas Frequentes (FAQ)
1) Quais sites e tipos de conteúdo são suportados?
Ele oferece suporte a conteúdo multilíngue gerenciado via WPML, incluindo artigos, páginas e tipos de conteúdo personalizados compatíveis com o WPML (sujeitos à configuração real do site).
As tarefas de tradução são baseadas nas tarefas XLIFF na fila do WPML e são automaticamente devolvidas ao WPML após a conclusão.
2) Quais são as principais diferenças entre a versão gratuita e a versão paga?
-
Gratuito: Apenas a tradução automática (TA) é suportada.
-
Assinatura paga: Suporta tradução de LLM, modelo de prompt selecionável (
b2b / b2c / tech_doc / creativeEle permite configurar prompts de perfil personalizados para o site e possibilita que os usuários tragam suas próprias chaves de API (sem consumir créditos de assinatura).
3) Como é cobrada a tradução de um LLM? Por que o custo é menor/maior do que o esperado?
O LLM é calculado com base nos tokens de entrada/saída reais, e o custo está relacionado ao preço unitário do modelo selecionado.
Como o sistema extrai texto/nós traduzíveis e minimiza conteúdo inválido (como tags e estruturas HTML), geralmente economiza menos tokens do que "traduzir o texto inteiro diretamente".
O alto consumo pode ser causado por: conteúdo duplicado, parágrafos longos, grande quantidade de texto visível ou número excessivo de tentativas. O registro final de consumo será usado como indicador definitivo.
4) Por que a tarefa falhou? Serei cobrado se ela falhar?
A falha pode ser desencadeada pelos seguintes motivos:
-
Saída instável do modelo, limitação de taxa/tempo limite no servidor
-
A estrutura do conteúdo é complexa (espaços reservados, tags aninhadas, codificação anormal).
-
Chave de API inválida/Saldo insuficiente/Permissões insuficientes/Restrições regionais
-
Erro de rede ou permissões insuficientes para pushback no site.
Tarefas com falha também podem incorrer em custos parciais (por exemplo, uma solicitação foi enviada e um resultado parcial foi retornado), e a liquidação será baseada nos custos reais registrados pelo sistema.
5) O valor da minha assinatura ainda será debitado após a ativação da chave de API integrada?
Após ativar a chave de API integrada, as solicitações de tradução usarão a chave integrada e não consumirão créditos da assinatura. O custo será incluído na fatura da chave integrada pelo provedor de serviços terceirizado.
O sistema continuará registrando tarefas, status e detalhes de consumo (para fins de conciliação e solução de problemas).
6) Como escolher um modelo de prompt? O que deve ser incluído em um prompt de perfil personalizado para o site?
-
b2bProdutos/soluções, serviços empresariais, com forte ênfase em profissionalismo e rigor. -
b2cOrientada para o consumidor, com foco na natureza e na cordialidade. -
tech_docDocumentação técnica/central de ajuda, precisão consistente -
creativeRedação publicitária/criativa para marketing, com foco em expressão e estilo.
Idealmente, os perfis personalizados do site devem incluir:
-
Tom da marca (conciso/autoritário/dinâmico, etc.)
-
Público-alvo e contexto do produto
-
Preferências de terminologia e expressões desativadas
-
Preferências de estilo para títulos/botões/CTAs
7) Existe um glossário disponível?
O recurso de glossário será lançado em breve. A versão final dependerá da descrição na página do recurso e das informações de suporte do mecanismo de busca.
II. Guia de Solução de Problemas (Localize Problemas Rapidamente com Base nos Sintomas)
Sintoma A: Existem tarefas na fila do WPML, mas elas não estão visíveis na lista de tarefas ou não estão sendo processadas.
Verificações prioritárias:
-
O site foi vinculado com sucesso?Acesse "Gerenciamento do Site" para confirmar se o status está normal.
-
A autorização/chave do site expirou?Caso tenha alterado o nome de domínio, o HTTPS ou a estratégia de cache, recomenda-se verificar novamente a vinculação.
-
A fila do WPML realmente entrou no estágio de "tradução pendente"?Confirme se a tarefa foi atribuída à fila e se não foi assumida por outros serviços de tradução.
-
As tarefas do site excederam o limite de sites do pacote?Ultrapassar o limite pode resultar na não atribuição da tarefa.
-
O sistema apresenta atrasos na fila?Pode haver filas durante os horários de pico; atualize o status da tarefa mais tarde.
Se o problema persistir: Exporte o momento em que a tarefa apresentou problemas, o ID da tarefa (ou o par título/idioma da tarefa) e abra um chamado de suporte.
Sintoma B: A tarefa exibe "Falha/Anormal".
Confira a ordem:
-
Verifique o motivo da falha.Abra os detalhes da tarefa em "Tarefa de Tradução" e registre as mensagens de erro.
-
Confirme o motor e as permissões.
-
Pacote Gratuito: Confirmado que o motor LLM não foi selecionado.
-
Inclui uma chave de API integrada: Confirme a validade da chave, o limite de crédito suficiente e as permissões corretas.
-
-
Reduza a complexidade e tente novamente.
-
Primeiro, utilize a tradução automática para verificar se o processo foi bem-sucedido.
-
Volte para o LLM e use o Prompt, que é mais estável (preferencial).
tech_docoub2b)
-
-
problemas de estrutura de conteúdo
-
Se o conteúdo contiver um grande número de marcadores/códigos curtos/HTML complexo, recomenda-se dividir a página ou reduzir a quantidade de conteúdo em uma única tarefa.
-
-
Limitação de taxa/tempo limite
-
Substituir motor/modelo
-
Evite submeter muitas tarefas em um curto período de tempo.
-
Sintoma C: Tradução concluída, mas não enviada de volta para o WPML / Resultados não visíveis no WPML
Principais áreas de inspeção:
-
O WPML permite receber mensagens de resposta (write-back)?As permissões do site e o status do WPML estão normais?
-
bloqueio de firewall/WAF/plugin de segurança do siteIsso geralmente ocorre quando as interfaces de retorno de chamada são interceptadas.
-
O armazenamento em cache causa atraso na exibiçãoTente novamente após limpar o cache de páginas/cache de objetos.
-
A tarefa está atualmente com o status "pendente de revisão"?Alguns processos do WPML exigem confirmação manual antes da publicação.
Sintoma D: Erros de formatação/tags anormais/espaços reservados ausentes aparecem após a tradução.
Ação recomendada:
-
Priorize a mudança
tech_docModelo de prompt -
Adicionar restrições ao prompt do perfil personalizado do site, por exemplo:
-
"Mantenha todos os espaços reservados/variáveis/códigos curtos inalterados"
-
Não traduza tags e atributos HTML.
-
-
Se o problema ocorrer apenas em algumas páginas: divida a página ou reduza o tamanho dos blocos de texto traduzidos de uma só vez.
-
Se o problema puder ser reproduzido: Forneça o tipo de página e o idioma originais e envie para suporte local.
Sintoma E: Os valores cobrados não correspondem às expectativas / O limite de crédito diminui muito rapidamente
Etapas de verificação:
-
Verifique se existe em "Detalhes de Consumo de Tarefas":
-
Várias tentativas acarretam custos adicionais.
-
Execução repetida da mesma tarefa
-
Quanto mais longo for o tempo de saída do modelo, maior será o número de tokens de saída.
-
-
Confirme se a chave de API integrada está ativada (a chave integrada não utiliza taxas de assinatura, mas a cobrança de terceiros pode gerar custos adicionais).
-
Caso suspeite de alguma anomalia: Envie "ID da Tarefa + Intervalo de Tempo + Motor/Modelo" para verificação.
III. Âmbito do Suporte Técnico Disponível
Canais suportados (é recomendável acessar a página de destino)
-
Suporte por ordem de serviço/e-mail (recomendado): Utilizado para solucionar problemas, lidar com anomalias de reversão e verificar cobranças.
-
Documentação e perguntas frequentes: configurações comuns, etapas de solução de problemas, melhores práticas
Assistência disponível
-
Solução de problemas de instalação e vinculação (verificação do site, permissões, falhas de retorno de chamada)
-
Solução de problemas e recomendações para filas que não processam/falhas de tarefas
-
Configuração do mecanismo e recomendações de uso do Prompt (selecione de acordo com o cenário)
-
Verificação de detalhes da transação e investigação de anomalias (com base em registros e logs de tarefas)
Não está incluído no escopo do suporte (por favor, esclareça).
-
Modificar a configuração do WPML ou o código de plugins de terceiros em seu nome.
-
Disputas de faturamento e reembolsos de fornecedores de modelos terceirizados (com suas próprias chaves de API)
-
Desvio forçado que entra em conflito com as políticas de segurança do site (como desativar regras de firewall).