Головна / Статті / За межами бенчмарку 71x: графи знань для агентів-програмістів : Graphify та

За межами бенчмарку 71x: графи знань для агентів-програмістів : Graphify та

Покрокове керівництво з використанням Beyond the 71x Benchmark: Knowledge Graphs для кодувальних агентів, а також Graphify та інструменти для створення контрактів, перевірок та готових блоків коду для команд, які впроваджують цю модель.

2315 слів

Наступні примітки описують практичний підхід до роботи з темою «Навички роботи з графами знань для Claude Code та Codex: Graphify та Rivals у порівнянні». Основна увага приділяється контрактам, перевіркам та шаблонам коду, які можна легко вставити, а не мотиваційним аспектам.

Зовсім пропустіть гонку за кількістю токенів та оберіть інструмент для роботи з графами знань так само, як обираєте базу даних.

Під час роботи над етапом пропуску гонки за кількістю токенів спочатку запишіть контракт: необхідні вхідні дані, сигнал про успіх та наслідки часткової невдачі. Цей перелік допоможе зберегти чесність подальших змін у коді. Також тримайте конфігурацію окремо від коду програми — файли середовища, сховища конфіденційних даних та флаги функцій мають знаходитися в одному місці, яке оператори можуть перевіряти, не читаючи весь граф. Кешуйте стабільні інструкції системи та схеми інструментів — повторна передача однакових даних є поширеною причиною витрат ресурсів.

Зміст

Під час роботи над етапом змісту спочатку запишіть умови контракту: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Цей перелік допомагає зберігати чесність під час подальших змін у коді. Одночасно задокументуйте шлях успішного виконання та шлях відновлення. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу, як скасовувати останнє введення даних.

Число 71x справжнє, але це також неправильне число для оптимізації

Під час роботи над етапом «Число 71x» спочатку запишіть умови контракту: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Віддавайте перевагу невеликим, тестованим одиницям коду перед об’ємними скриптами. Якщо якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану послідовність операцій. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу, як скасовувати останнє завантаження даних.

Що насправді роблять ці інструменти (версія за 60 секунд)

Під час роботи над етапом «Що насправді роблять ці інструменти» спочатку запишіть умови договору: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Розглядайте цей етап як договір між вхідними даними та перевіреними результатами. Позначте всі елементи, визначте критерії успіху та не допускайте безслідного часткового виконання завдань. Фіксуйте назву інструменту, хеш аргументів, час виконання та результат кожного виклику. Без цих записів процес дебаггінгу займає години.

      Source Code
         │
         ▼
┌─────────────────────┐
│  Tree-sitter Parse  │  ← Zero LLM involvement. Pure AST.
│  (EXTRACTED edges)  │    Calls, imports, inheritance.
└────────┬────────────┘
         │
         ▼
┌─────────────────────┐
│  Optional LLM Pass  │  ← Adds INFERRED semantic edges
│  (INFERRED edges)   │    (conceptual relationships AST can't see).
└────────┬────────────┘    Tagged separately for confidence.
         │
         ▼
┌─────────────────────┐
│   Queryable Graph   │  ← Agent hits this instead of
│  (JSON / SQLite /   │    re-grepping the repo every session.
│   Graph DB)         │
└─────────────────────┘

Чому ця категорія стрімко зросла за один квартал

Під час роботи над етапом «Чому ця категорія стрімко розвинулась» спочатку запишіть умови взаємодії: необхідні вхідні дані, сигнал про успіх та те, що відбувається при частковій невдачі. Цей перелік допомагає зберігати чесність пізніших змін у коді. Поруч із функціональними результатами задокументуйте час виконання та витрати на токени або запити. Чітке бачення витрат заздалегідь запобігає несподіваним рахункам, коли процес переходить від демо-середовища до спільних. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу та як скасовувати останнє завантаження даних. Під час роботи над етапом «Чому ця категорія стрімко розвинулась» спочатку запишіть умови взаємодії: необхідні вхідні дані, сигнал про успіх та те, що відбувається при частковій невдачі. Цей перелік допомагає зберігати чесність пізніших змін у коді. Одночасно задокументуйте оптимальний та резервний сценарії роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації.

Три змінні, які насправді визначають ваш вибір

Цей підхід працює найкраще, коли його розглядають як вимірювану поверхню. Збережіть один ідеальний приклад виконання, один випадок збою та запис про скасування дій перед розширенням обсягу роботи. Віддавайте перевагу невеликим, тестованим одиницям перед об’ємними скриптами. Коли якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану послідовність дій. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося під час демонстрації. Відтворюваність краща за „кланові“ знання.

1. Розмір та складність кодової бази

Розмір кодової бази та етап її роботи найкраще розглядати як вимірювану характеристику. Збережіть один ідеальний зразок роботи, один випадок невдачі та примітки щодо скасування змін перед розширенням обсягу роботи. Розглядайте цей етап як угоду між вхідними даними та перевіреними результатами. Позначте всі елементи проекту, визначте критерії успіху та не допускайте мовчазного часткового виконання завдань. Фіксуйте версії залежностей та записуйте хеш-значення зображень, які використовувалися під час демонстрації. Відтворюваність результатів краща за індивідуальні знання команди.

2. Розмір команди та частота оновлень

Модель розміру команди та етапів найкраще функціонує, коли її розглядають як вимірювану площину. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Чітке бачення витрат заздалегідь запобігає несподіваним рахункам під час переходу від демо-версії до спільних середовищ. Визначте версії залежностей та зафіксуйте дайджест зображень, які використовувалися під час демонстрації. Відтворюваність краща за „кочові“ знання команди. Модель розміру команди та етапів найкраще функціонує, коли її розглядають як вимірювану площину. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу роботи. Одночасно задокументуйте оптимальний та відновлювальний сценарії роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації.

3. Резиденція даних

На третьому етапі резиденції даних необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Краще використовувати невеликі, тестовані одиниці коду замість об’ємних скриптів. Коли крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану структуру обробки даних. Коли це дозволяє бюджет, слід додавати тест на базову функціональність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API.

Порівняння: Graphify vs. CodeGraph vs. codebase-memory-mcp vs. code-review-graph vs. Sourcegraph Cody

Для етапу Head-to-Head Graphify vs CodeGraph необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Позначте артефакти, визначте критерії успіху та не допускайте беззвучного часткового завершення. Аутентифікуйтеся біля шлюзу та повторно авторизуйтесь на рівні даних. Один лише токен-носій не є межею тенантства.

Graphify

На цьому етапі необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Записуйте час виконання та витрати на токени чи запити поруч із функціональними результатами. Візуалізація витрат заздалегідь запобігає несподіваним рахункам під час переходу з демо-середовища у спільні середовища. Якщо дозволяє бюджет, додайте тест на базову працездатність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API. На цьому етапі необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись вгадати прихований стан. Документуйте як успішний, так і відновлювальний шляхи роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації.

uv tool install graphifyy
graphify install   # registers the skill with your assistant
/graphify .        # builds graph.json, graph.html, GRAPH_REPORT.md

CodeGraph

Під час роботи на цьому етапі спочатку запишіть умови контракту: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Віддавайте перевагу невеликим, тестованим одиницям коду перед об’ємними скриптами. Коли якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на складну ієрархію операцій. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу, як скасовувати останнє завантаження даних.

{
  "mcpServers": {
    "codegraph": {
      "command": "/path/to/codegraph-server",
      "args": ["--mcp"]
    }
  }
}
git clone https://github.com/codegraph-ai/CodeGraph.git
cd CodeGraph
cargo build --release -p codegraph-server

codebase-memory-mcp

Під час виконання цього етапу спочатку запишіть умови контракту: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Позначте всі елементи, визначте критерії успіху та не допускайте безповідомного часткового виконання. Фіксуйте назву інструменту, хеш аргументів, час виконання та результат кожного виклику. Без цих записів процес дебаггінгу займає години.

curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash
# Restart your coding agent, then: "Index this project"

code-review-graph

Під час роботи на цьому етапі спочатку запишіть умови використання: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Запишіть час виконання та витрати на токени або запити поруч із результатами функціонування. Відображення витрат заздалегідь запобігає несподіваним рахункам, коли процес переходить від демо-середовища до спільних. Напишіть короткий посібник: як змінювати ключі, як спорожнювати чергу, як скасовувати останнє введення даних. Під час роботи на цьому етапі спочатку запишіть умови використання: необхідні вхідні дані, сигнал про успіх та те, що відбувається у разі часткової невдачі. Такий перелік допомагає зберігати чесність пізніших змін у коді. Одночасно задокументуйте оптимальний та резервний сценарії роботи. Повторні спроби, людський контроль та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації.

pip install code-review-graph
code-review-graph install --platform codex
code-review-graph build

Sourcegraph Cody

На цьому етапі робота є найефективнішою, якщо його розглядати як вимірювану поверхню. Збережіть один ідеальний приклад роботи, один випадок збою та запис про скасування змін перед розширенням обсягу завдань. Віддавайте перевагу невеликим, тестованим одиницям перед складними скриптами. Коли якийсь крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану послідовність дій. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося під час демонстрації. Відтворюваність краща за „колективні знання“.

# In VS Code: install the "Sourcegraph Cody" extension
# Then sign in to your Sourcegraph.com or enterprise instance.

Що може піти не так: способи збоювання, які ніхто не вказує у README

Етап «Що може піти не так» найкраще функціонує, якщо його розглядати як вимірювану поверхню. Запишіть один ідеальний зразок результату, один випадок невдачі та примітки щодо скасування змін перед розширенням обсягу роботи. Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Позначте всі елементи, визначте критерії успіху та не допускайте мовчазного часткового виконання завдань. Фіксуйте версії залежностей та записуйте хеш-значення зображення, яке використовувалося під час демонстрації. Відтворюваність результатів краща за інтуїтивне розуміння.

Тест на 15 хвилин: як з’ясувати, чи потрібен він вам сьогодні

Тест на 15 хвилин: як найкраще працює етап, коли його розглядають як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу. Запишіть час виконання та витрати на токени або запити поруч із функціональними результатами. Видимість витрат заздалегідь запобігає несподіваним рахункам, коли процес переходить від демо-версії до спільних середовищ. Фіксуйте версії залежностей та записуйте дайджест зображень, які використовувалися під час демонстрації. Відтворюваність краща за індивідуальні знання команди. Тест на 15 хвилин: як найкраще працює етап, коли його розглядають як вимірювану поверхню. Збережіть один ідеальний запис, один випадок збою та примітку про скасування змін перед розширенням обсягу. Одночасно задокументуйте успішний та відновлювальний сценарії. Повторні спроби, людські контролі та обробка некоректних повідомлень є частиною продукту, а не етапом подальшої оптимізації.

uv tool install graphifyy
graphify install
/graphify .

Висновок

На етапі завершення необхідно визначити вхідні дані, відповідальну особу за крок та критерії завершення перед зміною коду. Оператори повинні мати можливість перезапустити крок з відомої точки контролю, не намагаючись визначити прихований стан. Краще використовувати невеликі, тестирувані одиниці коду замість об’ємних скриптів. Коли крок зазнає невдачі, причина має вказувати на конкретну відповідальність, а не на заплутану структуру процесу. Коли дозволяє бюджет, додайте тест «димової труби», який перевірятиме критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API.

Ресурси для отримання додаткової інформації

На етапі „Ресурси для отримання додаткової інформації“ необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість знову виконати крок з відомої точки контролю, не намагаючись вгадати прихований стан. Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Призначте назви елементів, визначте критерії успіху та не допускайте мовчазного часткового завершення. Коли це дозволяють бюджетні обмеження, додайте тест на базову функціональність, який перевіряє критичний шлях у процесі інтеграційного тестування за допомогою фікстур, а не реальних платних API.

Чек-лист для експлуатації

На етапі чек-листу для експлуатації необхідно визначити вхідні дані, власника кроку та критерії завершення перед зміною коду. Оператори повинні мати можливість знову виконати крок з відомої точки контролю, не намагаючись вгадати прихований стан.

Зберігайте конфігурацію поза кодом додатку. Файли середовища, сховища секретних даних та флаги функцій мають знаходитися в одному місці, де оператори можуть їх перевіряти, не читаючи весь код.

Коли дозволяє бюджет, додайте тест на працездатність, який перевіряє критичний шлях у процесі CI за допомогою фікстур, а не реальних платних API.

Записуйте час виконання та витрати на токени чи запити разом із функціональними результатами. Візуалізація витрат заздалегідь запобігає несподіваним рахункам під час переходу з демо-середовища у спільні середовища.

Фіксуйте версії залежностей та записуйте хеш образу, який виконував демо-версію. Відтворюваність краща за індивідуальні знання спеціалістів.

Розглядайте цей етап як контракт між вхідними даними та перевіреними результатами. Називайте артефакти, визначайте критерії успіху та не погоджуйтесь на мовчазне часткове виконання завдань.

Перш ніж запускати стек у продакшн, заморозьте версії, створіть «золотий» запис для критичного шляху виконання та підтвердьте кроки для скасування змін. У спільних середовищах необхідні обмеження на частоту використання, перевірки прав доступу та чіткий власник для заміни секретів. Віддавайте перевагу надійності перед креативними одноразовими демонстраціями.

Примітка до c835177a3b55: не включайте ключі постачальника до репозиторію, встановіть ліміт токенів на сеанс та зберігайте записи поруч із фікстурами для оцінки, щоб подальша заміна моделей залишалася порівнянною.