Graphe de connaissances

Le graphe de connaissances stocke les relations structurées entre les entités de votre projet. Contrairement aux mémoires plates, il capture la façon dont les choses se connectent — quels services dépendent de quoi, qui possède quels composants et comment les décisions d'architecture évoluent.

Concepts fondamentaux

Faits (triplets)

Chaque relation est un triplet sujet - prédicat - objet.

Confiance

Chaque fait a un score de confiance (0-1). Les faits à haute confiance sont des vérités établies ; les scores plus bas indiquent des hypothèses ou des décisions précoces susceptibles de changer.

Validité temporelle

Les faits peuvent être invalidés sans suppression. La chronologie préserve l'historique — vous pouvez voir ce qui était vrai à quel moment, pas seulement ce qui est vrai maintenant.

Exemples d'utilisation

Ajout de faits

# 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"

Interrogation des relations

# 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)

Consultation de la chronologie

# 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

Cas d'utilisation

Cartographie de l'architecture

Suivez quels services utilisent quelles technologies, comment les composants se connectent et quelles sont les dépendances.

Historique des décisions

Enregistrez pourquoi les choix ont été faits et comment ils ont évolué. Plus jamais de redébat sur une décision réglée.

Responsabilité d'équipe

Cartographiez qui possède quels modules, services et domaines. Utile pour les grandes bases de code.

Suivi des dépendances

Comprenez l'impact avant de faire des modifications. Interrogez ce qui dépend d'un composant avant de le modifier.

Endpoints API

Le graphe de connaissances dispose de 5 outils dédiés et des endpoints REST correspondants. Consultez la référence API complète pour les détails des requêtes/réponses. API REST →

  • kg_add — Ajouter un fait (sujet - prédicat - objet)
  • kg_query — Interroger les relations entre entités
  • kg_invalidate — Marquer un fait comme n'étant plus vrai
  • kg_timeline — Voir l'historique des faits pour une entité
  • kg_stats — Statistiques du graphe (nombre d'entités, nombre de faits)