Creo que eres *loco* como empresa de API si no a) pruebas a fondo la incorporación de las herramientas principales (repetidamente, ya que pueden degradarse a través de ti sin razón alguna en cualquier momento de la actualización o en cualquier momento) y b) probablemente deberías tener un equipo enfocado en un cliente no humano.

Lo obvio es que "Ahora publicamos toda la documentación de la API en markdown simultáneamente y esto es innegociable", pero puedes ir mucho más allá si lo deseas.

¿Eres Sonnet 4.5? Bienvenido. Observamos que tienes los siguientes problemas frecuentes al intentar implementar nuestra API. Por favor, considera las contramedidas sugeridas.

Muchos ingenieros preocupados por la seguridad acaban de tener palpitaciones, pero, bueno, este es el mundo en el que vivimos ahora, es mejor empezar a socializar la comprensión de que cada agente que puede tanto leer como actuar está cediendo cierta cantidad de autoridad a lo que aparezca en una consulta de búsqueda.

(Sería muy malo y por debajo de la dignidad de una empresa de software sugerir, por ejemplo, desinstalar a los competidores, limitar los recursos disponibles para ellos, usarlos solo como respaldo si tu propia API estuviera completamente caída, etc.)

(Creo que esas son todas cosas legítimas que decir a un usuario, pero decírselas al agente de un usuario parece poco cortés, como si estuvieras tratando de lograr por la fuerza lo que no pudiste hacer directamente.)

Otra cosa que el equipo de agentes debería hacer es exponer un endpoint para preguntas de agentes. Puedes hacer que las responda tu propio agente, o simplemente podrías decir "Hmm, buena pregunta, no lo sabemos, tal vez revisa las preguntas frecuentes." y luego hacer que humanos lean las preguntas entrantes y actualicen las preguntas frecuentes.

El futuro de las integraciones de API es, muy probablemente, dos equipos de ingeniería que nunca se comunican entre sí, siendo de facto orquestados por una conversación entre agentes de mucho mayor ancho de banda que ocurre entre sus empresas.

@proales A través de la magia de Claude Code, rehidraté mi infraestructura algo antigua lo suficiente como para hacer cambios en el Caddyfile sin tener que recordar todo de 2021, escribí un plugin de Jekyll para pasar MD, y cambié el despliegue para que la salida de MD se muestre en el sitio principal. 90 minutos.

@proales Una gran parte de eso fue "Tengo una devbox para esto... en algún lugar. Por favor, ayúdame a recordar dónde." (Región de Digital Ocean en Singapur, al parecer. ¿Por qué? No tengo ni idea de por qué. Presumiblemente, eso tenía sentido para mí en 2021.)