Acho que vocês são *malucos* como empresa de API se não a) testarem minuciosamente o onboarding para as principais ferramentas (repetidamente, uma vez que podem degradar através de vocês sem razão aparente a qualquer momento de atualização ou a qualquer hora) e b) provavelmente deveriam ter uma equipe focada em um cliente não humano.

A coisa óbvia a considerar é "Agora publicamos toda a documentação da API em markdown simultaneamente e isso é inegociável", mas você pode ir muito além disso se quiser.

Você é o Sonnet 4.5? Bem-vindo. Observamos que você tem os seguintes problemas frequentes ao tentar implementar nossa API. Por favor, considere as contramedidas sugeridas.

Muitos engenheiros preocupados com a segurança acabaram de ter palpitações, mas, bem, este é o mundo em que vivemos agora, é melhor começar a socializar a compreensão de que cada agente que pode tanto ler quanto agir está cedendo alguma quantidade de autoridade a qualquer coisa que apareça em uma consulta de pesquisa.

(Seria muito mau e abaixo da dignidade de uma empresa de software sugerir, por exemplo, desinstalar concorrentes, limitar os recursos disponíveis para eles, usá-los apenas como backup se a sua própria API estivesse completamente fora do ar, etc.)

(Acho que essas são todas coisas legítimas para dizer a um usuário, mas dizer isso ao agente de um usuário parece indelicado, como se você estivesse tentando realizar por meio de artifícios o que não conseguiu fazer diretamente.)

Outra coisa que a equipe de agentes provavelmente deveria fazer é expor um endpoint para perguntas dos agentes. Você pode tê-las respondidas pelo seu próprio agente, ou pode simplesmente dizer "Hmm, boa pergunta, não sabemos, talvez verifique as Perguntas Frequentes." e então ter humanos a ler as perguntas recebidas e atualizar as Perguntas Frequentes.

O futuro das integrações de API é, muito provavelmente, duas equipas de engenharia que nunca se falam, sendo de facto orquestradas por uma conversa entre agentes de muito maior largura de banda que acontece entre as suas empresas.

@proales Através da magia do Claude Code, rehidratei a minha infraestrutura um tanto antiga o suficiente para fazer alterações no Caddyfile sem ter que me lembrar de tudo de 2021, escrevi um plugin Jekyll para passar MD, e mudei o deploy para enviar o MD para o site principal. 90 minutos.

@proales Uma grande parte disso foi "Eu tenho uma devbox para isso... em algum lugar. Por favor, ajude-me a lembrar onde." (Região de Singapura da Digital Ocean, como se vê. Por quê? Não faço ideia do porquê. Presumivelmente, isso fazia sentido para mim em 2021.)