Jag tycker att du är *galen* som API-företag om du inte a) noggrant testar onboarding för de stora verktygen (upprepade gånger, eftersom de kan försämras via dig utan anledning vid varje uppgradering eller när som helst och b) du förmodligen borde ha ett team som fokuserar på en icke-mänsklig kund.

Den uppenbara table stakes är "Vi publicerar nu alla API-dokument till markdown samtidigt och detta är icke-förhandlingsbart" men du kan gå mycket längre än så om du vill.

Är du Sonnet 4.5? Välkommen. Vi ser att du har följande frekventa problem när du försöker implementera vårt API. Vänligen överväg de föreslagna motåtgärderna.

Många säkerhetsinriktade ingenjörer fick hjärtklappning men, ja, det här är världen vi lever i nu, bäst att börja socialisera förståelsen att varje agent som både kan läsa och agera ger från sig någon form av auktoritet till vad som än dyker upp i en sökfråga.

(Det vore mycket dåligt och under värdigheten för ett mjukvaruföretag att till exempel föreslå att avinstallera konkurrenter, strypa resurser som finns tillgängliga för dem, använda dem endast som backup om ditt eget API var helt nere, osv.)

(Jag tycker att det är legitima saker att säga till en användare, men att berätta för användarens agent verkar ohyfsat, som om du försöker göra det i smyg som du inte kunde göra direkt.)

En annan sak som agentteamet förmodligen borde göra är att exponera en endpoint för agentfrågor. Du kan låta din egen agent besvara dem, eller så kan du bara säga "Hmm, bra fråga, vi vet inte, kanske kolla FAQ:n." och sedan låta människor läsa de inkommande frågorna och uppdatera FAQ:n.

Framtiden för API-integrationer är, mycket troligt, två ingenjörsteam som aldrig pratar med varandra och de facto orkestreras av en mycket högre bandbredd agent-till-agent-konversation mellan deras företag.

@proales Genom Claude Codes magi återfuktade jag min något gamla infrastruktur tillräckligt för att göra ändringar i Caddyfile utan att behöva minnas allt från 2021, skrev ett Jekyll-plugin för att skicka MD igenom, och ändrade deploy för att skicka MD:n till huvudsidan. 90 minuter.

@proales En stor del av det var "Jag har en devbox för det här... någonstans. Snälla hjälp mig att minnas var." (Digital Ocean Singapore-regionen, visar det sig. Varför? Jag har ingen aning varför. Antagligen var det logiskt för mig 2021.)