root@construct:~/rants/skill-envelhece-api$
<-- voltar para /rants
2026-05-17//OPINIAO

Skill que chama API morta é documentação quebrada

Uma skill que aponta pra uma API morta precisa de manutenção, por mais bonita que esteja a descrição. A OpenAI registrou em maio de 2026 a retirada de DALL·E 2 e DALL·E 3 da API. O endpoint sai do catálogo. O arquivo de instruções continua tranquilamente no disco, pronto pra mandar um agente bater na mesma porta fechada.

Escrevendo esta retrospectiva, volto a um pedido que fiz em agosto de 2026: delegar uma pesquisa e transformar aquela capacidade numa skill reutilizável. Eu queria aproveitar o trabalho depois. Em julho, já tinha questionado por que uma ferramenta estava usando determinado modelo quando havia outra opção disponível. Reaproveitamento me interessa junto com a possibilidade de entender o que está sendo acionado.

Pensa numa skill hipotética de geração de imagem. A descrição explica o formato da entrega, mas a execução chama um serviço que acabou. Quem lê só o resumo recebe uma promessa que o ambiente não consegue cumprir. O agente pode até explicar o erro com muita educação. Continuo sem imagem e agora tenho um parágrafo de condolências.

Quero a dependência visível perto da instrução: qual ferramenta executa aquilo e onde conferir se ela continua disponível. Isso também ajuda quando o serviço existe, mas a sessão atual não tem acesso. São problemas diferentes. Sair trocando a implementação por causa de uma ferramenta ausente naquela sessão é começar uma reforma antes de conferir a chave.

Atualizar uma skill exige decidir se a entrega continua igual. Se muda apenas o meio de produzir o mesmo resultado, faz sentido preservar a entrada conhecida. Se o novo serviço muda o comportamento, essa diferença precisa aparecer pra quem pede o trabalho. Um nome familiar escondendo uma surpresa não facilita meu dia.

Também não quero uma coleção de arquivos mantida por esporte. Pedi a skill justamente pra evitar repetir pesquisa e preparação. Se cada uso exige investigar tudo do zero, a capacidade de reaproveitar ficou no título. Preciso encontrar as condições de execução e um caminho de atualização sem abrir uma expedição pelo setup inteiro.

Meu veredito: dependência faz parte da manutenção da skill. Ao trocar uma API, vou revisar a instrução que escolhe a ferramenta, conferir a entrega esperada e tirar de circulação o caminho que deixou de funcionar. Manter o nome só vale a pena quando o que ele promete continua sendo verdade.

Retrospectiva escrita em outubro de 2026. A data do post identifica a semana revisitada; as opiniões incorporam experiências posteriores.

Fontes: OpenAI API changelog

The Broad Way | Kinho.dev