Grafo de Conocimiento

El grafo de conocimiento almacena relaciones estructuradas entre entidades en su proyecto. A diferencia de las memorias planas, captura cómo se conectan las cosas — qué servicios dependen de qué, quién es dueño de qué componentes y cómo evolucionan las decisiones de arquitectura.

Conceptos fundamentales

Hechos (tripletas)

Cada relación es una tripleta sujeto - predicado - objeto.

Confianza

Cada hecho tiene una puntuación de confianza (0-1). Los hechos de alta confianza son verdades establecidas; las puntuaciones más bajas indican suposiciones o decisiones tempranas que pueden cambiar.

Validez temporal

Los hechos se pueden invalidar sin eliminarlos. La línea de tiempo preserva el historial — puede ver qué era verdadero cuándo, no solo qué es verdadero ahora.

Ejemplo de uso

Agregar hechos

# Record architecture decisions as facts

kg_add

subject: "backend"

predicate: "uses"

object: "PostgreSQL"

confidence: 0.95

# Track ownership

kg_add

subject: "auth-module"

predicate: "owned-by"

object: "backend-team"

Consultar relaciones

# What does the backend use?

kg_query

entity: "backend"

direction: "outgoing"

> backend uses PostgreSQL (0.95)

> backend uses Express (0.90)

> backend deployed-on Docker (0.95)

Ver línea de tiempo

# See how decisions evolved

kg_timeline

entity: "database"

> 2026-03-01 database considered MongoDB

> 2026-03-05 database decided PostgreSQL

> 2026-03-01 MongoDB consideration invalidated

Casos de uso

Mapeo de arquitectura

Registre qué servicios usan qué tecnologías, cómo se conectan los componentes y qué depende de qué.

Historial de decisiones

Registre por qué se tomaron las decisiones y cómo evolucionaron. Nunca vuelva a debatir una decisión ya tomada.

Propiedad del equipo

Mapee quién es dueño de qué módulos, servicios y dominios. Útil para bases de código grandes.

Seguimiento de dependencias

Comprenda el impacto antes de hacer cambios. Consulte qué depende de un componente antes de modificarlo.

Endpoints de API

El grafo de conocimiento tiene 5 herramientas dedicadas y endpoints REST correspondientes. Consulte la referencia completa de API para detalles de solicitud/respuesta. REST API →

  • kg_add — Agregar un hecho (sujeto - predicado - objeto)
  • kg_query — Consultar relaciones entre entidades
  • kg_invalidate — Marcar un hecho como ya no verdadero
  • kg_timeline — Ver historial de hechos de una entidad
  • kg_stats — Estadísticas del grafo (conteo de entidades, conteo de hechos)