noxxa / Documentación

Documentos

Cómo está organizado tu conocimiento y cómo navegarlo.

Documentos es el cerebro de noxxa. Es donde vive el conocimiento de tu empresa, estructurado en páginas que la IA escribe y mantiene a partir de tus fuentes.

Puedes leerlos directamente, sin pasar por el chat, cuando quieras navegar en vez de preguntar. Vives en la sección Documentos de cada workspace (/{tu-empresa}/documentos).

noxxa / acme-cl/documentos/finanzas/viaticosWiki
finanzasfinanzas/viaticos.md

Política de viáticos

origenfinanzas-2026.pdf · Google Drive
Viáticos por viajes nacionales: 1.5 UF/día para alimentación + reembolso de hotel hasta 2 UF/noche con boleta. Aprobación de jefatura requerida si excede 3 días.

Resumen ejecutivo

La política de viáticos cubre alimentación, traslado y alojamiento para colaboradores en viaje fuera de la región metropolitana.

Montos vigentes

  • Alimentación y traslado: 1.5 UF/día (no requiere boleta).
  • Hotel: reembolso contra boleta, máximo 2 UF/noche.
  • Excede 3 días consecutivos → requiere aprobación de jefatura directa.

Para viajes internacionales aplica la política dedicada de relaciones-internacionales/viajes.

Páginas que enlazan acá
finanzas/reembolsosrrhh/politica-de-viajesoperaciones/desplazamientos-en-terreno

Cómo están organizados

Piensa en tus documentos como las carpetas de tu computador, pero más ordenadas porque las arma la IA. Hay dos tipos de elementos:

  • Secciones (áreas y carpetas): agrupan contenido relacionado. Pueden contener más secciones adentro, sin límite de profundidad.
  • Páginas: el contenido concreto que te interesa leer.

Cada sección tiene una portada automática (index.md): un resumen navegable de todo lo que vive dentro. Cuando creas un área, su portada se genera sola. Si solo lees la portada de un área, ya tienes el mapa de esa parte de tu empresa.

Un ejemplo real

Así podría verse el área Finanzas de una empresa mediana:

finanzas/
Finanzas
├─Portada
├─Viáticos
├─Política de gastos
└─Reembolsos
├─Portada
├─Política general
├─Formularios
└─Casos especiales
├─Socios
└─Contratistas
├─Portada
├─Régimen honorarios
└─Régimen laboral

Y al lado convivirían otras áreas, cada una con su propio acento de color:

clientes/ · rrhh/
Clientes
├─Portada
├─Cartera vigente
└─Contratos
├─Portada
├─Marco general
└─B2B
├─Plantilla estándar
└─Anexos
├─Confidencialidad
└─SLA
RRHH
├─Portada
├─Onboarding
├─Políticas
└─

Las áreas de primer nivel (Finanzas, Clientes, RRHH…) las creas tú desde Documentos. Lo de adentro lo organiza la IA siguiendo el contenido real de tus fuentes.

La profundidad no está limitada técnicamente. Pero si una rama supera cuatro o cinco niveles, suele ser señal de que conviene partir esa subsección en una nueva, porque la portada de esa área se vuelve difícil de escanear. El Lint te avisa cuando esto pasa (lo lista como área muy grande).

Las páginas

Cada página tiene dos partes que importan:

  1. Resumen. Tres a cinco líneas con lo esencial. Si solo lees esto, ya sabes lo importante.
  2. Cuerpo. El detalle, con secciones, tablas, listas y enlaces [[wiki]] a otras páginas relacionadas.

Bajo el título de la página verás una tira de metadatos breve. Lo que muestra depende del tipo de documento: para un archivo subido o de Drive aparece tipo · origen · fecha de la fuente; para una nota escrita a mano aparece el área y cuándo se actualizó. Para ver el resto de los metadatos usa el botón Detalles (ver más abajo).

Enlaces [[wiki]]

Cuando una página menciona algo que tiene su propia página, queda enlazado con [[doble corchete]]. Por ejemplo, en finanzas/viaticos.md puedes ver:

Los viáticos se rigen por la rrhh/politica-de-viajes vigente.

Haz clic y saltas directamente a esa página. Es lo que mantiene tus documentos como una red, no como una pila de PDFs.

Cuando una página enlaza algo que no existe, el enlace aparece con subrayado ondulado: finanzas/reembolsos-extraordinarios. El Lint lo detecta y lo lista en Calidad como enlace caído.

El visor de un documento

Al abrir un documento que viene de un archivo (PDF, planilla, Word…), no ves una sola pantalla, sino un visor con pestañas. Así puedes leer el resumen que escribió la IA, comparar contra el original y auditar lo que la IA leyó, todo sin salir de la página.

El archivo original, tal cual lo subiste. Es la pestaña que se abre por defecto cuando el documento viene de una fuente. Un PDF se muestra embebido a ancho completo (útil para verificar citas largas sin descargar nada). Una planilla se muestra en un visor de grid: una tabla real por cada hoja, con pestañas para cambiar de hoja.

La página que la IA escribió a partir de ese archivo, la que marcó como el resumen del documento. Al pie aparece el bloque Documentos que enlazan aquí: las otras páginas de tu wiki que apuntan a esta (sus enlaces de entrada).

Los documentos-fuente de esa página, cuando hay más de uno. Sirve para saber de dónde salió la información.

El texto crudo que la IA leyó del archivo, sin formato. Útil para auditar la extracción: si un PDF escaneado o una planilla quedó mal leída, lo notas acá comparando con la pestaña Archivo.

Para una nota escrita a mano (sin archivo de origen) el visor es más simple: solo verás Resumen IA y, si la página cita fuentes, Fuentes.

El botón Detalles

En la cabecera de un documento respaldado por una fuente hay un botón Detalles. Al pulsarlo se abre un panel lateral con los metadatos de la fuente:

  • Tipo (PDF, planilla, documento…)
  • Hojas (cuando es una planilla)
  • Área de destino
  • Origen (subida directa o Google Drive)
  • Estado de la ingesta
  • Fecha en que se procesó

Desde ahí también puedes Descargar original: bajas el archivo exacto que subiste (no la versión que escribió la IA).

El Resumen IA es la interpretación de la IA; la pestaña Archivo y Descargar original te dan la fuente literal. Cuando dudes de una cifra, compara las dos.

Documentos sin incorporar y parciales

No todo lo que subes termina como página de la wiki. En el árbol de Documentos verás dos etiquetas posibles junto a un archivo:

  • Sin incorporar. noxxa revisó el archivo y no encontró información relevante para tu empresa, así que no lo incorporó a ninguna página. El chat no lo usará para responder. Aun así puedes abrirlo: el visor explica por qué se descartó y te deja leer su contenido y el texto extraído.
  • Parcial. Solo se incorporó parte del archivo, normalmente una planilla muy grande que se truncó al pasar de los límites de ingesta. Se lee igual, solo que el resto no entró.

Historial de cambios

Cada página guarda sus versiones. Puedes ver el historial de una página y sus diffs (qué líneas se agregaron o quitaron, quién hizo el cambio y cuándo). Es la forma de auditar cómo evolucionó una página entre ingestas.

AcciónCómo
Ver todas las áreasÁrbol de la izquierda, en la raíz.
Buscar una página por nombreCaja de búsqueda en la barra lateral de Documentos.
Ver de dónde vino un documentoBotón Detalles (cabecera del documento) → campo Origen.
Ver qué otras páginas la enlazanPestaña Resumen IA → bloque Documentos que enlazan aquí.
Ver el archivo original (PDF, planilla, doc)Pestaña Archivo del documento.
Descargar el archivo originalDetallesDescargar original.

Quién puede editar

Casi nadie edita a mano. Tus documentos se mantienen solos a partir de tus fuentes. Si la fuente cambia, la página cambia en la siguiente sincronización.

La excepción son los editores, que pueden ajustar páginas a mano cuando el Lint detecta un conflicto que no se resuelve solo (ver Mantenimiento).

Si una página está mal, lo correcto suele ser arreglar la fuente, no la página. Así tus documentos quedan alineados para siempre, no solo hasta la próxima ingesta.

Cómo entra el contenido

Documentos no es un buzón de subida cualquiera. Lo que ves acá lo escribe la IA a partir de tus fuentes: archivos de Google Drive que eliges con el Picker o archivos que subes directo a un área. Revisa cómo conectarlas en Fuentes. Para preguntarle a tu conocimiento en vez de navegarlo, mira el Chat o el conector MCP.