Neo4j LLM Графавы будувальнік: ад дакументаў да графаў знаёмых, якія можна запытваць

У гэтым керавану практыкуець перадаецца маршрут ад сыр'ёў да рабочай сістэмы для стварэння графаў знаёмых на адной з дасяглібных мов працы Neo4j LLM Graph Builder. Акцэнт ставіцца на практычныя крокі, чыстае перакананне ў правільнасці дзействаў і код, які можна проста падключыць у рэпазітарый, не прабуючы здогадвацца пра намеры. Для агульнага адгледжэння, перш чым зменіць код, неабходна візначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аперацыёныя працавікі должны магчымае перадзеўсці крок з вядомай точкі контролю, не прабуючы здагадвацца пра схованы стан. Конфігурацыю трэба залічыць паза кодам прыкладнага програму. Файлы сераўіса, хранільнікі секрэтных даных і флагі функцый належаць у аднам месца, якое працавікі можуць пераглядаць, не чытаючы весь граф.

Прыямельныя выкананні

Для прабэраліянаў неабходна з’явіць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчыма ўвайсці крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабходна задокументаваць як шлях успеху, так і шлях вяснавання проблем. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней. Ствараюць мадэлі вузлаў і ўзаемнасоёванняў для запытанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакуменце. Рэдкія, тыпаваныя рэшткі лепшыя за ўжоўтучныя, загадковыя графы.

Крок 1: Клонаваць рэпазітарый

Для першага крока: клонавайце рэпазітары, задаце параметры вхідных дадзеных, адміністратара крока і крытэрыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымае перазапускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Валідзіце маленькія, тэставаныя елементы замест амаль неконтрольваных скрыптав. Калі крок не выйшаў, прычына нехасабносты павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Ствараюце мадэлі вузлаў і ўзаінтэрэсаванняў для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Рэдкія, тыпаваныя зв’язкі лепшыя за ўжо заплутаныя графы.

git clone https://github.com/neo4j-labs/llm-graph-builder.git
cd llm-graph-builder

Крок 2: Канфігуруйце і запускайце бэкенд

Для 2-го крока: налаштавання і запуск бэкенду — паказвайце вхідныя даны, адміністратара крока і крэтырыя для завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце цэму этапу як кантракту межа вхіднымі данымі і паверканымі выходнымі рэзультатамі. Даўце назвы артыфактам, паказвайце крэтырыя успеху і адмовіцеся ад беззвучнага частковага завершэння. Стварайце мадэлі вузлаў і ўзаінтэрэсаванняў для запытанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, тыпаваныя рэшткі лепшыя за ўжоўтучаныя, загадковыя графы. Для 2-го крока: налаштавання і запуск бэкенду — паказвайце вхідныя даны, адміністратара крока і крэтырыя для завершэння пры перадзмене коду. Аперацыйныя працавнікі должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Зберагайце налаштаванні за межамі коду прыемленае. Файлы сераў, хранільнікі секрэтных дадзенняў і флагі функцый должны знаходзіцца ў аднам месцы, якое працавнікі можуць пераглядаць без змян.

Чытанне всіх дадзеных графа.

cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

NEO4J_URI = "bolt://<hostname>:7687"
NEO4J_USERNAME = "neo4j"
NEO4J_PASSWORD = "<password>"
NEO4J_DATABASE = "neo4j"

LLM_MODEL_CONFIG_META_LLAMA3_1_8B="meta-llama/Meta-Llama-3.1-8B-Instruct,http://<hostname>:<port>/fast/v1,<API_KEY>"
LLM_MODEL_CONFIG_GEMINI_2_5_FLASH="gemini-2.5-flash"

TRACK_USER_USAGE="false"

Шаг 3: Налаштаванне і запуск фронтэнда

Для шага 3: Налаштаванне і запуск фронтэнда неабяжна пазначыць параметры вводу, адпаведнага адпаведальніка за шаг і крэтыяры завершэння прычынамі перад зменыма коду. Аператары должны магчымаць перзапуск шага з вядомай точкі контролю без неабяжнага вычыслення схованых станоў. Неабяжна задокументаваць шлях успеху і шлях вярнення. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Ўжывайце обмежэнняі і індэксы пры масовай абрабоце. Унікальнасць па бізнес-клучох прыводзіць да таго, што пасляднія з’едынэння стаюць прыведамымі апдэйтамі, а не супернаводамі.

cd frontend
sudo apt update && sudo apt install yarn -y

VITE_BACKEND_API_URL="https://backendgb.datamindslab.in"
VITE_LLM_MODELS="gemini_2.5_flash,meta_llama3_1_8b,diffbot,openai_gpt_5.4_mini,gemini_3.5_flash,anthropic_claude_4.5_haiku"
VITE_FRONTEND_HOSTNAME="https://graphbuilder.datamindslab.in"

yarn run dev

Шаг 4: Падключэнне базы дадзеных і кранты на LLM

Для крока 4: «З’яўленне звязку з базай дадзеных і крантэдынтаў LLM», перш чым зменіць код, неабходна задаць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння. Аператары должны магчымае перзапускіць крок з вядомай точкі контролю, не прабуючы спадарацца прыватны стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптаў. Калі крок не выйшоў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны працэс. Ўжывайце обмежэння і індэксы пры масовай абрабоце. Унікальнасць бізнес-клучоў дапамагае ператварыць пазнейшыя з’еднання на прывідныя апэратыўныя дзеяння, а не на сітуацію з дуплікатамі.

Крок 5: Абрабоцкае прыкладнага дакумента і стварэнне графа

Для 5-го крока: «Прыняць прыклад дакумента і стварыць граф», перад змянайом кода неабходна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю без адгадвання захаванага стану. Спрэцьваўце гэты этап як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, узначыце перакананні успеху і адмовіцеся ад бяспечнага частковага завершэння. Ўжывайце обмежэнні і індэксы перад масовым прыняцьцем. Унікальнасць па бізнес-клучох прыводзіць да таго, што пазнейшыя з’еднання стаюць прыведамымі апдэйтамі, а не спрама дуплікатаў. Для 5-го крока: «Прыняць прыклад дакумента і стварыць граф», перад змянайом кода неабходна ўзначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю без адгадвання захаванага стану. Зберагачыце настройкі праза код аплікацыі. Файлы сераўнавання, храненні секрэтных дадзенаў і флагі функцый должны знаходзіцца ў аднам месцы.

Аператары магчымостэй можаць аўдытаваць, не чытаючы весь граф.

Тэкст прыкладнага дакумента

Для тэксту прыкладнага дакумента неабяжна пазначыць вхідныя даны, адпаведальнага за крок і крытэрыі завершэння пры змяне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Пасля першай партыі неабяжна адзірнуць прыкладны район. Засобы тыпу Cypher дапамагаюць выявіць змены атрыбутаў і ўтрату властывасцей дышэўна, чым тэсты на весь працэс.

Этапы апрацоўкі

Для крокаў апрацоўкі неабходна пазначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння пры перадзеі коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптаў. Калі крок не выконваецца, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Пасля першай партыі дадзеных неабходна адразу пераглянуць прыкладны кантэкст. Інструменты тыпу Cypher працююць дарожэй за тэсты чату з початку да канца для выяўлення змін у атрыбутах і ўтраты дадзеных.

Nodes (Entities):        538
Relationships (Edges):   1541

SiteScope
OBM
URL Monitor
CPU Monitor
Windows Server
Database
Service
Alert
Threshold

SiteScope --MONITORS--> Windows Server
SiteScope --CONNECTS_TO--> OBM
CPU Monitor --GENERATES--> Alert
Database --HOSTS--> SiteScope

Ёснасц графа — Корыстны паказнік ёснасці:

Для показніка ўтрамбованасці графа — корыстным паметнікам ёсць: неабходна прадзефінавацыя вхідных дадзеных, адпаведальнага за выкананне крока і крэтарыяў завершэння працы перад змінайом коду. Аператары должны магчымае перадзягнуць выкананне крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Спрыяйце цэму этапу як даговору межа вхіднымі дадзенымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, прадзефінавацыя крэтарыяў успеху і адмовіцеся ад беззвучнага частковага завершэння. Адразу пасля першай партыі неабходна абстракцыйна пераглянуць суседзяўскі раён. Засобы тыпу Cypher дапамагаюць выявіць змены атрыбутаў і ўтрату властывасцей дышэўна, чым тэсты на весь працэс чату.

1541 relationships / 538 nodes
≈ 2.86 relationships per node

Для показніка ўшчэльненасці графа — корыстным паметнікам ёсць: неабходна з’явіць вхідныя даны, адпаведальнага за выкананне кроку і крытэрыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчыма ўвайсці крок з вядомага пункту перапытку, не спрабоўваючы здогадвацца пра схованы стан. Конфігурацыю трэба залічыць паза кодам прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцый крануцца на аднай пазычце, якую працавнікі можуць пераглядаць, не чытаючы весь граф.

Іспользованне токенаў

Для выкарыстоўвання токенаў неабходна перад змянай коду задаць параметры вхідных даных, абяўальніка крока і крытэрыяы завершэння. Аперацыйныя працавнікі должны магчымае запускаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Неабходна аддзеўнаваць дакументацыю як па шляху успеху, так і па шляху вяснавання проблем. Перапрыбуткі, людзкія перакрыцця і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней. Ствараюць мадэлі вузлаў і ўзаемнасоёваў для запытанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакуменце. Рэдкія, тыпаваныя рэшткі лепшыя за ўжоўташнелыя, незрозумелыя графы.

422,085 tokens

422,085 tokens
≈ 300,000–350,000 words
≈ 800–1200 pages of processed content

Спытанні, з якімі сталося

Для супакоўкі, з якімі сталкаецца працэваўнік, пярш чым зменяць код, неабходна адзначыць вхідныя даны, адпаведальнага за практыку і крэтарыя выходу. Аператары должны магчымае перзапускаць практыку з вядомага пункта контролю, не спадзяючыся на заштыраны стан. Лепей выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі практыка не выйшла, прычына нехацкага рэзультата должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Мадэлюйце вузлы і зв’язкі для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, тыпаваныя зв’язкі лепшыя за заплутаныя графы.

Сумаспадобнасць з Neo4j APOC

Для сумяжнасці з Neo4j APOC неабяжна ўскладніць вхідныя даны, адпаведальную за крок адказнасць і крытэрыя завершэння пры зміне коду. Аперацыйныя працавнікі павінны магчымае перайсці крок з вядомага пункта контролю без неабяжніць у з’ясаванні схованага стану. Спрэцыявайце гэты этап як кантракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, ускладніць перакананне ў успеху і адмовіцеся ад тых варыянтаў, калі задача выканана часткова без паведамлення пра гэта. Стварайце мадэлі вузлаў і зв’язкаў для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Рыхлыя, тыпаваныя рэбры лепшыя за ўжоўтучныя, незрозумелыя графы. Для сумяжнасці з Neo4j APOC неабяжна ўскладніць вхідныя даны, адпаведальную за крок адказнасць і крытэрыя завершэння пры зміне коду. Аперацыйныя працавнікі павінны магчымае перайсці крок з вядомага пункта контролю без неабяжніць у з’ясаванні схованага стану. Зберагайце настройкі праза код аплікацыі. Файлы сераў, хранільнікі секрэтных дадзенняў і флагі функцый павінны знаходзіцца ў аднам месцы, якое працавнікі можуць пераглядаць, не чытаючы весь граф.

Проблемы з SSL-сертыфікатамі

Пры проблемах з SSL-сертыфікатамі неабяжна пазначыць параметры вхідных дадзеных, адпаведальнага за выкананне крока і крытэрыі завершэння пры змяне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарацца прыватны стан процэсу. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, перакрыцця ад чалавека і апрацоўка непрацюючых паведамленняў ёсць часткай продукту, а не элементамі, якія дадзены пазней. Перад масовым запоўненням неабяжна выкарыстоўваць обмежэння і індэксы. Унікальнасць бізнес-клучоў дапамагае ператвараць пазнейшыя з’еднання дадзеных у прагнозавальныя операцыі адправкі/змяны дадзеных, а не у сітуацыі з дуплікатамі.

Автанацыя ў Google Gemini

Для аутантыкаціі Google Gemini неабяжна практычна адзначыць вхідныя даны, адпаведальнага за крок і крытэрыі завершэння пры перадзеяванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы схованы стан.

Управлінець рэсурсамі

Для управлінця рэсурсамі неабяжна практычна адзначыць вхідныя даны, адпаведальнага за крок і крытэрыі завершэння пры перадзеяванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы схованы стан.

Вывад

Чэк-ліст для аператыўнай працы