
A OpenAI definiu oficialmente o dia 26 de agosto de 2026 como a data de encerramento da sua Assistants API. Se o seu software usa essa API, você precisará migrar seu código antes desse prazo para evitar que recursos parem de funcionar. O aviso apareceu pela primeira vez na lista de OpenAI API deprecations em 20 de agosto de 2025, embora a OpenAI não tenha divulgado o horário exato do corte final.
Como funciona a nova estrutura
Para substituir o sistema antigo, a OpenAI orienta os desenvolvedores a utilizarem a Responses API e a Conversations API. O guia oficial Assistants migration guide detalha como a estrutura antiga é convertida:
- Assistants se tornam prompts.
- Threads viram
Conversations. - Runs se tornam
Responses. - Run steps viram itens gerais.
Uma resposta pode usar itens de entrada direta ou um objeto de conversa. Essa mudança exige mais trabalho no seu backend. O código da sua própria aplicação agora deve cuidar da orquestração, incluindo limpeza de histórico, novas tentativas de requisição e loops de chamadas de ferramentas.
Duas armadilhas para ficar atento
Primeiro, a OpenAI não disponibiliza nenhuma ferramenta automatizada para converter Threads antigas nas novas Conversations. Você terá que fazer isso manualmente. O guia sugere direcionar as novas conversas pela nova API primeiro e depois copiar o histórico das conversas antigas apenas quando necessário.
Segundo, a migração de prompts tem seu próprio prazo. O guia menciona objetos de prompt, mas a OpenAI alerta que objetos de prompt reutilizáveis também estão sendo descontinuados. Você deve verificar esse cronograma antes de finalizar sua arquitetura.
O que a documentação não comprova
Os documentos da OpenAI confirmam a data de encerramento e a nova estrutura, mas não garantem velocidade ou preços equivalentes. Ninguém fora da empresa verificou a latência, custos de tokens ou qualidade das respostas entre os dois sistemas. A documentação também não estabelece uma interrupção global em tempo real em todas as contas ou regiões.
Como testar sua migração
Comece sua migração com antecedência. Não deixe para a correria de última hora.
Comece listando cada assistente, thread, run, ferramenta personalizada e caminho de arquivo em sua base de código. Em seguida, crie um fluxo de teste usando a Responses API e a Conversations API. Reproduza conversas salvas e chamadas de ferramentas em várias etapas em ambos os sistemas. Compare lado a lado a qualidade das respostas, o uso de tokens, a latência e a recuperação de erros. Mantenha ambos os caminhos monitoráveis até ter certeza de que sua nova aplicação funciona de forma estável.
