root@construct:~/rants/prazo-assistants-api$
<-- voltar para /rants
2026-08-28//OPINIÃO

O custo de sair da API entra na conta desde o começo

O custo de abandonar uma API precisa entrar na escolha antes que chegue o aviso de encerramento. Recursos bons no primeiro dia não pagam o trabalho de reconstruir uma integração. Quando é o prazo do fornecedor que força a troca, quem depende da integração ainda precisa entregar o que já estava em andamento.

A Assistants API foi encerrada em 26 de agosto de 2026. A OpenAI orientou a migração para Responses e Conversations. Esse prazo devia ficar do lado da lista de capacidades, porque uma dependência pode continuar servindo ao produto e o fornecedor ainda assim obrigar a mudar o jeito de usar.

Uma integração acumula decisões fora do seletor de modelos. Como identificar uma sessão? De onde retomar uma execução interrompida? O que precisa sobreviver da conversa pra atender o usuário? Se essas informações só fazem sentido dentro da interface do fornecedor, pra sair, primeiro tenho que descobrir o que significa o que ficou guardado lá.

Prefiro separar cedo o que é do produto e o que é conveniência da API. O objetivo e os artefatos de uma tarefa precisam continuar compreensíveis. Uma camada abstrata enorme, escrita antes de existir trabalho real, também cobra manutenção. Eu começaria pelos dados que de fato precisam sobreviver à troca e pela forma de recuperá-los.

Compilar a migração resolve só parte da verificação. O agente pode continuar respondendo e passar a trabalhar de outro jeito. Pra conferir isso, quero tarefas representativas com resultado esperado registrado antes da mudança. Detalhes de redação podem variar; o comportamento que atende ao pedido precisa permanecer verificável.

O prazo anunciado ajuda a reservar tempo, mas ninguém migra por receber um lembrete. Quando avalio uma dependência, exijo um caminho legível pra levar uma tarefa em andamento: objetivo, artefatos e informação suficiente pra continuar. Vou incluir esse esforço na conta da integração. Se a saída depende de reexplicar tudo do zero, o preço de entrada estava escondendo boa parte do trabalho.

O custo de sair da API entra na conta desde o começo | The Broad Way