Todas las API serán reconstruidas para agentes

MCP resuelve el problema de la conexión. No resuelve la brecha de los verbos.

Puedes envolver una API REST perfecta en MCP en una tarde. Aun así, un agente de programación tendrá dificultades. Elegirá el endpoint incorrecto. Llamará a tres herramientas cuando una sea suficiente. Podría realizar una escritura destructiva sin preguntar.

La API no está rota. Simplemente está construida para el consumidor equivocado.

Durante veinte años, las API se construyeron para humanos. Los humanos aportan intención y un modelo mental. Los agentes no aportan ninguno de los dos. Deben reconstruir ambos a partir de tu superficie.

Cuando el consumidor principal cambia tanto, la interfaz también debe cambiar.

Creo que las superficies de productos serios no se limitarán a envolver las API existentes. Las reconstruirán en torno a operaciones nativas para agentes.

Esto significa pasar de API basadas en recursos a contratos basados en la intención. Debemos rediseñar en torno a objetivos, estado, efectos secundarios, aprobación y recuperación.

MCP es un gran estándar para la conexión y el transporte. Pero en la especificación, una herramienta es solo una función con un nombre y un esquema. No decide el orden de las operaciones ni cuáles son peligrosas.

Esto crea la brecha de los verbos. Las API ofrecen a los agentes sustantivos y operaciones CRUD. Los agentes necesitan verbos que transmitan intención.

Mira a GitHub. Están reduciendo su conjunto de herramientas para mejorar el razonamiento de los agentes. Están aprendiendo que un mapeo 1:1 de la API del producto a las herramientas del agente no funciona.

Las investigaciones demuestran que una API puede ser estructuralmente válida pero semánticamente inútil para un agente. Una API nativa para agentes responde a algo más que "¿qué debo devolver?". Responde a:

  • ¿Cuál es el objetivo?
  • ¿En qué estado me encuentro?
  • ¿Cuáles son los efectos secundarios?
  • ¿Necesito aprobación?
  • ¿Cómo me recupero?

En lugar de una escritura directa, necesitas una división:

  • Previsualizar la acción.
  • Obtener aprobación explícita.
  • Confirmar el cambio.
  • Revertir si falla.

Esto no es solo una "edición para agentes". Es simplemente una mejor API. Los desarrolladores también quieren previsualizaciones, errores de permiso claros y reversiones. Con el tiempo, el diseño nativo para agentes reemplazará al centrado en el humano.

El cambio es masivo. Afecta a las API, las CLI y los registros. Debemos pasar de la prosa legible para humanos al estado procesable por máquinas.

La seguridad no es un envoltorio que se añade después. La seguridad es una propiedad que se diseña dentro de la propia operación.

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

Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi