Documentación de BizCortex

Pestaña Fuentes: de dónde proceden las actualizaciones

Conecte documentos, versiones de software, tickets de soporte y preguntas de lectores como fuentes de propuestas de cambio.

Las fuentes alimentan la parte de Manuales que se actualiza sola. BizCortex lee lo que entrega una fuente, comprueba si afecta a las instrucciones de uso y, en tal caso, redacta una propuesta de cambio. No se aplica nada sin aprobación. La pestaña muestra una tarjeta por cada tipo de fuente.

Pestaña Fuentes: de dónde proceden las actualizaciones
Captura de pantalla de esta vista

Quién puede usarlo

  • Propietario y Administrador pueden añadir, configurar, cargar y obtener fuentes
  • Todas las personas con el permiso de lectura de fuentes de Manuales pueden consultarlas

Pasos

  1. 1. Añadir una fuente

    Haga clic en el botón con el signo más de una tarjeta, por ejemplo «Añadir Versiones de GitHub». Rellene el cuadro de diálogo y guarde.

  2. 2. Configurar el webhook (GitHub y GitLab)

    Después de crear una fuente de GitHub o GitLab, BizCortex muestra la URL del webhook y el secreto del webhook. El secreto solo se muestra en ese momento; cópielo antes de cerrar el cuadro de diálogo. Introduzca la URL y el secreto en los ajustes de webhook del repositorio y elija el evento releases. A partir de entonces, las nuevas versiones llegan de inmediato.

  3. 3. Guardar credenciales

    Haga clic en «Credenciales» en una fuente de GitHub, GitLab o tickets y guarde un token de API con acceso de lectura. Haga clic en «Guardar token». Un token guardado no se vuelve a mostrar nunca; uno nuevo lo sustituye.

  4. 4. Cargar documentos

    En una fuente de Documentos, arrastre archivos PDF, DOCX, Markdown o de texto (de hasta 50 MB cada uno) a la zona de carga. BizCortex muestra cuántos elementos se han recogido.

  5. 5. Obtener, pausar y revisar elementos

    Haga clic en «Obtener ahora» para leer una fuente de inmediato. Haga clic en «Pausar» para detener una fuente y en «Reanudar» para volver a iniciarla. Haga clic en «Elementos» para ver lo que ha entregado la fuente y en qué ha quedado.

  6. 6. Eliminar una fuente

    Haga clic en el botón de eliminar y confirme. Las propuestas ya creadas se conservan.

Campos y opciones

Documentos

Suba avisos de cambios, boletines de servicio o modificaciones de diseño. Si sube dos veces el mismo archivo, no se añade nada.

Versiones de GitHub

Nuevas versiones de software de un controlador o una app. Introduzca el repositorio como propietario/nombre. Opcional: «Incluir versiones preliminares». BizCortex comprueba cada 30 minutos y también acepta el webhook.

Versiones de GitLab

Versiones de GitLab, también autoalojado. Introduzca el repositorio y la «Dirección del servidor» (por defecto gitlab.com).

Tickets de soporte

Tickets resueltos de Zendesk, Freshdesk, Zammad o Jira. Elija el sistema y un filtro opcional, por ejemplo una etiqueta o una vista. Por defecto solo se leen los tickets resueltos de los últimos 30 días, con una comprobación cada 60 minutos. Un ticket con una nueva respuesta se vuelve a leer.

Preguntas de lectores sin respuesta

Las preguntas que el manual no ha podido responder se agrupan cada noche en propuestas de lagunas. Cada manual solo puede tener una fuente de este tipo.

Estado

Activa, En pausa o Error. El último error se muestra en la fuente. Una fuente con error vuelve a Activa tras la siguiente obtención correcta.

Recuentos

El total de elementos y los elementos nuevos, y cuándo se obtuvo la fuente por última vez o «nunca obtenida».

Estado del elemento

Nuevo, No relevante, Procesado, Duplicado o Fallido.

Conviene saber

  • Los datos personales se eliminan antes de guardar un elemento y antes de que cualquier modelo de IA lo vea: direcciones de correo electrónico, números de teléfono, IBAN, nombres tras los saludos, bloques de firma, menciones y todos los nombres que el sistema de soporte haya asociado al ticket.
  • Un elemento solo se convierte en propuesta cuando es relevante y afecta a las instrucciones de uso. Los borradores muy inciertos se descartan.
  • Cargar y obtener requiere el permiso de escritura de fuentes de Manuales; añadir, pausar y eliminar fuentes y guardar tokens requiere el permiso de administración de fuentes de Manuales. Por defecto, ambos los tienen Propietario y Administrador.

Relacionado