Каждый API будет перестроен под агентов

MCP решает проблему подключения. Но он не решает проблему глаголов.

Вы можете обернуть идеальный REST API в MCP за один вечер. Но даже тогда кодинг-агент будет испытывать трудности. Он выберет не тот эндпоинт. Он вызовет три инструмента там, где достаточно одного. Он может выполнить деструктивную запись, не спросив разрешения.

API не сломан. Он просто создан для не того потребителя.

На протяжении двадцати лет API создавались для людей. Люди приносят с собой намерение и ментальную модель. Агенты не приносят ни того, ни другого. Им приходится восстанавливать и то, и другое, исходя из вашего интерфейса.

Когда основной потребитель настолько меняется, интерфейс тоже должен измениться.

Я считаю, что серьезные продуктовые интерфейсы не будут просто оборачивать существующие API. Они будут перестраивать их вокруг операций, нативных для агентов.

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

MCP — отличный стандарт для подключения и передачи данных. Но в спецификации инструмент — это просто функция с именем и схемой. Она не определяет порядок операций и не указывает, какие из них опасны.

Это и создает проблему глаголов. API дают агентам существительные и CRUD-операции. Агентам же нужны глаголы, несущие в себе намерение.

Посмотрите на GitHub. Они сужают свой набор инструментов, чтобы улучшить логику рассуждений агентов. Они понимают, что прямое соответствие 1:1 между API продукта и инструментами агента не работает.

Исследования показывают, что API может быть структурно корректным, но семантически бесполезным для агента. API, нативный для агентов, отвечает не только на вопрос «что мне вернуть?». Он отвечает на вопросы:

  • Какова цель?
  • В каком состоянии я нахожусь?
  • Каковы побочные эффекты?
  • Нужно ли подтверждение?
  • Как мне восстановиться?

Вместо прямой записи вам нужно разделение на этапы:

  • Предварительный просмотр действия.
  • Получение явного подтверждения.
  • Фиксация изменений.
  • Откат в случае ошибки.

Это не просто «версия для агентов». Это просто более качественный API. Разработчики тоже хотят предварительного просмотра, четких ошибок прав доступа и возможности отката. В конечном итоге дизайн, ориентированный на агентов, заменит человекоцентричный дизайн.

Этот сдвиг огромен. Он затрагивает API, CLI и логи. Мы должны перейти от человекочитаемой прозы к машиночитаемому состоянию.

Безопасность — это не надстройка, которую добавляют позже. Безопасность — это свойство, которое закладывается в саму операцию.

Источник: https://dev.to/gyu07/every-api-will-be-rebuilt-for-agents-2hj4

Дополнительное обучающее сообщество: https://t.me/GyaanSetuAi