Mantenimiento

Una wiki vieja es peor que no tener wiki: te da respuestas con confianza sobre cosas que ya no son ciertas. noxxa hace dos cosas para evitar eso: el Lint y el Contexto de tu empresa.

Calidad (Lint): el guardián nocturno

Noche por medio (madrugada, ≈03:00 UTC), noxxa revisa toda tu wiki y produce dos tipos de salida.

Hallazgos en Calidad, los que requieren acción puntual:

Al día siguiente, en Calidad, ves la lista. Está ordenada por recencia (los hallazgos más nuevos arriba), no por severidad. Cada hallazgo trae un indicador visual de color según su prioridad, con la paleta muted de noxxa, no un semáforo rojo/ámbar/gris:

• Amatista (prioridad alta): enlaces caídos e información que no calza.
• Oro (prioridad media): páginas sueltas y páginas que pueden estar desactualizadas.
• Índigo (prioridad baja): propuestas de división de área (ver abajo).

Propuestas de estructura, áreas que crecieron mucho y conviene dividir. Estas no aparecen en Calidad sino en Admin → Estructura (ver más abajo).

Resolver un hallazgo

Para cada hallazgo hay tres acciones de triage (si tienes permiso de acción en el área):

• Marcar resuelto. Lo corregiste (o es un hallazgo válido y ya está cerrado). Desaparece de la lista.
• No es un problema. Es un falso positivo. Lo descarta y además lo suprime de forma permanente, para que ese mismo hallazgo no vuelva a aparecer en futuras corridas.
• Posponer. Lo aplaza 14 días. Pasado ese plazo, si la causa sigue ahí, vuelve a la lista.

Cada hallazgo trae además un enlace contextual: Editar la página, Editar en Drive, Linkear desde el índice, Revisar plan de división, lo que tenga sentido según el tipo de problema.

Ejecutar Lint manualmente

Por defecto, Lint corre noche por medio (madrugada UTC). Si acabas de ingresar un lote de documentos y quieres ver los hallazgos antes del próximo ciclo nocturno, puedes gatillar una revisión manual desde Calidad → "Correr ahora" (sección al inicio de la página; Calidad vive en el menú lateral, no es una pestaña de Admin).

Quién puede usarla

Solo los miembros con rol Admin ven el botón. Los workspaces de demo (sandbox) no tienen acceso: el Lint, nocturno o manual, no corre en demos.

Qué hace

Ejecuta el mismo proceso que el Lint nocturno: revisa enlaces caídos, contradicciones, páginas sueltas y páginas que pueden estar desactualizadas, escribe los hallazgos en la página Calidad y refresca las propuestas de división en Admin → Estructura.

Cuánto demora

Depende del tamaño de tu wiki. Wikis pequeñas (menos de 200 páginas) tardan entre dos y cinco minutos; wikis grandes pueden tardar más. Mientras el proceso corre, el botón muestra el estado en tiempo real. Puedes cerrar la pestaña: el proceso sigue en segundo plano y los hallazgos aparecen cuando termina.

Costo

Cada ejecución consume del presupuesto mensual del workspace, igual que el ciclo nocturno.

Contexto de tu empresa: la columna vertebral

El contexto vive en Admin → Contexto. Es un solo campo en Markdown donde le explicas a noxxa cómo está organizado tu negocio. La IA lo lee cada vez que clasifica un archivo o responde una pregunta.

La forma rápida de empezar: pega la URL del sitio web de tu empresa y noxxa redacta un primer borrador por ti (con Sonnet, a partir de lo que encuentra en tu sitio). Lo revisas, lo ajustas y listo. También puedes escribirlo a mano o partir del ejemplo. Sea generado o escrito a mano, conviene que cubra tres cosas.

Áreas

Las áreas grandes de tu empresa. Cada área es una carpeta de primer nivel en la wiki. Reglas:

• Entre 5 y 12 áreas. Menos y se mezcla todo; más y te pierdes.
• Nombres cortos, kebab-case: finanzas, clientes, rrhh, compliance.
• Cuando agregas un área (desde Documentos), su portada index.md se crea automáticamente, con título y frontmatter ya poblados. Puedes editar su contenido cuando quieras, pero la portada ya viene lista; no hace falta crearla a mano.

Glosario

Términos que solo tu empresa usa así. Por ejemplo:

- cliente platino: cliente con facturación anual > 500 UF
- OC interna: orden de compra entre dos áreas de la misma empresa
- política 90/60: política de retención de 90 días para clientes nuevos,
  60 para recurrentes

Sin glosario, noxxa interpreta términos genéricamente. Con glosario, los entiende como tu empresa los entiende.

Ejemplos

Tres a cinco preguntas reales que tu equipo haría y cómo te gustaría que noxxa las responda. Esto sirve para calibrar el estilo de respuesta.

Admin: el panel completo

El panel de Admin está organizado en pestañas. Esta es la guía rápida de cada una.

Contexto

Donde defines áreas, vocabulario y ejemplos. Ya cubierto arriba: es el campo Markdown único que la IA lee al ingestar y al responder, y que puedes generar desde la URL del sitio web de tu empresa.

Miembros

Una sola pestaña que reúne personas y acceso por área en una matriz Personas × Áreas. Ya no hay pestañas separadas de "Miembros" y "Áreas": desde aquí invitas gente, ves quién está activo y administras tanto el rol global como el acceso fino por área de cada persona.

Hay tres roles globales en el workspace:

Y la misma matriz controla el acceso fino por área:

• Cada celda muestra qué accede cada persona a cada área, y la visibilidad (pública o restringida) de cada área.
• Por defecto, las personas leen las áreas visibles. Puedes restringir un área a un subconjunto de personas (ej. el equipo de RRHH solo ve rrhh).
• Dentro de cada área el acceso puede variar: alguien puede ser editor en finanzas (puede arreglar páginas y resolver hallazgos de Calidad allí) y solo lector en legal.
• La restricción de un área aplica tanto a navegar la wiki como a hacer preguntas en el chat: si preguntas algo de un área a la que no tienes acceso, noxxa te responde "no encontré información", sin revelar que existe.

Uso

El consumo del mes (tokens, gasto en USD y segundos de sandbox) y el tope del plan. Es donde miras si te estás acercando al límite antes de que pase, y donde puedes fijar un límite de gasto mensual. Cada mes se reinicia.

Conectores

Vista resumida de las fuentes conectadas. Para el flujo completo de conexión y manejo de cada fuente está la pestaña pública Fuentes y la doc de Fuentes.

Conector MCP

Habilita consultar tu wiki desde clientes MCP como Claude, ChatGPT o Claude Code. Es un conector remoto de solo lectura con una única herramienta (ask_wiki), que responde como el chat y hereda tu control de acceso. La autenticación es por OAuth. Detalle completo en MCP.

Herramientas

Acciones avanzadas que no se usan a diario:

• Exportar wiki, bajas un zip con toda tu wiki en Markdown plano (más el contexto de empresa y un README). Detalle en Seguridad y privacidad.
• Zona peligrosa, eliminar el workspace por completo. Requiere escribir el slug y un check explícito; borra páginas, fuentes, chats y archivos subidos.

Estructura

Propuestas automáticas para dividir áreas que crecieron mucho. Cada propuesta es un hallazgo needs_split del Lint nocturno: detecta áreas con demasiadas páginas o demasiada heterogeneidad y sugiere cómo partirlas en sub-áreas. La aplicación del split se hace a mano: esta pestaña solo te da la propuesta y el contexto.

Auditoría

El registro del workspace, en tres vistas:

• Chats, cada conversación del chat web, con sus citas.
• WhatsApp, las conversaciones del canal de WhatsApp (separadas de los chats web).
• Eventos, registro estructurado: accesos, preguntas, invitaciones, cambios de contexto, conexiones de fuentes, corridas de Lint, exports, eliminaciones. Filtrable por tipo, fecha y actor; la vista de Eventos se puede exportar como CSV.

Detalle completo en Seguridad y privacidad.

Agentes

Perfiles de agente fijos por conversación. Defines un nombre, una descripción y unas instrucciones de sistema; en el chat los usuarios pueden elegir entre los perfiles activos para cambiar el tono o la prioridad de las respuestas.