Граф знаний

Граф знаний хранит структурированные связи между сущностями в вашем проекте. В отличие от плоских записей, он фиксирует, как вещи связаны — какие сервисы от чего зависят, кому какие компоненты принадлежат и как развиваются архитектурные решения.

Основные концепции

Факты (триплеты)

Каждая связь — это триплет субъект - предикат - объект.

Достоверность

Каждый факт имеет оценку достоверности (0-1). Факты с высокой достоверностью — установленные истины; более низкие оценки указывают на предположения или ранние решения, которые могут измениться.

Временная действительность

Факты могут быть инвалидированы без удаления. Временная линия сохраняет историю — вы можете видеть, что было истинным в каждый момент, а не только что истинно сейчас.

Примеры использования

Добавление фактов

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

Запрос связей

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

Просмотр временной линии

# 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

Сценарии использования

Картирование архитектуры

Отслеживайте, какие сервисы используют какие технологии, как компоненты связаны и что от чего зависит.

История решений

Фиксируйте, почему были приняты решения и как они развивались. Больше не нужно обсуждать уже принятые решения.

Ответственность команды

Определяйте, кому какие модули, сервисы и области принадлежат. Полезно для больших кодовых баз.

Отслеживание зависимостей

Понимайте последствия до внесения изменений. Запрашивайте, что зависит от компонента, прежде чем его модифицировать.

API-эндпоинты

Граф знаний имеет 5 выделенных инструментов и соответствующих REST-эндпоинтов. Подробности запросов и ответов см. в полном справочнике API. REST API →

  • kg_add — Добавить факт (субъект - предикат - объект)
  • kg_query — Запросить связи сущностей
  • kg_invalidate — Отметить факт как более неактуальный
  • kg_timeline — Просмотр истории фактов для сущности
  • kg_stats — Статистика графа (количество сущностей, фактов)