← Каталог

Мы составили карту 115 микросервисов для наших coding agents

We Mapped 115 Microservices for Our Coding Agents — Kamalakannan Nandagopal, Postman

Граф API-контекста, где каждая связь подтверждена кодом или продакшен-телеметрией, по словам авторов, позволяет coding агентам отвечать на архитектурные вопросы по 115 микросервисам.

  • Заземление графа на код и телеметрию — каждый элемент графа (сервис, эндпоинт, потребитель, база, кэш) должен подтверждаться строкой кода или трассировкой из продакшена, иначе его не добавляют в граф.
  • Синхронизация удалений и добавлений — устаревший граф пропустил новых потребителей эндпоинта, и оценка влияния провалилась. По словам спикера, такие провалы быстро подрывают доверие разработчиков к инструменту.
  • Оценки на реальных PR — тесты строились по прошлым pull request и решениям по дизайну; по словам авторов, для оценки влияния граф дал качество не хуже поиска по коду Claude Code при половине или трети токенов. Независимыми бенчмарками эти результаты не проверялись.
  • Обзор архитектуры — по словам спикера, почти 75% PR в десяти репозиториях затрагивали API, а агент по графу написал 21-страничный отчёт с циклами зависимостей, рискованными миграциями, единичными точками отказа и слепыми зонами телеметрии.

Кому полезно: тем, кто настраивает coding агентов для большой распределённой системы и хочет, чтобы они оценивали изменения API до ревью.

Статья по теме

На какие вопросы отвечает доклад

  • Как дать coding агенту актуальный контекст о микросервисах, если документация быстро устаревает?

    Строить граф API-контекста: сервисы, эндпоинты, код реализации, потребители и базы данных. Каждая связь должна подтверждаться строкой кода или трейсом из production telemetry.

    ▶ 4:41Построение графа на основе кода и телеметрии
  • Как найти правильный API среди сотен эндпоинтов, которые делают похожее?

    Агент с графом API-контекста по словам спикера заметно лучше справляется с поиском, чем агент, который использует обычный поиск по коду в GitHub.

    ▶ 8:24Поиск API
  • Как понять, какие формы запроса реально используют все потребители API перед его редизайном?

    Граф связывает каждого потребителя с местом реализации в коде, и агент по этим данным выделил уникальные формы запроса для каждого потребителя. Обычный поиск по коду справлялся заметно хуже.

    ▶ 8:54Редизайн API и формы запросов потребителей
  • Почему анализ влияния изменения API показывает неполный список зависимых сервисов?

    Граф устарел: между созданием оценки и её запуском появились новые потребители. Синхронизировать нужно и добавления, и удаления связей, иначе падает доверие разработчиков к результату.

    ▶ 12:23Сбой из-за устаревшего графа и изменения API в pull request
  • Как с помощью агента найти циклические зависимости и единые точки отказа в распределённой системе?

    По графу агент сгенерировал 21-страничный архитектурный отчёт. В нём нашлись циклы зависимостей, рискованные долгие миграции, единые точки отказа и слепые зоны телеметрии.

    ▶ 14:01Архитектурный обзор, созданный агентом

Главы

Похожие доклады