O que acontece em 26 de agosto de 2026
A documentação oficial da OpenAI informa que a Assistants API foi descontinuada depois que a Responses API alcançou paridade de recursos e que o desligamento está previsto para 26 de agosto de 2026. Esta matéria foi verificada em 26 de agosto de 2026; a documentação não informa um horário único para todas as integrações.
Na prática, quem mantém um agente baseado em Assistants, Threads ou Runs precisa tratar a data como um prazo operacional. Uma página continuar abrindo não prova que cada chamada legada continuará disponível, e a migração precisa ser validada no ambiente e nas bibliotecas usados pelo projeto.
A arquitetura muda de nomes e de responsabilidade
O guia oficial apresenta a troca de Assistants por Prompts, Threads por Conversations, Runs por Responses e Run steps por Items. A nova organização separa a configuração comportamental do agente da orquestração feita pela aplicação.
A OpenAI também orienta que prompts reutilizáveis sejam versionados no dashboard e que o código passe a controlar partes como histórico, chamadas de ferramentas, tentativas e tratamento de resultados. Isso pode exigir mais trabalho na aplicação, mas deixa o fluxo explícito para revisão e testes.
Checklist para quem ainda usa a Assistants API
Faça a migração por etapas e registre o que foi testado. O objetivo é preservar o comportamento necessário sem levar credenciais ou dados de produção para uma tentativa improvisada.
- Liste as integrações que usam Assistants, Threads, Runs, mensagens, arquivos e ferramentas legadas.
- Identifique o conjunto de instruções, modelo e ferramentas de cada Assistant e recrie o comportamento como um Prompt versionado quando essa for a rota escolhida.
- Passe as novas conversas para Conversations e Responses antes de tentar migrar todo o histórico.
- Planeje o tratamento dos Threads antigos: a documentação informa que não haverá uma ferramenta automática para essa migração.
- Teste respostas, chamadas de ferramentas, arquivos, limites, custos, logs e falhas em um ambiente separado.
- Mantenha uma janela de rollback documentada e só remova o caminho antigo depois de confirmar as métricas do fluxo real.
O que a Responses API acrescenta para agentes
Na documentação de migração, a OpenAI descreve a Responses API como o caminho mais simples e flexível para enviar itens de entrada e receber itens de saída. O mesmo material aponta suporte a recursos como MCP, pesquisa aprofundada e uso do computador, conforme a configuração e a disponibilidade da conta.
Isso não significa que qualquer agente ficará pronto apenas trocando o endpoint. Cada ferramenta precisa de permissões, validação de entradas, limites de tempo, registro de eventos e tratamento de falhas compatíveis com o risco da operação.
Limites e cuidados de segurança
A migração de API não é uma auditoria de segurança. Ela não garante que um prompt, plugin, MCP, repositório ou ferramenta de terceiros seja confiável, nem prova que a aplicação está protegida contra exposição de dados ou execução indevida.
Antes de colocar o novo fluxo em produção, revise tokens, permissões, arquivos acessíveis, destinos de rede, logs e dados pessoais. Faça um teste com credenciais restritas e confirme que uma falha de ferramenta não libera ações além do necessário.
Adaptação internacional
Esta matéria foi publicada primeiro em português para atender buscas no Brasil. A estrutura está preparada para adaptação futura em inglês e espanhol, mantendo a mesma fonte oficial, a data do desligamento e os avisos de compatibilidade.
Faça o próximo teste
Fontes consultadas
Os links abaixo servem para conferir conceitos, orientações oficiais e o critério editorial usado neste conteúdo.
- Assistants migration guideOpenAI Developers
- Assistants API v2 FAQOpenAI Help Center
- OpenAI Agents SDKOpenAI