Conocimiento del workspace

Knowledge es una biblioteca por workspace de lo que tu equipo sabe. Lee tus páginas publicadas y destila cada una en una nota markdown corta — hechos clave, números, temas y nombres que un compañero querría — para que el conocimiento repartido en cientos de páginas sea algo que podés recorrer y buscar en un solo lugar.

Está opt-in y apagado por defecto. Un workspace sin Knowledge funciona igual que antes. Cuando lo activás, ShareOut aprende de tus páginas en segundo plano y mantiene la biblioteca al día mientras publicás. Cada nota enlaza a las páginas de las que se aprendió, así podés rastrear cualquier dato hasta su fuente.

Knowledge es visible solo para miembros del workspace y solo aprende de las páginas de tu propio workspace.

Knowledge requiere un plan pago (Pro, Teams o Enterprise). Los workspaces free ven un prompt de upgrade; activarlo o ejecutar Learn from existing pages devuelve 403 UPGRADE_REQUIRED sin gastar créditos de IA.

Activarlo

Abrí un workspace y elegí Knowledge en la navegación izquierda. Un owner o admin ve el botón Turn on knowledge. Los miembros sin permisos de admin ven una nota pidiendo que un admin lo active.

Una vez activo, el lens está vacío hasta que se aprendan páginas. Tenés dos formas de llenarlo:

Learn from existing pages — un owner o admin puede encolar tus páginas recientes en un clic. Toma hasta las 200 páginas live más recientes; una barra de progreso sigue la corrida acotada on-demand y el resto drena en el cron horario. Devuelve { "queued": 0 } cuando todo ya está al día.
Let it grow — cada página que publiques de ahora en adelante se aprende automáticamente.

POST /v1/workspaces/{workspaceId}/knowledge/enable
Authorization: Bearer {token}
Content-Type: application/json

{ "enabled": true }

POST /v1/workspaces/{workspaceId}/knowledge/backfill
Authorization: Bearer {token}

Cómo funciona el aprendizaje

El aprendizaje corre en segundo plano en un ciclo horario:

Publicás una página. La página se encola para aprender. La cola es consciente del contenido — editar y re-publicar la misma página muchas veces en una mañana sigue dando una sola tarea, y re-publicar contenido idéntico no re-aprende.
El learner la digiere, usualmente dentro de la hora. En cada ciclo horario lee el texto, nombre, descripción y tags de la página, y escribe una nota digest con título, temas, entidades nombradas y unas frases de hechos concretos. Procesa un número limitado de páginas por workspace por ciclo, así un backfill grande puede tomar varios ciclos.
El digest se indexa para búsqueda. Cada nota se embebe para que los agentes la encuentren por significado, no solo por palabras exactas.

Se omiten páginas no aprobadas por moderación y páginas olvidadas.

Consolidación nocturna

Después de los digests, un consolidador nocturno los fusiona en notas más ricas:

Overview (index.md) — tronco auto-escrito que resume cuántas páginas se aprendieron y los temas principales.
Páginas de tema — hechos agrupados por asunto bajo topics/.
Páginas de entidad — clientes, productos y personas bajo entities/ (con dedup de alias para que “Acme” y “Acme Corp” colapsen).

El consolidador reutiliza los mismos límites y tombstones que el learner — las notas editadas a mano o fijadas nunca se sobrescriben.

Guidance (reglas de casa)

La rama Guidance en el árbol de Knowledge guarda los archivos de contexto manual del equipo — voz, estilo, convenciones — el mismo markdown que antes vivía en Admin → Intelligence. Los miembros leen; los admins escriben. El asistente del workspace y /v1/skill inyectan el archivo guidance de entrada como contexto ambiental.

Gestioná Guidance desde el lens Knowledge (no hay pestaña admin separada). Las rutas REST siguen en /v1/workspaces/{id}/context* — ver Workspaces → archivos de contexto.

Tus controles

Seguís al mando de la biblioteca. En la vista de detalle de cualquier nota podés:

Edit — reescribir una nota a mano. Una nota que editás queda marcada como tuya y el learner nunca la sobrescribe.
Pin — marcar una nota para conservar. Fijar sigue el mismo camino “es tuya” que editar, así una nota fijada no cambia sola.
Forget (owner/admin) — eliminar una nota. Olvidar también evita que esa página se re-aprenda.

Qué contiene

Knowledge es un árbol pequeño de archivos markdown, un archivo por nota. El frontmatter YAML guarda los metadatos; el cuerpo son notas planas. Cada nota lleva las páginas de origen en sources.

El árbol se organiza por kind de nota:

Kind	Qué es
`overview`	El tronco (`index.md`) — resumen auto-escrito de cuántas páginas se aprendieron y los temas más comunes
`artifact-digest`	Un digest por página, bajo `artifacts/` — las hojas que escribe el learner automáticamente
`topic`	Una página de tema bajo `topics/`
`entity`	Un cliente, persona, producto o sistema bajo `entities/`
`decision`	Un registro de “decidimos X porque Y”
`timeline`	Qué pasó en un período

Hoy el learner escribe los digests por página; el consolidador mantiene overview, topics y entities. Las notas decision y timeline son parte del mismo árbol y podés escribirlas vos o un agente por el control de edición o la API. Los archivos Guidance son solo manuales.

Navegar Knowledge

El lens Knowledge abre en vista árbol por defecto — ramas indentadas para Overview, Topics, Entities, Pages (digests), Decisions y Guidance. Elegí un nodo para leerlo en el panel de detalle. Cambiá a Table para la lista densa ordenable (franja KPI, búsqueda, filtro por kind).

Vista árbol — escaneá jerarquía, badges de frescura y marcadores de fijado de un vistazo. Guidance vive en su propia rama.
Vista tabla — franja KPI (páginas aprendidas, temas, entidades, última actualización), búsqueda, filtro por kind y filas ordenables.
Detalle de nota — metadatos, cuerpo destilado y Sources (clic para abrir la página). Una línea de frescura (“Learned 3 days ago”) muestra qué tan actual es.

Learn from existing pages muestra una barra de progreso mientras corre el distill on-demand (GET /knowledge/status — queued, processed, total, running). Los backfills grandes pueden seguir en el cron horario después de que termine la barra.

Deep links

Marcá o compartí una vista de Knowledge desde Home:

Hash	Abre
`#l/knowledge`	Lista de Knowledge
`#l/knowledge/{path}`	Una nota específica (ej. `#l/knowledge/artifacts/art_5d2e74a1.md`)

Para agentes

Con Knowledge activo, el asistente del workspace puede consultarlo en lugar de re-leer cada página. Tiene dos tools de solo lectura:

knowledge_search — buscar lo que el workspace sabe por tema, cliente, persona o pregunta.
knowledge_get — leer una nota completa, con cuerpo destilado y páginas fuente.

Ambas tools funcionan solo dentro de un workspace (no en tu espacio Personal) y devuelven { "enabled": false } cuando Knowledge está apagado.

API REST

Los tokens de servicio y los miembros pueden leer y hacer crecer la biblioteca por REST. Todas las rutas requieren membresía del workspace.

Method	Endpoint	Quién	Propósito
`GET`	`/v1/workspaces/{id}/knowledge`	Member+	Settings + counts
`GET`	`/v1/workspaces/{id}/knowledge/status`	Member+	Progreso de entrenamiento (ventana 24h)
`GET`	`/v1/workspaces/{id}/knowledge/tree`	Member+	Resúmenes agrupados por kind
`GET`	`/v1/workspaces/{id}/knowledge/files/{path}`	Member+	Una nota — cuerpo markdown + sources
`PUT`	`/v1/workspaces/{id}/knowledge/files/{path}`	Member+	Reemplazar markdown; marca como editada a mano
`DELETE`	`/v1/workspaces/{id}/knowledge/files/{path}?forget=1`	Admin+	Eliminar nota; `forget=1` evita re-aprendizaje
`POST`	`/v1/workspaces/{id}/knowledge/enable`	Admin+	Activar/desactivar (plan pago para activar)
`POST`	`/v1/workspaces/{id}/knowledge/backfill`	Admin+	Encolar hasta 200 páginas; `{ queued, kicked }` (plan pago)

Privacidad y alcance

Solo miembros. La biblioteca Knowledge es visible para miembros del workspace. Los sharees externos no ven Knowledge.
Solo tus páginas. Las notas se derivan de las páginas publicadas de tu workspace.
Opt-in. Knowledge está apagado hasta que un owner o admin lo active.