Sincronización automática de conocimientos y configuración de metadatos

La sincronización automática de conocimientos mantiene el contenido público de WordPress seleccionado a disposición de la base de conocimientos de AI-Kit sin tener que publicar manualmente cada documento base generado. Es independiente de Static Publisher: uno actualiza la fuente de conocimientos que usan la búsqueda y el chat; el otro implementa páginas estáticas públicas.

Conectar el sitio​

Abra SmartCloud → Ajustes de AI-Kit → Base de conocimientos → Sincronización automática de conocimientos. Esta función Pro conectada requiere un backend de AI-Kit compatible. AI-Kit 1.4.19 y posteriores requieren la capacidad knowledge.automation 5 para la entrega automática de documentos, disponible en la versión 1.0.85 del backend y versiones compatibles posteriores. Los estados de origen que tienen en cuenta la sincronización, descritos a continuación, están disponibles desde AI-Kit 1.4.20.

1. Configure primero los Ajustes de API. Esta es la fuente de verdad para el backend: una URL directa se usa directamente; el nombre de una API REST de Gatey se resuelve al endpoint configurado. Backend de Ajustes de API es de solo lectura.
2. En Conexión y ejecutor, selecciona el entorno y el almacenamiento de claves privadas adecuados. Está disponible la opción Opción cifrada de WordPress; la opción Archivo protegido fuera de la raíz web requiere configurar la ubicación protegida del servidor. Con Desactivado no se puede inscribir el sitio.
3. Seleccione Guardar ajustes de conexión y, después, Crear código de emparejamiento e inscribir. El código de corta duración establece una clave de firma específica del sitio para las solicitudes posteriores en el servidor.
4. Confirme que el estado sea Inscrito y use Verificar conexión si es necesario.

La inscripción por sí sola no incluye todos los tipos de contenido en la sincronización.

Elegir el contenido y la política de aprobación​

En Política de contenido, selecciona un tipo de contenido público, active Sincronizar automáticamente este tipo de contenido, configura su política y elija Guardar política de contenido. Repita el proceso para cada tipo deseado. Se admiten las entradas y páginas estándar, además de los tipos de contenido personalizado públicos aptos que tengan URL públicas.

• La publicación de WordPress constituye la aprobación permite la entrega automática de los cambios del contenido publicado.
• Revisión manual de KB retiene los cambios hasta que un administrador los revisa y seleccione Aprobar el tipo de contenido seleccionado en Estado operativo.
• Taxonomías incluidas en los metadatos permite elegir qué taxonomías aportan términos de documentos y vocabulario derivado de WordPress. Seleccionar taxonomías sin activar y guardar la política de contenido no publica ningún vocabulario.
• Perfil del documento es una etiqueta avanzada de enrutamiento que se guarda con los metadatos del documento en el backend. Mantenga default salvo que sus filtros de recuperación usen explícitamente otro perfil; por sí solo, no cambia la conversión ni la ingesta.

Solo se entrega contenido publicado apto de los tipos de contenido públicos seleccionados. Los borradores, revisiones, propuestas sin publicar y el contenido con estado privado no son fuentes de entrega automática. Si se retira la publicación de contenido sincronizado anteriormente, se genera una solicitud de eliminación en lugar de cargar la versión sin publicar. Los conjuntos grandes de eliminaciones pueden requerir aprobación explícita.

Programación y sincronización inicial​

AI-Kit registra un evento cron de WordPress que debe ejecutarse cada cinco minutos. El tráfico ordinario de WP-Cron puede ejecutarlo. En sitios con poco tráfico o cuando WP-Cron basado en tráfico está desactivado, programa wp cron event run --due-now cada cinco minutos en el servidor de WordPress. Un bloqueo del ejecutor evita que se solapen las pasadas.

Este es un flujo de trabajo de PHP en el servidor, no una tarea realizada por los visitantes del frontend estático. El alojamiento de WordPress necesita conectividad saliente hacia el backend resuelto. El chatbot y Doc Search basados en el navegador pueden seguir funcionando en un sitio estático una vez que la instalación de WordPress de origen haya sincronizado su contenido.

Ejecutar una pasada de sincronización realiza una pasada acotada, no necesariamente toda la importación inicial. Los tamaños de los lotes de referencia y transporte limitan el trabajo por pasada; cron continúa el trabajo restante. Consulte Estado operativo para ver el trabajo pendiente, los registros de referencia, los motivos de bloqueo, el estado de ingesta y el último resultado del ejecutor.

Capas de configuración de metadatos​

El cuadro Capas de configuración de metadatos combina tres entradas con propietarios independientes. No son tres copias editables de un mismo archivo generado.

Todos los editores y vistas previas de las capas de metadatos usan YAML. Este formato de presentación y almacenamiento no cambia los objetos JSON estructurados de solicitud y respuesta de la API, ni los archivos complementarios *.metadata.json necesarios para la ingesta en la base de conocimientos; estos siguen siendo JSON.

El resultado generado combina los vocabularios externos y de WordPress activados con la política manual. Use allowedCategories, allowedTags y namespaceTags para los valores que quiera conservar intencionadamente en la capa manual; los valores de namespaceTags también deben aparecer en allowedTags. Los campos existentes, como categoryPolicies, siguen siendo políticas creadas manualmente. Use vocabularyPolicy solo cuando se necesiten alias, exclusiones o valores de visualización bloqueados para normalizar las entradas automáticas. Edite las entradas o la política, no el resultado generado.

Por ejemplo, un vocabulario externo puede expresar una jerarquía de categorías sin convertir una categoría secundaria en otra categoría de nivel superior:

- id: docusaurus
  enabled: true
  namespaces:
    category:
      - slug: guides
        label: Guides
      - slug: setup
        label: Setup
        parentSlug: guides
    post_tag:
      - ai-kit

Mantenga estables los ID de los productores. La lista YAML externa contiene envoltorios de vocabularios, no documentos para cargar. Al actualizar este panel solo se lee su estado actual; ejecute una pasada de sincronización o espera a cron para entregar el vocabulario de WordPress modificado.

Migrar una configuración existente​

Cuando aparece Configuración heredada lista para migrar, las entradas externas y de WordPress se preparan mientras la configuración efectiva actual permanece sin cambios. Revise el Resultado propuesto antes de elegir Establecer capa manual. La capa manual propuesta conserva los campos de política desconocidos y los que solo existen en la capa manual, mientras deja el vocabulario aportado por los productores bajo su control.

Al establecer la capa manual se activa la combinación preparada. No es una instrucción para descartar la política personalizada existente ni elimina documentos antiguos de la base de conocimientos. Revise deliberadamente los valores manuales conservados de categorías y etiquetas; no los borre por el mero hecho de que otro productor también use esos términos. Después de la migración, las siguientes entradas o políticas válidas que se guarden pueden actualizar el resultado efectivo sin otro paso de establecimiento.

URL de origen y sustituciones de documentos​

Para un documento base generado automáticamente, el orden de precedencia de la URL de origen es:

1. La URL de origen explícita del documento en Editar metadatos del documento base.
2. Ajustes de KB → Sustitución de URL base, aplicada al enlace permanente de WordPress.
3. El enlace permanente original de WordPress.

Use la sustitución global cuando un sitio editorial tenga un origen público diferente; por ejemplo, si se edita en un nombre de host de desarrollo pero el contenido se sirve desde el nombre de host de producción. Una URL explícita por documento tiene prioridad.

La sincronización automática también respeta las sustituciones del título, descripción, categoría, subcategoría y etiquetas del documento base. Estas sustituciones de metadatos no bloquean por sí solas el Markdown generado. Las modificaciones de metadatos entran en el flujo de sincronización conforme a la misma política de aprobación; cambiar la sustitución global de URL base activa la conciliación de los documentos existentes.

Interpretar correctamente el estado​

El filtro de estado de publicación y las insignias de Orígenes de KB distinguen estados de entrega automática como pendiente de sincronización, sincronizando, entregado, error, bloqueado y eliminado. Cuando está disponible, los errores incluyen su motivo específico.

Entregado significa que el backend ha recibido la generación actual del documento. No significa que haya terminado la indexación de la base de conocimientos. Comprueba la ingesta del backend en Estado operativo antes de esperar resultados actualizados en la búsqueda o el chat.

Necesita revisión sigue siendo pertinente para el trabajo con aprobación manual, los documentos manuales independientes o las sustituciones bloqueadas obsoletas. La entrega automática correcta de un documento base no aprueba automáticamente esos elementos independientes. A la inversa, la mera ausencia de un registro de publicación manual no somete a revisión un documento base sincronizado.