Перейти до вмісту

> ls /var/log/decisions/*.md

Технічні нотатки з розробки Maguyva

Архітектурні рішення, нотатки про реалізацію MCP і час від часу — обурення з приводу речей, які не мали б бути настільки складними.

Останній випуск

Найсвіжіша нотатка розробки

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

Архів

Технічні нотатки за темами

Архітектура, спостережуваність, проєктування інтерфейсу MCP та патерни, що вижили після зіткнення з продакшеном.

Чому ваш ШІ-агент для коду галюцинує шляхи до файлів_

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

[AI Agents] [Hallucination] [Retrieval] [MCP]

Чому ми оновили пошук коду до voyage-4-large_

Ми перевели наші ембеддинги коду на voyage-4-large — модель, що наразі очолює публічний рейтинг RTEB для пошуку коду. Чесна версія: компроміс, на який ми йдемо, що ми насправді індексуємо, і чому ми платимо за преміум-ембеддинги.

[Ембедінги] [Пошук] [Архітектура]

Рекурсивне самовдосконалення мов: шліфування інтелекту коду для ~280 мов_

Ми підтримуємо інтелект коду для ~280 мов. Жодна людина не здатна вручну перевірити це. Тож ми побудували цикл рекурсивного самовдосконалення мов — вибіркова перевірка, LLM як суддя, виправлення одного пункту, повторна валідація — і запускаємо його з флотом ізольованих агентів, доки вилучення не стане справді правильним, а не просто «зеленим».

[Архітектура] [Мови] [Агенти]

Мультимодальний пошук зі злиттям: обираємо правильний ретрівер для кожного запиту_

Запит на кшталт «де визначено parseConfig» потребує іншого пошуку, ніж «як працює автентифікація». Maguyva класифікує намір, відповідно зважує чотири режими пошуку і зливає результати за допомогою зваженого Reciprocal Rank Fusion.

[Пошук] [Архітектура]

Спостережуваність агентів: хуки, Alloy та Grafana_

Ми під'єднали Claude Code та Codex до єдиного стеку Grafana за допомогою OpenTelemetry та Alloy, а потім використали трейси й логи, щоб знаходити та виправляти проблеми в поведінці агентів у джерелі.

[Спостережуваність] [Grafana] [OpenTelemetry] [Архітектура]

Видобування знань з історії змін: як зміни стають інституційною пам'яттю_

Git-коміти перетворюються на структуровані записи журналу змін та архітектурні рішення, а потім повертаються до ШІ-агентів як інституційна пам'ять, придатна для запитів.

[Архітектура] [Робочі процеси]

Прогресивне розкриття: вікна CLI в агентні системи_

Агентні системи за замовчуванням непрозорі. Прогресивне розкриття дає операторам багаторівневі подання CLI — від швидких перевірок статусу до повної внутрішньої структури агентів і трейсів рішень.

[Архітектура] [CLI] [Інструментарій]

Базові істини: прив'язування ШІ-агентів до реальності_

ШІ-агенти впевнено галюцинують. Базові істини — це версійовані факти з чітко визначеною сферою дії, які прив'язують поведінку агента до реальності. Ось як ми їх побудували та застосовуємо.

[Архітектура] [Обґрунтування]
Будьте в курсі

Це весь архів_

Кожен випуск з'являється спершу тут. Нові матеріали одразу потрапляють у журнал змін, або підпишіться на RSS, щоб дізнаватися про них одразу.

[Журнал змін] [RSS]