El auge de los agentes de IA está cambiando las reglas del diseño de interfaces de programación (APIs). El autor, ingeniero de Freestyle, sostiene que las prácticas que optimizaban la experiencia de desarrolladores humanos —valores por defecto, nombres genéricos, errores condescendientes y SDKs con utilidades que abstraen la complejidad— son contraproducentes cuando el consumidor del código es un modelo de lenguaje.
La tesis central se articula en cuatro pilares. Primero, los valores por defecto dejan de tener sentido: los agentes pueden leer toda la documentación de golpe y rellenar cada campo de forma explícita, por lo que la concisión pierde valor frente a la precisión. Segundo, los errores dejan de ser el enemigo: en lugar de suavizarlos, conviene que los mensajes sean nítidos y expliquen exactamente qué esperaba la API, porque los agentes pueden leerlos y corregirse solos. Tercero, los nombres genéricos como name, ambiguos entre «nombre visible», «identificador» o «slug», inducen a los agentes a alucinaciones; se prefieren nombres específicos como displayName o externalId. Cuarto, el valor de una API para agentes reside en aportar hechos verificables —un pago realizado, una máquina virtual aprovisionada— y no en utilidades que el propio agente puede reconstruir.
Freestyle aplicó estas ideas a sus máquinas virtuales en la nube. Eliminó capas de SDK y abstracciones declarativas, sustituidas por guías que el agente lee directamente, y observó una integración más limpia y depurable. El artículo incluye además ejemplos de SDK de Stripe y Twilio como modelos de buenas APIs para humanos.