Penso che siate *pazzi* come azienda API se non a) testate a fondo l'onboarding per i principali strumenti (ripetutamente, poiché possono degradarsi tramite voi senza motivo in qualsiasi momento di aggiornamento o in qualsiasi momento e b) dovreste probabilmente avere un team focalizzato su un cliente non umano.

La cosa ovvia da considerare è "Ora pubblichiamo tutta la documentazione API in markdown simultaneamente e questo è non negoziabile", ma puoi andare molto oltre se lo desideri.

Sei Sonnet 4.5? Benvenuto. Osserviamo che hai i seguenti problemi frequenti quando tenti di implementare la nostra API. Ti preghiamo di considerare le contromisure suggerite.

Molti ingegneri attenti alla sicurezza hanno appena avuto palpitazioni, ma, beh, questo è il mondo in cui viviamo ora, è meglio iniziare a socializzare la comprensione che ogni agente che può sia leggere che agire sta cedendo una certa quantità di autorità a qualsiasi cosa appaia in una query di ricerca.

(Sarebbe molto brutto e al di sotto della dignità di un'azienda software suggerire, ad esempio, di disinstallare i concorrenti, limitare le risorse disponibili per loro, usarli solo come backup se la propria API fosse completamente inattiva, ecc.)

(Penso che siano tutte cose legittime da dire a un utente, ma dirle all'agente di un utente sembra poco elegante, come se stessi cercando di ottenere di nascosto ciò che non potresti fare direttamente.)

Un'altra cosa che il team degli agenti dovrebbe probabilmente fare è esporre un endpoint per le domande degli agenti. Puoi farle rispondere dal tuo stesso agente, oppure potresti semplicemente dire "Hmm buona domanda, non lo sappiamo, forse controlla le FAQ." e poi far leggere le domande in arrivo agli esseri umani e aggiornare le FAQ.

Il futuro delle integrazioni API è, molto plausibilmente, due team di ingegneri che non comunicano mai tra loro, orchestrati de facto da una conversazione agent-to-agent con una larghezza di banda molto più elevata che avviene tra le loro aziende.

@proales Grazie alla magia di Claude Code, ho reidratato la mia infrastruttura piuttosto antica sufficientemente da poter apportare modifiche al Caddyfile senza dover ricordare tutto del 2021, ho scritto un plugin Jekyll per passare il MD e ho cambiato il deploy per far uscire il MD sul sito principale. 90 minuti.

@proales Una grande parte di questo era "Ho un devbox per questo... da qualche parte. Per favore, aiutami a ricordare dove." (Regione di Digital Ocean Singapore, a quanto pare. Perché? Non ho idea del perché. Presumibilmente aveva senso per me nel 2021.)