🤖 Mantenimiento y Sincronización del Chatbot IA (BetterDocs)
Procedimiento técnico para actualizar la API de OpenAI y sincronizar la base de conocimientos vectorial.
El Chatbot de Inteligencia Artificial requiere leer y procesar todos los artículos de la plataforma (generar embeddings o vectores) para poder responder a las consultas de los usuarios. Cuando se actualiza la API Key o se agregan múltiples artículos nuevos, es obligatorio forzar la sincronización.
Síntoma de Falla
Si el usuario intenta hacer una pregunta y recibe el mensaje: «We’re currently experiencing a temporary issue with our AI Chatbot system…», significa que el chatbot no tiene contexto o la base vectorial está desactualizada.
Paso 1: Actualizar la API Key de OpenAI
Paso 2: Forzar Sincronización Vectorial (Crucial)
Poner la llave no es suficiente. Debes ordenar al plugin que lea todos los artículos y los envíe a OpenAI para generar los vectores.
- Ve al panel de WordPress: BetterDocs > AI Chatbot > Sync (o Migración).
- Busca el botón de Sincronización en Segundo Plano (Background Sync) o similar.
- Haz clic en Sincronizar Todo.
- Espera de 5 a 10 minutos (dependiendo de la cantidad de artículos). No cierres la ventana si el sistema indica que el proceso requiere mantener la pestaña abierta.
Si la sincronización falla por interfaz, un administrador puede forzarla mediante la REST API enviando un POST a:
/wp-json/betterdocs-pro/v1/retry-all-sync.
