Ik denk dat je *gek* bent als API-bedrijf als je a) de onboarding voor de belangrijkste tools niet grondig test (herhaaldelijk, aangezien ze via jou zonder reden op elk moment kunnen verslechteren of upgraden) en b) je waarschijnlijk een team zou moeten hebben dat zich richt op een niet-menselijke klant.

Het voor de hand liggende uitgangspunt is "We publiceren nu alle API-documentatie gelijktijdig naar markdown en dit is niet onderhandelbaar", maar je kunt veel verder gaan dan dat als je dat wilt.

Ben jij Sonnet 4.5? Welkom. We merken dat je de volgende veelvoorkomende problemen ondervindt bij het proberen onze API te implementeren. Overweeg alstublieft de voorgestelde tegenmaatregelen.

Veel beveiligingsbewuste ingenieurs hebben net hartkloppingen gekregen, maar goed, dit is de wereld waarin we nu leven. Het is beter om te beginnen met het socialiseren van het begrip dat elke agent die zowel kan lezen als handelen, een bepaalde hoeveelheid autoriteit afgeeft aan wat er in een zoekopdracht verschijnt.

(Het zou zeer slecht zijn en onder de waardigheid van een softwarebedrijf om bijvoorbeeld te suggereren dat concurrenten worden verwijderd, de beschikbare middelen voor hen te beperken, hen alleen als back-up te gebruiken als je eigen API volledig uitvalt, enz.)

(Ik denk dat dit allemaal legitieme dingen zijn om een gebruiker te vertellen, maar het aan de agent van de gebruiker vertellen lijkt ongepast, alsof je probeert om via een omweg te bereiken wat je niet direct kon doen.)

Een andere zaak die het agententeam waarschijnlijk zou moeten doen, is een endpoint voor agentvragen blootstellen. Je kunt ze laten beantwoorden door je eigen agent, of je zou gewoon kunnen zeggen: "Hmm, goede vraag, we weten het niet, misschien kun je de FAQ raadplegen." en dan kunnen mensen de binnenkomende vragen lezen en de FAQ bijwerken.

De toekomst van API-integraties is, heel plausibel, twee engineeringteams die nooit met elkaar praten, de facto gecoördineerd door een veel hogere bandbreedte agent-naar-agent conversatie die plaatsvindt tussen hun bedrijven.

@proales Door de magie van Claude Code heb ik mijn enigszins verouderde infrastructuur opnieuw tot leven gebracht, zodat ik wijzigingen in het Caddyfile kon aanbrengen zonder alles uit 2021 te hoeven onthouden, heb ik een Jekyll-plugin geschreven om MD door te geven, en heb ik de implementatie gewijzigd om de MD naar de hoofdsite te outputten. 90 minuten.

@proales Een groot deel daarvan was "Ik heb een devbox hiervoor... ergens. Help me alsjeblieft herinneren waar." (Digital Ocean Singapore regio, zoals het blijkt. Waarom? Ik heb geen idee waarom. Vermoedelijk maakte dat voor mij in 2021 zin.)