Cred că ești *nebun* ca companie de API dacă nu a) testezi temeinic onboarding-ul pentru principalele unelte (repetat, deoarece acestea pot să se degradeze prin tine fără motiv la orice moment sau la orice moment de upgrade și b) probabil ar trebui să ai o echipă concentrată pe un client non-uman.

Problema evidentă a tabelului este "Acum publicăm toate documentele API în markdown simultan și acest lucru nu este negociabil", dar poți merge mult mai departe dacă vrei.

Ești Sonetul 4.5? Bun venit. Observăm că aveți următoarele probleme frecvente atunci când încercați să implementați API-ul nostru. Vă rugăm să luați în considerare contramăsurile sugerate.

Mulți ingineri preocupați de securitate aveau palpitații la inimă, dar, ei bine, aceasta este lumea în care trăim acum, ar fi bine să începem să socializăm înțelegerea că fiecare agent care poate citi și acționa cedează o anumită autoritate oricărui lucru care apare într-o interogare de căutare.

(Ar fi foarte rău și sub demnitatea unei companii de software să sugereze, de exemplu, dezinstalarea concurenților, limitarea resurselor disponibile, folosirea lor doar ca backup dacă propriul tău API ar fi blocat, etc.)

(Cred că toate acestea sunt lucruri legitime de spus unui utilizator, dar să-i spui agentului unui utilizator pare nepolit, ca și cum ai încerca să realizezi pe ascuns ceea ce nu ai putea face direct.)

Un alt lucru pe care echipa de agenți ar trebui probabil să-l facă este să expună un endpoint pentru întrebările agenților. Poți primi răspunsuri de către propriul tău agent, sau poți pur și simplu să spui "Hmm, bună întrebare, nu știm, poate verifică FAQ-ul." și apoi să lași oamenii să citească întrebările primite și să actualizeze FAQ-ul.

Viitorul integrărilor API-urilor este, foarte plauzibil, două echipe de inginerie care nu comunică niciodată între ele fiind de facto orchestrate de o conversație agent-la-agent cu o lățime de bandă mult mai mare între firmele lor.

@proales Prin magia lui Claude Code am rehidratat suficient infrastructura mea oarecum veche pentru a face modificări la Caddyfile fără să-mi amintesc totul din 2021, am scris un plugin Jekyll pentru a transmite MD și am modificat deploy-ul pentru a trimite MD-ul pe site-ul principal. 90 de minute.

@proales O mare parte din asta a fost "Am un devbox pentru asta... undeva. Te rog, ajută-mă să-mi amintesc unde." (Regiunea Digital Ocean Singapore, după cum s-a dovedit. De ce? Nu am nici cea mai mică idee de ce. Probabil că asta a avut sens pentru mine în 2021.)