Solucionar problemas de la traducción automática
Empieza por el mensaje que se muestra junto a la acción de POM AI o en el registro de actividad de Generate pending translations. Después, relaciona el síntoma con las comprobaciones de abajo.
| Síntoma | Causa probable | Comprobación |
|---|---|---|
| La acción de POM AI no aparece | La traducción por LLM está desactivada o no existe ninguna configuración regional de destino | Settings → POM Translate → Advanced y la lista de idiomas adicionales |
| Se requiere una licencia válida de POM AI | No existe ninguna clave de POM AI legible para este sitio | Settings → POM AI → License |
| El dominio no está configurado ni autorizado | El host actual no figura en la licencia de POM AI | La línea Domain y la lista de dominios autorizados de la cuenta |
| No hay suficientes créditos de IA | El saldo de la cuenta o la asignación de este dominio se ha agotado | Settings → POM AI → License y My Account → POM AI Management |
| Se ha alcanzado el límite diario de traducciones | El contador local de palabras o cadenas no tiene espacio para el siguiente lote | Machine Translation Status y los ajustes de traducción por LLM |
| La traducción está temporalmente en pausa | Los fallos que cumplen los requisitos alcanzaron el umbral de errores | Licencia, conectividad, último error y tiempo de espera |
| No se pudo contactar con el servicio | Problema de HTTPS saliente, DNS, cortafuegos o temporal del servicio de la cuenta | Vuelve a intentar un elemento pequeño una vez restablecida la conectividad |
| La respuesta de la IA no se podía usar | Salida vacía, incompleta, mal formada o ausente | Vuelve a intentar una cadena representativa; revisa manualmente los casos persistentes |
| Los marcadores de formato protegidos cambiaron | Se eliminaron, duplicaron o alteraron marcadores de posición obligatorios | Deja la fila pendiente y corrígela manualmente |
| La fuente cambió durante la solicitud | Un editor guardó la fuente antes de que llegara la respuesta | Vuelve a ejecutar la traducción con la fuente actual |
| La cadena supera el límite | Un valor extraído supera las 400 palabras de carga útil, incluidos el formato protegido y los marcadores de aplicación | Busca la fuente en los detalles del lote y, a continuación, divide el contenido de origen o traduce el valor manualmente |
| La cola no avanza | La traducción en segundo plano está desactivada o el cron de WordPress no se está ejecutando | Ajuste de segundo plano, ejecutor de cron y, después, Process now |
Usa la vista de estado correcta
Abre Translations → Generate pending translations para inspeccionar el tamaño de la cola, el uso de palabras, el uso de cadenas y el estado de pausa.
Después abre Translations → Translate contents, selecciona el idioma de destino y filtra:
- Pending para valores sin resolver o rechazados;
- Machine para resultados correctos de POM AI pendientes de revisión editorial.
Que el generador complete su análisis de objetos no demuestra que todas las cadenas se hayan traducido. El filtro final de pendientes es la lista de revisión autoritativa para el contenido respaldado por la base de datos.
Identifica un lote afectado
Los lotes de cadenas almacenadas fallidos incluyen Batch details en el registro de actividad: la configuración regional de destino, los ID de cadena, los tipos e ID de objeto de origen, los campos de origen y los recuentos de palabras y cadenas de la carga útil junto con sus límites por solicitud. Estos detalles están disponibles sin habilitar el registro de depuración de WordPress. Contienen identificadores y recuentos, no el texto de origen ni la indicación de traducción.
Por ejemplo, una fuente mostrada como post:567:post_content pertenece al contenido de la entrada o página 567. Abre Translations → Translate contents, selecciona el idioma indicado, establece Filter by status en Pending, establece Filter by object type en Post, introduce 567 en Object ID y selecciona Filter. Una fuente meta pertenece a un campo personalizado de esa misma entrada. Los valores registrados se gestionan en Other translations.
Cuando solo una parte de un lote queda sin resolver, los detalles identifican esas filas restantes. Un trabajo en pausa después de fallos de traducción repetidos también enumera sus ID de cadena pendientes y su configuración regional. Corrige la causa notificada antes de reanudar el mismo modo de procesamiento.
Las palabras de la carga útil se cuentan después de que el formato y los marcadores de aplicación se hayan protegido para la solicitud de traducción. Este recuento puede superar el número de palabras visibles en el editor. Las solicitudes de varias cadenas se dividen automáticamente cuando su carga útil final supera un límite de solicitud local; una cadena individual que siga superando el límite requiere atención manual.
Reintenta de forma segura
- Corrige primero la causa determinista.
- Vuelve a intentar un valor corto.
- Confirma la configuración regional de destino y el estado almacenado.
- Confirma que los contadores locales y el saldo de POM AI se comportan como se espera.
- Reanuda una ejecución mayor solo después de que la muestra tenga éxito.
No restablezcas los contadores de cuota locales para resolver un problema de licencia, dominio, créditos, red o formato. El restablecimiento no cambia ninguna de esas condiciones.
Si un valor no se puede traducir automáticamente, introdúcelo manualmente. Dejar el campo vacío también es seguro: la representación pública usa como alternativa el texto de origen.