Кожен API буде перебудований для агентів

MCP вирішує проблему підключення. Він не вирішує проблему розриву між діями (verb gap).

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

API не зламаний. Він просто створений для невідповідного споживача.

Протягом двадцяти років API створювалися для людей. Люди приносять із собою намір і ментальну модель. Агенти не приносять ні того, ні іншого. Вони мають реконструювати і те, і інше на основі вашого інтерфейсу.

Коли основний споживач так суттєво змінюється, інтерфейс також має змінитися.

Я вважаю, що серйозні продуктові інтерфейси не просто загорнуть існуючі API. Вони перебудують їх навколо операцій, адаптованих для агентів (agent-native).

Це означає перехід від API, орієнтованих на ресурси, до контрактів, орієнтованих на наміри. Ми повинні перепроектувати їх навколо цілей, станів, побічних ефектів, підтвердження та відновлення.

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

Це створює розрив між діями (verb gap). API надають агентам іменники та CRUD-операції. Агентам потрібні дієслова, що несуть намір.

Подивіться на GitHub. Вони звужують свій набір інструментів, щоб покращити логічне мислення агентів. Вони дізнаються, що відповідність 1:1 між API продукту та інструментами агента не працює.

Дослідження показують, що API може бути структурно правильним, але семантично марним для агента. API, адаптований для агентів, відповідає не лише на питання «що мені повернути». Він відповідає на питання:

  • Яка мета?
  • У якому я стані?
  • Які побічні ефекти?
  • Чи потрібне підтвердження?
  • Як мені відновитися?

Замість сирого запису вам потрібен розподіл:

  • Попередній перегляд дії.
  • Отримання явного підтвердження.
  • Фіксація змін.
  • Відкат у разі невдачі.

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

Цей зсув є масштабним. Він впливає на API, CLI та логи. Ми повинні перейти від зрозумілої людині прози до стану, придатного для машинного аналізу.

Безпека — це не обгортка, яку ви додаєте пізніше. Безпека — це властивість, яку ви закладаєте в саму операцію.

Source: https://dev.to/gyu07/every-api-will-be-rebuilt-for-agents-2hj4

Optional learning community: https://t.me/GyaanSetuAi