Acho que você é *louco* como empresa de API se não a) testar completamente o onboarding das principais ferramentas (repetidamente, já que elas podem se degradar sem motivo em qualquer momento de atualização ou momento e b) provavelmente você deveria ter uma equipe focada em um cliente não humano.

A questão óbvia da tabela é "Agora publicamos todos os documentos da API para markdown simultaneamente e isso é inegociável", mas você pode ir muito além disso se quiser.

Você é o Soneto 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 com foco em segurança tinham palpitações, mas, bem, este é o mundo em que vivemos agora, é melhor começar a socializar a compreensão de que todo agente que sabe ler e agir está cedendo alguma autoridade para o que aparece em uma consulta de busca.

(Seria muito ruim e abaixo da dignidade de uma empresa de software, por exemplo, sugerir desinstalar concorrentes, limitar recursos disponíveis para eles, usá-los apenas como backup se sua própria API estiver fechada, etc.)

(Acho que essas são todas coisas legítimas para contar a um usuário, mas contar para o agente do usuário parece grosseiro, como se você estivesse tentando fazer discretamente o que não poderia fazer diretamente.)

Outra coisa que a equipe de agentes provavelmente deveria fazer é expor um endpoint para as perguntas dos agentes. Você pode pedir para que seu próprio agente as responda, ou simplesmente dizer "Hmm, boa pergunta, não sabemos, talvez confira o FAQ." e então pedir para as pessoas lerem as perguntas que estão chegando e atualizarem as perguntas frequentes.

O futuro das integrações de APIs é, muito plausivelmente, duas equipes de engenharia que nunca se comunicam sendo de fato orquestradas por uma conversa agente a agente com muito maior largura de banda entre suas empresas.

@proales Graças à magia do Claude Code, reidratei minha infraestrutura um tanto antiga o suficiente para fazer alterações no Caddyfile sem precisar lembrar de tudo de 2021, escrevi um plugin para Jekyll para passar o MD e mudei o deploy para enviar o MD para o site principal. 90 minutos.

@proales Grande parte disso foi "Eu tenho um devbox para isso... em algum lugar. Por favor, me ajude a lembrar onde." (Região Digital Oceano Singapura, como se descobriu. Por quê? Não faço ideia do porquê. Presumivelmente, isso fez sentido para mim em 2021.)