Je pense que vous êtes *fou* en tant qu'entreprise API si vous ne a) testez pas minutieusement l'intégration des principaux outils (répétitivement, car ils peuvent se dégrader via vous sans raison à tout moment lors d'une mise à niveau ou à tout moment) et b) vous devriez probablement avoir une équipe axée sur un client non humain.

La chose évidente à exiger est "Nous publions désormais tous les documents API en markdown simultanément et cela est non négociable", mais vous pouvez aller beaucoup plus loin que cela si vous le souhaitez.

Êtes-vous Sonnet 4.5 ? Bienvenue. Nous avons remarqué que vous rencontrez les problèmes fréquents suivants lors de la tentative d'implémentation de notre API. Veuillez considérer les contre-mesures suggérées.

Beaucoup d'ingénieurs soucieux de la sécurité viennent d'avoir des palpitations, mais bon, c'est le monde dans lequel nous vivons maintenant, il vaut mieux commencer à socialiser la compréhension que chaque agent capable à la fois de lire et d'agir cède une certaine autorité à tout ce qui apparaît dans une requête de recherche.

(Il serait très mauvais et indigne d'une entreprise de logiciels de, par exemple, suggérer de désinstaller des concurrents, de limiter les ressources qui leur sont disponibles, de les utiliser uniquement comme sauvegarde si votre propre API était complètement hors service, etc.)

(Je pense que ce sont toutes des choses légitimes à dire à un utilisateur, mais les dire à l'agent d'un utilisateur semble déplacé, comme si vous essayiez d'accomplir par la ruse ce que vous ne pouviez pas faire directement.)

Une autre chose que l'équipe des agents devrait probablement faire est d'exposer un point de terminaison pour les questions des agents. Vous pouvez les faire répondre par votre propre agent, ou vous pourriez simplement dire "Hmm bonne question, nous ne savons pas, peut-être vérifier la FAQ." et ensuite faire en sorte que des humains lisent les questions entrantes et mettent à jour la FAQ.

L'avenir des intégrations API est, très probablement, deux équipes d'ingénierie qui ne se parlent jamais, étant de facto orchestrées par une conversation agent-à-agent à bien plus large bande passante se déroulant entre leurs entreprises.

@proales Grâce à la magie de Claude Code, j'ai réhydraté mon infrastructure quelque peu ancienne suffisamment pour apporter des modifications au Caddyfile sans avoir à me souvenir de tout ce qui s'est passé en 2021, j'ai écrit un plugin Jekyll pour faire passer le MD, et j'ai modifié le déploiement pour sortir le MD sur le site principal. 90 minutes.

@proales Une grande partie de cela était "J'ai une devbox pour ça... quelque part. S'il te plaît, aide-moi à me souvenir où." (Région de Digital Ocean à Singapour, apparemment. Pourquoi ? Je n'en ai aucune idée. Cela avait probablement du sens pour moi en 2021.)