Описание структуры сети

* Обычно сложные структуры нейронного графа описывают в удобном и наглядном графическом ИДЕ Socratis.Studio. Однако здесь мы рассмотрим форматы команд, которыми описывать и изменять структуру GNN практически с нуля.

Примечание: Все скриптовые команды не необходимо использовать префиксом GNN

1. Форматы базовых элементов

1.1. Формат Узла (Node)

Синтаксис: ( [Schema :] Name [ { key=val; flag } ] )

Узел определяется в круглых скобках. Схема и свойства опциональны. Если схема не указана, используется Global. Строковые значения свойств могут заключаться в кавычки (обязательно, если внутри есть пробелы). Наличие ключа без значения (flag) интерпретируется как flag=”true”.

Пример синтаксиса Описание
(Andrey) Узел с именем Andrey в схеме по умолчанию.
(User:Andrey) Узел Andrey в схеме User.
(DSL:Topic:Science) Многоуровневая (иерархическая) схема DSL:Topic.
(File:Log {size=10; readonly}) Узел со свойствами. size равен “10”, readonly равен “true”.

 

1.2. Формат Ребра (Edge)

Синтаксис: -[ Tag1, Tag2 [ { key=val; flag } ] ]->

Ребро определяется в квадратных скобках между дефисом и стрелкой. Ребро может содержать один или несколько тегов (разделенных запятой) и опциональный словарь свойств.

Пример синтаксиса Описание
-[likes]-> Простая связь с одним тегом likes.
-[uses, depends]-> Мульти-теговая связь (ребро принадлежит сразу двум категориям).
-[route {dist=50; active}]-> Связь с тегом route и параметрами маршрута.

 

1.3. Ребра графа как синапсы ГНС

В Socrates ребра графа являются «трубопроводами» – синапсами проведения сообщений, имеющими некоторые обязательные свойства:

_weight — вес (проводимость) связи

_importance — важность связи

_protection — защита связи от удаления механизмом самообучения (минимальный вес != 0)

На кодовом уровне (C#; C#-script) синапсы имеют следующие важные свойства, дублирующие описанные выше:

float Weight

float Protection

int Importance

object PropertyBag(string propName, string retType = “string”, object defaultValue = null, bool ignoreCase = false) – получение значения свойства с преобразованием типа

PropertySet(string propName, object value) — установка значения свойства

RemoveProperty(string key) — удаление свойства

 

1.4. Процессуальные типы синапсов (ребер графа)

С точки зрения активности нейронов в Зоне Внимания существует четыре типа синапсов:

Normal — обычные синапсы для передачи сообщений

Struct — структурные связи не передающие сообщения, описывают формальные отношения

Reflex — рефлексные синапсы (сильные). Моментально вызывают отклик нейрона.

Brake — анти-рефлексные синапсы. Моментально гасят нейрон в активной зоне.

 

2. API Поиска Узлов (FindNodes и FindNodesLogical)

Методы поиска принимают внутреннее содержимое скобок узла (без самих круглых скобок). Поддерживаются маски (Wildcards) * (любая строка) и ? (любой символ). Метод FindNodes использует сверхбыстрые индексы БД.

Запрос в API Результат (что найдет)
FindNodes(“*”) Возвращает абсолютно все узлы графа.
FindNodes(“User:*”) Все узлы, принадлежащие схеме User.
FindNodes(“*:Admin”) Узлы с именем Admin в любой схеме графа.
FindNodes(“DSL:*:*”) Все узлы, схема которых начинается на DSL:.
FindNodes(“* {active; error=404}”) Пересечение свойств: любые узлы, где есть флаг active и свойство error равно 404.
`FindNodes(“User:A*

 

2.1. Двухуровневый логический поиск

Для сложных математических и логических проверок используется метод FindNodesLogical с оператором WHERE.

Логика работы: до WHERE выполняется быстрый индексный поиск. После WHERE вызывается скриптовый C#-интерпретатор для отобранных кандидатов.

 

2.2. Семантический просмотр свойств при поиске Like

Вы можете комбинировать строгие фильтры и “размытый” нейросетевой поиск в одном запросе.

Примеры:

  1. Простой семантический фильтр:
"Item:* WHERE Like('красный фрукт', 0.85)"

(Найдутся все узлы, чье описание похоже на “красный фрукт” с точностью 85%)

  1. Комбинированный запрос (Цена + Смысл):
"Product:* {category=smartphones} WHERE Price < 50000 && Like('мощная камера и хороший экран', 75)"

(Здесь сначала сработает индекс по категории, потом отсеется цена, и только для оставшихся вызовется Like)

  1. Использование переменных движка:
"Event:* WHERE Like(@SearchTopic, @MinScore)"

 

2.3. Встроенные переменные узла доступные в FindNodesLogical

_Id – ид узла

_Text – имя (текст)

_description – смысловое описание, на основе которого выбирается узел

_Schema – вся схема узла

_SchemaLeft – левая часть схемы (к какому множеству относится)

_SchemaRight – правая часть схемы (тип нейрона)

_Degree – общее число связей узла

_DegreeIn – число входящих связей узла

_DegreeOut – число исходящих связей узла

 

2.4. Использование общих функций языка в поиске

В правой части логического выражения при тестировании свойств может стоять любая функция языка:

Sensor:* WHERE _trigger >= fynctionName(…)

 

3. API Навигации и Траверсирования (ExecuteQuery)

Метод используется для поиска узлов на основе их связей. Возвращает список целевых узлов (Target), удовлетворяющих паттерну. Поддерживает маски * во всех трех блоках (Источник, Ребро, Цель).

Синтаксис: (SourceFilter) -[EdgeFilter]-> (TargetFilter)

Запрос в API Описание
ExecuteQuery(“(User:Andrey) -[likes]-> (*)”) Что любит Андрей? Вернет все узлы, на которые у Андрея есть связь likes.
ExecuteQuery(“(*) -[depends]-> (Server:DB)”) Кто зависит от БД? Вернет все узлы, ссылающиеся на Server:DB связью depends.
ExecuteQuery(“(User:*) -[friend {close}]-> (*:Admin)”) Кто близкий друг админов? Вернет узлы, проходящие через ребро со свойством close.
`ExecuteQuery(“(Dog:*) -[likes

 

4. API Создания и Модификации Графа

Эти методы интерпретируют DSL не как фильтр, а как инструкцию к созданию (Create/Update).

4.1. Создание Цепочек (ExecuteCommand)

Если узел не существует, он будет создан. Если существует — его свойства будут слиты с новыми, а недостающие связи добавлены.

Пакетная команда Описание действий парсера
(User:Ivan) Создаст узел Ivan в схеме User.
(User:Ivan) -[friend]-> (User:Petr) Создаст обоих пользователей (если их нет) и проложит ребро от Ивана к Петру.
(A) -[x]-> (B) -[y]-> (C) Цепное создание: создаст три узла и последовательно свяжет их (А ссылается на B, B ссылается на C).
(Dog:Sharik {hungry}) -[bites {force=10}]-> (Cat:Barsik) Создаст узлы со свойствами и ребро с параметрами силы укуса.

 

4.2. Инстанцирование / Наследование (ExecuteCommand)

Ключевое слово NEW: и оператор FROM позволяют создать клон узла-шаблона со всеми его свойствами и исходящими связями.

Команда Описание
NEW: (Dog:Sharik) FROM (Template:Dog) Создает узел Dog:Sharik. Копирует в него все переменные из Template:Dog и дублирует все исходящие связи шаблона.
NEW: (Dog:Sharik {color=”Black”}) FROM (Template:Dog) Создает инстанс, но переопределяет или добавляет собственное свойство color.

 

4.3. Радикальное обновление состояния (ReplaceNodeFullState)

Используется, когда агенту нужно полностью “сменить контекст” (забыть старое, выучить новое).

В отличие от ExecuteCommand (который дополняет свойства), этот метод:

  1. Очищает все текущие свойства корневого узла.
  2. Удаляет все его исходящие связи.
  3. Применяет новые свойства и связи из переданной команды.
Команда Описание
ReplaceNodeFullState(“(State:AI {status=idle})”) Узел State:AI теряет старые переменные, получает status=idle и лишается всех исходящих связей. Входящие связи сохраняются.
ReplaceNodeFullState(“(Task:1 {done}) -[next]-> (Task:2)”) Задача 1 очищается от старых связей и свойств, помечается как done и прокладывает единственную новую связь к Задаче 2.
  • Поиск синапсов нейрона (ребер узла графа)
  • GetOutgoingEdges(int nodeId) — исходящие связи (от кого-то к другим)
  • GetIncomingEdges(int nodeId) — входящие связи (кто ссылается на этот узел)
  • GetAllEdges(int nodeId) — вообще все связи узла

Синтаксис в скрипте (например):

GNN.GetOutgoingEdges( nodeId);
C#:
MainEngine.Instance.GetOutgoingEdges( nodeId);

 

5. Группы

Цель — уменьшить количество ребер, сохранить читаемость топологии и обеспечить удобную работу и обычных запросов, и механизмов распространения активации в графе.

В том числе автоматическое наследование свойств Паттернов и режимы коллективного взаимодействия.

Рассматриваются три практических способа: многократные однотипные строки в скрипте, паттерн «Хаб» (промежуточный узел группа) и генерация связей через программный цикл API.

 

6. Веер связей и паттерн «Хаб»

Прямой веер задается многострочным объявлением: одна и та же левая часть (A) повторяется, а правая (B1), (B2) и т.д. меняется, каждая связь описывается отдельной строкой с тем же типом ребра (например, manages). Для больших групп используется паттерн «Хаб»: создается узел группа (например, (Group:ProductionServers)), к нему подсоединяется управляющий узел через ребро manages, а все элементы группы (серверы) объявляют принадлежность через ребра Is-A. Тогда веер реализуется через два прыжка в запросах или в модели активации: A -[manages]-> Group и далее Server -*[Is-A]-> Group, что резко снижает число прямых связей «A→каждый Bi» и упрощает наследование общих свойств от узла группы.

Существует 3 базовых стандарта системных связей:

  • Наследование (Type-Of / Inheritance)

Тег: _IsA

Направление: От Экземпляра/Наследника → К Шаблону/Родителю.

Смысл: Глубокая онтологическая связь. Указывает, что дочерний узел является конкретной реализацией родительского. Движок ГНС использует эту связь для “Сборки ДНК” — автоматического подтягивания свойств Variables от родителя к ребенку при активации.

Пример:

(Dog:Sharik) -[_IsA]-> (Template:Dog)

(Шарик наследует инстинкты и промпт концепта Собаки).

 

  • Групповое членство (Membership / Fan-out)

Тег: _InGroup

Направление: От Элемента → К Узлу-Группе.

Смысл: Организационная связь. Элементы могут входить в сотни разных групп. Свойства группы не наследуются напрямую как инстинкты, но применяются как внешние правила (политики). Это позволяет делать массовые рассылки (Широковещание).

Пример:

(Server:Alpha) -[_InGroup]-> (Cluster:Production)

(User:Andrey) -[_InGroup {role="admin"}]-> (Department:IT)

(Обратите внимание: мы используем свойства ребра {role=”admin”}, чтобы уточнить, кем именно элемент является в этой группе).

 

  • Композиция / Часть целого (Part-Of)

Тег: _PartOf

Направление: От Части → К Целому.

Смысл: Жесткая физическая или логическая вложенность. Если удаляется Целое, движок должен (по логике сборки мусора) удалить и Части.

Пример:

(Component:Engine) -[_PartOf]-> (Car:BMW)

(Concept:Wheel) -[_PartOf]-> (Concept:Car)
  • Команды работ с группами

Получить все узлы, входящие в указанную группу.

(Ищет все входящие ребра _InGroup к узлу группы)

IEnumerable<Node> GetGroupMembers(this SimpleGraphDb db, int groupId)

 

Узнать, в каких группах состоит указанный узел.

(Ищет все исходящие ребра _InGroup от элемента)

IEnumerable<Node> GetNodeGroups(this SimpleGraphDb db, int nodeId)

 

Быстрое добавление узла в группу с возможностью указать роль (например: role=”admin”).

AddToGroup(this SimpleGraphDb db, int memberId, int groupId, Dictionary<string, string> edgeProps = null)

 

Быстрое удаление узла из группы.

RemoveFromGroup(this SimpleGraphDb db, int memberId, int groupId)

 

Собирает ВСЕХ предков узла вверх по графу (Genetic Tree), учитывая множественное наследование.

Используется перед вызовом LLM для сборки полного промпта свойств.

name=”childNodeId”>ID узла-наследника

“limit”>Ограничитель: число (int – максимальная глубина) ИЛИ строка (имя или Схема:Имя целевого предка)

Список уникальных предков, отсортированный по степени близости (от родителей к прадедам)

List<Node> GetGeneticChain(this SimpleGraphDb db, int childNodeId, object limit = null)