For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Navegação principal
Theme

Como usar o GPT-6

Seleção de modelos, criação de prompts e migração do GPT-5.6.

  • GPT-6 Astra

    O mais inteligente

    Para as tarefas mais exigentes de raciocínio, programação e trabalho profissional.

  • GPT-6.1 Sol

    Equilíbrio entre velocidade, custo e inteligência

    Desempenho próximo ao do Astra em tarefas complexas, a um custo menor.

  • GPT-6.1 Terra

    Rápido e eficiente

    Para raciocínio visual, uso preciso do computador e escrita clara e natural.

  • GPT-6 Luna

    O mais rápido e com o melhor custo-benefício

    Alto desempenho em tarefas de escopo específico executadas em grande volume.

Para começar, defina model em uma solicitação à API Responses. Se você já usa gpt-6-sol, consulte as orientações de migração antes de mudar para o GPT-6.1 Sol.

GPT-6 Astra

O GPT-6 Astra é nosso modelo mais inteligente até agora, com desempenho de ponta em uso do computador, navegação, engenharia de software, ciência e trabalho profissional. Ele consegue executar fluxos de trabalho de várias etapas que envolvem código, navegadores e softwares profissionais. Em diversas avaliações, o Astra obteve resultados melhores com bem menos tokens de saída. Apesar do preço mais alto por token, o custo estimado por tarefa na API foi menor que o dos modelos anteriores.

O GPT-6 Astra também é nosso modelo mais alinhado até agora. Ele se destaca por agir com cuidado, respeitar os limites da tarefa e se comunicar com transparência. Quando as instruções dão margem a interpretação, ele usa o contexto disponível para resolver questões de rotina e faz perguntas específicas quando a resposta pode mudar o resultado. Ele incorpora novos requisitos, muda de direção quando solicitado e responde a perguntas paralelas sem perder de vista a tarefa como um todo.

Todos os usuários do GPT-6 Astra também têm acesso ao modo Fast e ao novo modo ultrarrápido para obter as maiores velocidades disponíveis na API.

GPT-6.1 Sol

O GPT-6.1 Sol oferece desempenho próximo ao do Astra a um custo menor em tarefas complexas de programação, uso do computador e trabalho profissional. Ele oferece suporte aos níveis de esforço de raciocínio low, medium (padrão), high, xhigh e max.

Consulte as especificações e os preços na página do modelo.

GPT-6.1 Terra

O GPT-6.1 Terra é um modelo rápido e eficiente para raciocínio visual, uso preciso do computador e escrita clara e natural. Use-o para associar fotos de produtos aos itens correspondentes de um catálogo, comparar desenhos técnicos, interagir com telas de aplicativos ou redigir e revisar textos.

Ele oferece suporte aos níveis de esforço de raciocínio none, low, medium (padrão), high, xhigh e max. Comece com medium e aumente o nível se o ganho de qualidade justificar o tempo e os tokens adicionais.

Ao migrar do GPT-5.6 Terra, compare os dois modelos usando imagens e fluxos de trabalho representativos, com o mesmo esforço de raciocínio. Se o seu aplicativo chama ferramentas via Chat Completions, migre essas solicitações para a API Responses.

Consulte a página do modelo para ver especificações e preços, o guia de entradas de imagem para análise visual e o guia de uso do computador para interagir com telas.

Novidades

  • Chamada assíncrona de ferramentas: O GPT-6 pode continuar raciocinando, chamar outras ferramentas ou responder a partes independentes de uma solicitação enquanto seu aplicativo executa uma ferramenta. Defina async: true em uma função ou ferramenta personalizada e, quando o resultado estiver pronto, retorne-o usando o call_id original. Seu aplicativo continua responsável por executar a ferramenta e gerenciar o trabalho pendente. Consulte Chamada assíncrona de ferramentas para ver o uso básico e um padrão de implementação de uma ferramenta de espera definida pelo desenvolvedor.
  • Orientações durante o turno: Envie instruções adicionais do usuário enquanto o GPT-6 trabalha, por exemplo, uma correção ou uma mudança nos requisitos. Em uma conexão WebSocket, a API Responses preserva o trabalho concluído e incorpora a atualização ao dar continuidade à execução. Consulte Orientações durante o turno para entender o fluxo de eventos e como lidar com os resultados das ferramentas.
  • Alteração do raciocínio durante a conversa com preservação do cache: Adicione um item de entrada configuration_update para aumentar o esforço de raciocínio em tarefas difíceis ou reduzi-lo em solicitações subsequentes de rotina, sem reescrever o prefixo do prompt original. O novo esforço de raciocínio permanece em vigor até que outro item de entrada configuration_update o substitua. Consulte Alteração do raciocínio durante a conversa para ver exemplos e informações de compatibilidade.
  • Monitoramento de desalinhamento: Como parte do reforço das medidas de proteção do GPT-6 Astra, nossos sistemas monitoram de forma assíncrona sinais de desalinhamento e emitem alertas quando necessário. Consulte Monitoramento de desalinhamento para saber mais.

O GPT-6 também oferece suporte aos recursos da API já disponíveis no GPT-5.6, incluindo uso do computador, saídas estruturadas, streaming, chamada programática de ferramentas, orquestração de múltiplos agentes, cache de prompts, persistência do raciocínio, compactação e modo pro.

Limitações

  • O GPT-6 Astra e o GPT-6.1 Sol não oferecem suporte ao esforço de raciocínio none. O GPT-6.1 Terra, o GPT-6 Sol e o GPT-6 Luna oferecem suporte a esse nível.
  • O modo Fast oferece suporte à residência de dados na UE para o GPT-6.1 Sol, o GPT-6.1 Terra e o GPT-6 Luna, mas não para o GPT-6 Astra ou o GPT-6 Sol. O modo ultrarrápido do GPT-6.1 Sol oferece suporte à residência de dados nos EUA e na UE e ao processamento global. No GPT-6 Astra, o modo ultrarrápido oferece suporte apenas à residência de dados nos EUA e ao processamento global. Consulte os critérios de elegibilidade para residência de dados.

Boas práticas para criar prompts

Use os prompts a seguir como ponto de partida para os modelos da família GPT-6. Eles abordam comportamentos observados no GPT-6 Astra. Avalie-os com o modelo escolhido e com a carga de trabalho do seu aplicativo.

Comportamento do GPT-6 Astra

  • Iniciativa e persistência: O modelo foi projetado para colaborar de forma mais eficaz. Por isso, tende a fazer perguntas ao usuário quando informações adicionais podem mudar significativamente o resultado. Isso pode levá-lo a interromper o trabalho quando o usuário espera que ele faça suposições razoáveis e prossiga.
  • Cumprimento de instruções: De modo geral, o GPT-6 Astra segue instruções melhor que nossos modelos anteriores, o que dá a você mais controle sobre o comportamento dele. O modelo pode ser mais sensível às instruções contidas em habilidades e outros arquivos, como AGENTS.md. Recomendamos enfaticamente que você audite as habilidades e os demais arquivos acessíveis ao modelo em busca de instruções que possam influenciar seu comportamento.
  • Personalidade e estilo de escrita: O modelo tende a produzir respostas detalhadas e formatadas e pode repetir certas expressões em diferentes sessões. Especifique o estilo de escrita e a estrutura de que seu aplicativo precisa.
  • Delegação a subagentes: O modelo pode delegar com menos frequência do que seu fluxo de trabalho exige. Especifique quando e em que medida ele deve usar subagentes para trabalhar em paralelo.
  • Testes e verificação: Em tarefas de programação, o modelo tende a testar minuciosamente antes de considerar o trabalho concluído. Em tarefas menores, isso pode resultar em testes mais abrangentes do que o necessário.

Iniciativa e persistência

Em geral, o GPT-6 Astra mantém a coerência ao longo de tarefas extensas melhor que o GPT-5.6 Sol e os modelos anteriores. Ele também tende a pedir esclarecimentos em situações nas quais os modelos anteriores fariam suposições.

Para incentivar o trabalho autônomo, comece com este prompt:

Use as instruções e o contexto da conversa até aqui para identificar a intenção do usuário e o escopo da tarefa. Tome a iniciativa e leve até o fim a tarefa que o usuário tem em mente.

Quando o usuário indicar que quer iniciar um trabalho ou corrigir um problema, prossiga até alcançar o resultado pretendido. Execute as etapas com autonomia, a menos que sejam claramente destrutivas ou irreversíveis. Por exemplo, crie árvores de trabalho ou checkouts isolados se necessário, resolva conflitos de merge, execute ações de somente leitura ou abra pull requests em rascunho.

Quando a intenção do usuário não está clara, o modelo tende a pedir esclarecimentos antes de prosseguir. Oriente-o a levar a tarefa até o fim quando o prompt do usuário indicar que ele já autorizou a ação:

Quando o prompt do usuário indicar um pedido de ação com expressões como "você pode...", "quero..." ou "me ajude a...", interprete o pedido como uma instrução e execute o trabalho. Não se limite a dizer que consegue fazer a tarefa (por exemplo, "Sim…"), a propor um plano ou a se oferecer para continuar. Não entregue uma solução parcial ou apenas "útil o bastante" para economizar tempo, esforço ou tokens. Atenda ao pedido por completo. Se a tarefa exigir trabalho contínuo, execute todas as etapas necessárias até alcançar o resultado pretendido.

Oriente o modelo a pedir aprovação só depois de preparar um resultado concreto que o usuário possa revisar. Isso evita que a tarefa fique parada antes que o modelo faça o trabalho que já pode executar e muitas vezes permite concluí-la mais rápido.

Antes de pedir esclarecimentos ao usuário, conclua o trabalho que o contexto já autoriza e que é necessário para preparar um resultado concreto que o usuário possa revisar. É esse resultado que você deve apresentar para aprovação. Por exemplo, se a ação proposta for implantar uma mudança, gravar dados em um aplicativo externo, fazer o merge de um pull request ou publicar um site, conclua primeiro todos os preparativos. Peça a aprovação do usuário como última etapa antes de executar a ação. Você não precisa pedir permissão para tarefas reversíveis, ações de somente leitura, revisões, correções ou qualquer ação que o usuário já tenha autorizado na sessão ou cuja autorização esteja claramente implícita no pedido.

Não acrescente avisos, ressalvas, etapas de aprovação ou listas de verificação de segurança ou conformidade que o usuário não pediu só porque pode haver um risco hipotético.

Por padrão, o modelo também costuma fazer perguntas enquanto trabalha, mesmo quando pode prosseguir sem a resposta. Ajuste esses prompts ao nível de autonomia de que seu aplicativo precisa.

Cumprimento de instruções

O GPT-6 Astra consegue seguir instruções mais longas com maior precisão, mas também pode ser mais sensível às informações presentes no contexto. Por exemplo, orientações ambíguas ou conflitantes em um arquivo de habilidade podem fazer o modelo interromper o trabalho logo no início. Explicite a ordem de prioridade entre as instruções do usuário e as das habilidades.

As instruções do usuário têm prioridade sobre as orientações de uma habilidade. Se uma instrução explícita do usuário entrar em conflito com uma instrução da habilidade, siga a instrução do usuário.

Pedir ao modelo que identifique a habilidade e a instrução que o levaram a pausar ou mudar de direção também ajuda a tornar seu comportamento mais transparente.

Se uma habilidade levar você a pedir permissão ou confirmação, interromper o trabalho, deixar a tarefa incompleta ou se afastar da intenção do usuário, informe o nome e o link do arquivo SKILL.md específico que você leu. Cite a instrução relevante e explique brevemente como ela se aplica ao caso. Deixe claro o que a habilidade exige explicitamente e o que decorre da sua interpretação das orientações.

Use esse prompt para identificar orientações que passam despercebidas ou entram em conflito quando seu aplicativo carrega muitas habilidades e arquivos de instruções, como AGENTS.md.

Personalidade e estilo de escrita

O GPT-6 Astra costuma usar listas, tabelas e Markdown para facilitar a leitura rápida das respostas. Se seu aplicativo precisa de texto corrido com menos formatação, indique essa preferência.

Por padrão, escreva parágrafos claros e concisos, cada um com uma ideia principal. Use listas apenas quando os itens forem da mesma natureza, seguirem uma sequência ou ficarem mais fáceis de comparar nesse formato. Evite listas com subitens, a menos que seja impossível expressar a hierarquia com clareza em texto corrido. Use linguagem simples, com palavras familiares, exemplos concretos e verbos precisos. Prefira a voz ativa e frases diretas.

Apresente o ponto principal com clareza logo no início. Em seguida, desenvolva a ideia com as explicações e os detalhes de que o leitor precisa. Conecte cada frase à anterior. Aprofunde os pontos importantes e dê ao leitor elementos suficientes para que a explicação seja útil.

Na comunicação técnica, o prompt a seguir ajuda o modelo a escrever com clareza e coerência usando uma linguagem adequada à área:

Prefira a linguagem simples ao jargão. Inclua detalhes técnicos apenas na medida em que ajudem o usuário a entender uma ideia ou o trabalho que você fez. Explique conceitos complexos com clareza, conecte as ideias e ajuste o texto ao conhecimento prévio que o prompt e o contexto do usuário sugerem.

Para reduzir o uso de jargão e frases prontas, comece com este prompt:

Evite palavras e expressões desgastadas, como "Em última análise:" nas conclusões, "mergulhar a fundo", "fomentar", "alavancar", "vale destacar", "é importante ressaltar" ou "genuinamente". Evite fórmulas como "Pergunta? Resposta." ou "Não se trata de X. Trata-se de Y.", além de descrições e adjetivos compostos com hífen. Evite encerrar o texto com fórmulas de resumo como "Em poucas palavras:..." ou "O modelo mental mais simples é:...".

Diga diretamente o que pretende fazer. Evite acrescentar o que você deixará de fazer, o que continuará igual ou como vai separar ou classificar os resultados. Evite contrastes como "X, e não Y" que introduzam uma alternativa que o usuário não mencionou. Evite rótulos compostos inventados, como "verificações de revisão-exata" e "layouts de linha-editorial", qualificadores vagos e transições prontas. Use verbos e preposições simples para expressar diretamente a relação entre as ideias.

Delegação a subagentes

O GPT-6 Astra foi treinado para dividir o trabalho e delegar tarefas a subagentes que atuam em paralelo. Se você estiver implementando um sistema com múltiplos agentes no seu harness, use o prompt a seguir para ajustar quanto trabalho o GPT-6 Astra deve delegar:

Se em algum momento você puder dividir o trabalho e delegar tarefas a outro agente para executá-las em paralelo, use as ferramentas de colaboração sempre que isso puder poupar tempo ou melhorar a qualidade do resultado. Essa orientação vale tanto para o agente principal quanto para um subagente.

As mensagens entre agentes podem conter erros de gramática ou de espaçamento. Use este prompt para facilitar a leitura dessas mensagens:

Uma pessoa pode ler tanto as mensagens que você envia a outros agentes quanto sua resposta final. Escreva de forma legível. Use sempre os espaços adequados entre palavras, entre números e entre palavras e números.

O modelo costuma responder bem a instruções sobre como e quando delegar trabalho a subagentes. Ajuste esse comportamento de acordo com seu harness e sua implementação do sistema de múltiplos agentes.

Testes e verificação

Em tarefas de programação, ajuste a abrangência dos testes e das verificações de acordo com a mudança. Isso ajuda a evitar testes desnecessários ou verificações repetidas em alterações pequenas.

Para mudanças reversíveis e de baixo impacto, não escreva testes que apenas reproduzam a implementação. Se decidir verificar seu trabalho com testes, garanta que eles sejam relevantes e necessários para validar a implementação.

Execute os testes adequados à mudança e conclua as verificações obrigatórias. Depois que todos passarem, só amplie ou repita os testes se houver novas alterações, falhas ou questões em aberto que justifiquem isso. Caso contrário, prossiga com a tarefa até concluí-la.

Guia rápido de migração

Migre com o Codex

O Codex pode aplicar as mudanças recomendadas neste guia com a habilidade OpenAI Docs.

$openai-docs migre este projeto para a família de modelos GPT-6

Para usar essa habilidade em outros agentes de programação, baixe-a do repositório do Codex.

Atualize os parâmetros da API e do modelo

Defina model como gpt-6-astra, gpt-6.1-sol, gpt-6.1-terra ou gpt-6-luna e confira os pontos a seguir:

  • Esforço de raciocínio: Mantenha o nível de esforço de raciocínio atualmente em vigor, se houver suporte. O GPT-6 Astra e o GPT-6.1 Sol não oferecem suporte a none. Nesses modelos, use low. O GPT-6.1 Terra, o GPT-6 Sol e o GPT-6 Luna oferecem suporte a none. Se a solicitação atual usa minimal, comece com low e compare os resultados em tarefas representativas. Use reasoning.effort na API Responses ou reasoning_effort em Chat Completions.
  • Chamada de ferramentas: Use a API Responses. O GPT-6 Astra, o GPT-6.1 Sol e o GPT-6.1 Terra oferecem suporte a Chat Completions, mas a chamada de ferramentas exige a API Responses. O GPT-6 Sol e o GPT-6 Luna oferecem suporte à chamada de função em Chat Completions apenas com reasoning_effort: "none". Use a API Responses para combinar raciocínio e uso de ferramentas.
  • Parâmetros sem suporte: Quando o esforço de raciocínio for diferente de none, remova temperature, top_p e top_logprobs. Em Chat Completions, remova também logprobs. Na API Responses, remova message.output_text.logprobs de include.
  • Residência de dados: O modo Fast oferece suporte à residência de dados na UE para o GPT-6.1 Sol, o GPT-6.1 Terra e o GPT-6 Luna, mas não para o GPT-6 Astra ou o GPT-6 Sol. O modo ultrarrápido do GPT-6.1 Sol oferece suporte à residência de dados nos EUA e na UE e ao processamento global. No GPT-6 Astra, o modo ultrarrápido oferece suporte apenas à residência de dados nos EUA e ao processamento global. O modo Fast do GPT-6 Astra não inclui um SLA de latência. Consulte a compatibilidade do modo Fast.
  • Alteração do esforço de raciocínio: Se seu aplicativo altera o esforço entre respostas, use itens configuration_update em solicitações padrão com um único agente. Mantenha reasoning.effort inalterado no nível da solicitação para preservar o prefixo do prompt para uso no cache. Confira os limites de compatibilidade antes de adotar esse recurso.
  • Cache de prompts: Ao migrar do GPT-5.5 ou de uma versão anterior, substitua prompt_cache_retention por prompt_cache_options.ttl com o valor "30m". Consulte as mudanças no cache de prompts, incluindo os limites do cache e a cobrança por gravação no cache.
  • Pausas desnecessárias para aprovação: Se o modelo pedir aprovação repetidamente antes de prosseguir, use as orientações sobre iniciativa e persistência para incentivá-lo a trabalhar com mais autonomia. Consulte as demais boas práticas para criar prompts para obter orientações sobre cumprimento de instruções, estilo de escrita, delegação a subagentes e testes.

Modelos anteriores

Como usar o GPT-5.5

Conheça os recursos do GPT-5.5 e as práticas recomendadas para usá-lo e fazer a migração.

Introdução

O GPT-5.5 eleva o nível de desempenho em fluxos de trabalho complexos em produção. Ele é especialmente indicado para programação, agentes que usam ferramentas intensivamente, assistentes que fundamentam respostas em fontes, recuperação de informações em contextos longos, criação de planos a partir de especificações de produto e interações com clientes que exigem execução de alta qualidade e respostas bem elaboradas.

Para aproveitar ao máximo o GPT-5.5, trate-o como uma nova família de modelos que exige ajustes próprios. Evite usá-lo como substituto direto do gpt-5.2 ou do gpt-5.4. Comece a migração estabelecendo uma nova referência de desempenho, sem importar todas as instruções do conjunto de prompts anterior. Parta do menor prompt que preserve o comportamento exigido pelo produto. Depois, use exemplos representativos para ajustar o esforço de raciocínio, o nível de detalhamento, as descrições das ferramentas e o formato de saída.

O GPT-5.5 oferece todos os recursos da API já disponíveis com o GPT-5.4, incluindo cache de prompts, ferramentas hospedadas, busca de ferramentas, compactação e tratamento de phase ao reenviar manualmente itens do assistente.

Veja exemplos de padrões eficazes em Práticas recomendadas para prompts.

Novidades

  • Raciocínio mais eficiente: o GPT-5.5 alcança bons resultados com menos tokens de raciocínio do que os modelos anteriores, mesmo com o mesmo nível de esforço. Isso é especialmente útil em fluxos complexos, com uso intensivo de ferramentas ou com várias etapas, nos quais a economia de tokens se acumula.
  • Melhor execução de tarefas com prompts focados no resultado: o GPT-5.5 está mais apto a partir de um objetivo claro, respeitar restrições e converter a intenção do produto em próximos passos concretos. Descreva o resultado esperado, os critérios de sucesso, os efeitos colaterais permitidos, as regras para o uso de evidências e a estrutura da saída. Evite detalhar o processo passo a passo, a menos que seja importante seguir um caminho específico.
  • Uso mais eficaz e preciso de ferramentas: o GPT-5.5 é especialmente útil quando há muitas ferramentas disponíveis, em fluxos de serviços com várias etapas e em tarefas de longa duração executadas por agentes. Ele tende a ser mais preciso ao selecionar ferramentas e usar seus argumentos.
  • O tom costuma ser mais elaborado, mas pode ser mais direto: o GPT-5.5 costuma produzir respostas mais acolhedoras e fáceis de ler, mesmo com menos orientações no prompt.

Mudanças de comportamento

  1. O esforço de raciocínio padrão agora é medium: o GPT-5.5 usa medium por padrão para o esforço de raciocínio. Use medium como ponto de partida recomendado para equilibrar qualidade, confiabilidade, latência e custo. Em fluxos sensíveis à latência, avalie low antes de none se o uso de ferramentas, o planejamento, a busca ou a tomada de decisões em várias etapas ainda forem importantes. Reserve none para tarefas em que a latência é crítica e que dispensam raciocínio e chamadas encadeadas de ferramentas, como interações simples por voz, recuperação rápida de informações e classificação. Aumente o esforço para high ou xhigh somente quando as avaliações demonstrarem um ganho mensurável de qualidade que justifique a latência e o custo adicionais. Consulte a documentação sobre modelos de raciocínio para saber mais sobre as configurações recomendadas.

    Aumentar o esforço de raciocínio nem sempre melhora o resultado. Se a tarefa tiver instruções conflitantes, critérios de parada pouco claros ou acesso a ferramentas sem limites definidos, um esforço maior pode levar a análises excessivas, buscas desnecessárias ou perda de qualidade na saída. Aumente o esforço somente quando as avaliações demonstrarem um ganho mensurável de qualidade.

  2. As imagens de entrada preservam mais detalhes visuais por padrão: o GPT-5.5 mudou a forma como processa imagens por padrão para preservar mais detalhes visuais e melhorar o desempenho do Uso do computador. Quando image_detail não é definido ou está definido como auto, o modelo agora adota o comportamento de original e mantém a imagem sem redimensionamento até o limite de 10.240.000 pixels no total ou de 6.000 pixels em qualquer dimensão, o que for atingido primeiro. Para usar high, especifique o valor diretamente. Nesse modo, os limites para preservar a imagem sem redimensionamento são de 2.500.000 pixels no total e de 2.048 pixels em qualquer dimensão. O modo low agora prioriza o uso eficiente do contexto e reduz de forma mais acentuada do que os modelos anteriores as imagens que ultrapassam 512 pixels em uma dimensão. Consulte a documentação sobre imagens e visão.

  3. Maior fidelidade às instruções: o GPT-5.5 interpreta os prompts de forma literal e minuciosa, o que permite usar instruções específicas e descritivas quando o produto exigir. Defina critérios de sucesso e regras de parada, especialmente em fluxos de longa duração, com uso intensivo de ferramentas ou que envolvam coleta de evidências. Consulte Como escrever prompts focados no resultado e Como definir o nível de detalhe adequado.

  4. O estilo padrão é mais conciso e direto: por padrão, o GPT-5.5 tende a ser eficiente, direto e focado na tarefa. Isso é útil em muitos fluxos de produção, mas experiências de conversa ou de atendimento ao cliente podem exigir orientações explícitas sobre personalidade, cordialidade, justificativas e formatação. Escolha text.verbosity de acordo com a experiência desejada. O padrão é medium, e low costuma ser um ponto de partida melhor para respostas concisas. Consulte as Práticas recomendadas para prompts.

  5. Fluxos de programação exigem uma orquestração mais cuidadosa: o GPT-5.5 está mais apto a lidar com tarefas complexas de programação que exigem planejamento, uso de ferramentas, navegação pela base de código, verificação e execução em várias etapas. Para agentes de programação, especifique o que reutilizar, quando delegar a subagentes, quais testes executar, quais são os critérios de aceitação e quando continuar ou pedir ajuda.

Guia rápido de migração

Migração automatizada com o Codex

O Codex pode aplicar as mudanças recomendadas neste guia com a habilidade OpenAI Docs.

$openai-docs migre este projeto para gpt-5.5

Para usar essa habilidade em outros agentes de programação, baixe-a do repositório de habilidades da OpenAI.

API e parâmetros do modelo

  • Atualize o slug do modelo para gpt-5.5.
  • Use a API Responses em qualquer caso de uso que envolva raciocínio, chamadas de ferramentas ou interações em vários turnos.
  • Ajuste reasoning.effort. Use low para raciocínio eficiente, medium para equilibrar latência e desempenho, high para tarefas complexas com agentes de IA que exigem raciocínio aprofundado e toleram maior latência, e xhigh para as tarefas assíncronas mais difíceis com agentes de IA ou para avaliações que testam os limites da inteligência do modelo. Consulte a documentação sobre modelos de raciocínio.
  • Para obter respostas mais concisas, defina text.verbosity como low. No GPT-5.5, isso produz respostas proporcionalmente mais concisas do que o nível low no GPT-5.4.
  • Em fluxos de longa duração ou com uso intensivo de ferramentas, verifique se o aplicativo trata corretamente phase, os preâmbulos e o reenvio de itens do assistente.
  • Compare o modelo com outros em termos de exatidão, consumo de tokens e latência de ponta a ponta.

Criação de prompts

Como usar modelos de raciocínio

Estas orientações se aplicam aos modelos da série GPT-5 e merecem ser revistas sempre que uma equipe migra cargas de trabalho para modelos de raciocínio. O GPT-5.5 mantém muitos recursos introduzidos em modelos anteriores. Vale a pena revisitá-los se você estiver migrando de um modelo GPT-5 anterior, do GPT-4.1 ou de um modelo de raciocínio como o o3.

Esses recursos podem passar despercebidos porque dependem, em parte, da configuração da API e da orquestração, além do próprio prompt. Em conjunto, a API Responses, os controles de raciocínio, o nível de detalhamento, as saídas estruturadas, o cache de prompts, o design das ferramentas, as ferramentas hospedadas e o gerenciamento de estado ajudam a aproveitar melhor a inteligência dos modelos de raciocínio e a obter a melhor combinação de confiabilidade, latência e custo.

  • API Responses: o GPT-5.5 funciona melhor com a API Responses. Use previous_response_id para gerenciar o estado entre turnos. Em fluxos sem estado ou com zero retenção de dados, reenvie a cada turno os itens de saída relevantes retornados pela API. Para saber mais, consulte Como passar o contexto da resposta anterior.
  • Esforço de raciocínio: use reasoning.effort para escolher entre low, medium, high ou xhigh. O padrão é medium, mas muitas cargas de trabalho apresentam bom desempenho com low. Reserve none para casos em que a baixa latência seja mais importante do que a inteligência. Consulte Modelos de raciocínio para ver recomendações detalhadas.
  • Nível de detalhamento: use text.verbosity para controlar a extensão da saída. Trate a extensão da resposta final separadamente da qualidade do raciocínio. Quando necessário, especifique um limite de palavras, o número de seções, a largura das tabelas ou a exigência de que a saída contenha apenas JSON.
  • Saídas estruturadas: evite descrever no prompt o schema de saída esperado. Use saídas estruturadas para validar a saída automaticamente e aumentar a exatidão.
  • Cache de prompts: o cache de prompts funciona automaticamente em prompts longos que atendem aos requisitos e pode reduzir a latência e o custo dos tokens de entrada. Para aumentar a taxa de acertos do cache, mantenha o conteúdo estável no início da requisição. Coloque o contexto dinâmico específico do usuário perto do fim. Monitore usage.prompt_tokens_details.cached_tokens para medir o reaproveitamento. Use uma prompt_cache_key estável para requisições que compartilham um prefixo reutilizável. A chave ajuda a direcionar requisições relacionadas para o mesmo cache e é importante para otimizar a taxa de acertos no GPT-5.5. Para grupos com alto volume de requisições, siga as orientações para distribuir o tráfego entre mais chaves.
  • Chamadas de ferramentas: o GPT-5.5 aceita os mesmos padrões de chamada de ferramentas do GPT-5.4, incluindo ferramentas de função e fluxos de agentes que usam ferramentas intensivamente. Concentre a maior parte das orientações específicas na descrição de cada ferramenta. Explique o que ela faz, quando usá-la, quais entradas exige, quais são seus efeitos colaterais, quando é seguro repetir a chamada e quais erros costumam ocorrer. Inclua contexto específico de ferramentas nas instruções de sistema somente quando ele se aplicar a várias ferramentas ou alterar de forma significativa as regras de operação do agente.
  • Ferramentas hospedadas e busca de ferramentas: dê preferência às ferramentas hospedadas pela OpenAI quando elas atenderem às necessidades do fluxo, como Pesquisa na Web, busca em arquivos, Code Interpreter, geração de imagens e Uso do computador. As ferramentas hospedadas reduzem o trabalho de criar uma orquestração própria e mantêm os padrões comuns de uso de ferramentas alinhados à API Responses e ao SDK de agentes. Use ferramentas de função personalizadas quando precisar chamar seus próprios sistemas, garantir efeitos colaterais específicos do domínio ou disponibilizar fluxos internos de negócio. Para catálogos grandes, considere usar a busca de ferramentas para adiar o carregamento das definições e carregar apenas as ferramentas relevantes.
  • Preâmbulos de ferramentas: os preâmbulos podem melhorar a experiência no chat porque o usuário recebe uma atualização inicial útil antes de o modelo gerar a resposta final. Eles também facilitam o acompanhamento do uso de ferramentas. O modelo pode indicar o que vai verificar ou fazer e, quando os resultados chegarem, retomar a execução a partir do mesmo estado do assistente.
  • Tratamento de phase: se o aplicativo gerencia manualmente o estado da API Responses reenviando os itens de saída a cada turno em vez de usar previous_response_id, preserve o parâmetro phase nos itens de saída retornados pelo assistente e reenvie-o sem alterações. Isso é especialmente importante ao usar esforço de raciocínio, preâmbulos ou chamadas repetidas de ferramentas. Consulte Parâmetro phase.
  • Compactação: para agentes de longa duração, planeje o uso da compactação da conversa ou do estado. Preserve as ações concluídas, as premissas ainda válidas, os IDs, os resultados das ferramentas, os impedimentos ainda não resolvidos e o próximo objetivo concreto.
  • SDK de agentes: para novos sistemas com agentes de IA, adote os padrões mais recentes do SDK de agentes para orquestrar ferramentas, rastrear a execução, transferir o controle entre agentes e gerenciar o estado, sem precisar reconstruir a orquestração do zero.
  • Data atual: o GPT-5.5 sabe a data atual em UTC. Você pode omiti-la das instruções de sistema. Especifique a data ou o fuso horário somente quando o aplicativo precisar de um fuso horário próprio do negócio, da data de entrada em vigor de uma política, da data local do usuário ou de outra referência diferente de UTC.

Práticas recomendadas para prompts

O GPT-5.5 funciona melhor quando o prompt define o resultado e dá ao modelo liberdade para escolher uma solução eficiente. Em comparação com modelos anteriores, muitas vezes é possível usar prompts mais curtos e focados no resultado. Descreva o que caracteriza um bom resultado, quais restrições importam, quais evidências estão disponíveis e o que a resposta final deve conter.

Evite importar todas as instruções de um conjunto de prompts anterior. Prompts antigos costumam detalhar demais o processo porque os modelos anteriores precisavam de mais orientação para manter o foco. Com o GPT-5.5, esse excesso pode introduzir ruído, restringir as alternativas que o modelo explora ou produzir respostas mecânicas demais.

Use os padrões a seguir como ponto de partida. Adapte-os à interface do produto, às ferramentas, às avaliações e à experiência que você deseja oferecer ao usuário.

Personalidade e comportamento

Por padrão, o estilo do GPT-5.5 é eficiente, direto e focado na tarefa. Isso é útil em sistemas de produção porque as respostas mantêm o foco, fica mais fácil orientar o comportamento do modelo e a conversa dispensa rodeios.

Para assistentes que interagem com clientes, fluxos de suporte, experiências de orientação individual e outros produtos de conversa, defina tanto a personalidade quanto o estilo de colaboração.

  • A personalidade define como o assistente se expressa, incluindo tom, cordialidade, franqueza, formalidade, humor, empatia e cuidado com a redação.
  • O estilo de colaboração define como o assistente trabalha: quando faz perguntas, quando adota premissas, quanta iniciativa deve tomar, quanto contexto oferece, quando verifica o próprio trabalho e como lida com incertezas ou riscos.

Seja breve nas duas descrições. As instruções de personalidade devem orientar a experiência do usuário. As de colaboração devem orientar o comportamento durante a tarefa. Ambas precisam vir acompanhadas de objetivos claros, critérios de sucesso, regras de uso de ferramentas e condições de parada.

Exemplo de bloco de personalidade para um assistente equilibrado e focado na tarefa:

# Personalidade
Você é um colaborador competente, acessível, equilibrado e direto. Parta do princípio de que o usuário é competente e age de boa-fé. Responda com paciência e respeito e ofereça ajuda prática.

Se a solicitação já estiver clara o suficiente para começar, prossiga. Use o contexto e adote premissas razoáveis. Peça esclarecimentos somente se a informação que falta puder mudar a resposta de forma significativa ou gerar um risco relevante. Nesse caso, faça uma pergunta específica.

Seja breve sem ser seco. Dê contexto suficiente para que o usuário entenda a resposta e confie nela. Encerre por aí. Use exemplos, comparações ou analogias simples quando facilitarem a compreensão. Ao corrigir o usuário ou discordar dele, seja franco e construtivo. Quando alguém apontar um erro, reconheça-o com clareza e concentre-se em corrigi-lo.

Acompanhe o tom do usuário e mantenha o profissionalismo. Por padrão, evite emojis e palavrões, a menos que o usuário peça esse estilo explicitamente ou já tenha deixado claro que ele é adequado à conversa.

Exemplo de bloco de personalidade para um assistente expressivo e colaborativo:

# Personalidade
Converse com desenvoltura. Demonstre inteligência e curiosidade, use humor quando for adequado e preste atenção ao raciocínio do usuário. Se o problema ainda estiver pouco claro, faça perguntas que ajudem a defini-lo. Assim que tiver contexto suficiente, tome uma posição.

Seja cordial, colabore com o usuário e cuide da redação. Mantenha a conversa natural e animada, sem falar só para prolongá-la. Apresente seu próprio ponto de vista e leve em conta os objetivos e as restrições do usuário, sem se limitar a repetir a opinião dele.

Quando a tarefa exigir uma síntese ou orientação, pondere as informações e fundamente sua resposta. Quando tiver contexto suficiente, faça uma recomendação clara, explique as vantagens e desvantagens relevantes e diga com franqueza o que ainda é incerto.

Para produtos que pedem mais expressividade, inclua orientações explícitas sobre cordialidade, curiosidade, humor ou ponto de vista, mas mantenha o bloco curto. Use a personalidade para moldar a experiência. Objetivos pouco claros ou instruções ausentes precisam ser corrigidos nas orientações da tarefa.

Reduza o tempo até o primeiro token visível com um preâmbulo

Em aplicativos que exibem a resposta em streaming, os usuários percebem quanto tempo leva para o primeiro trecho aparecer. O GPT-5.5 pode passar algum tempo raciocinando, planejando ou preparando chamadas de ferramentas antes de exibir texto.

Em tarefas mais longas ou com uso intensivo de ferramentas, peça ao modelo para começar com um preâmbulo curto: uma atualização visível que confirme o recebimento da solicitação e indique o primeiro passo. Isso pode dar ao usuário a sensação de uma resposta mais rápida sem alterar a tarefa em si.

Use esse padrão quando a tarefa puder exigir mais de uma etapa, precisar de chamadas de ferramentas ou envolver um fluxo de longa duração executado por um agente.

Em tarefas com várias etapas, antes de fazer qualquer chamada de ferramenta, envie ao usuário uma mensagem curta que confirme o recebimento da solicitação e indique o primeiro passo. Use uma ou duas frases.

Para agentes de programação que distinguem as fases de uma mensagem, você pode dar uma instrução mais explícita:

Se a tarefa exigir chamadas de ferramentas, comece sempre com uma atualização intermediária, antes de produzir qualquer conteúdo no canal de análise. Nessa mensagem ao usuário, confirme o recebimento da solicitação e explique seu primeiro passo.

Prompts focados no resultado e condições de parada

O GPT-5.5 tem melhor desempenho quando o prompt define o resultado desejado, os critérios de sucesso, as restrições e o contexto disponível, e deixa o modelo escolher o caminho.

Para muitas tarefas, basta descrever o resultado desejado, sem prescrever cada etapa. Assim, o modelo pode escolher a estratégia de busca, a ferramenta ou a forma de raciocínio mais adequada à tarefa.

Prefira este tipo de instrução:

Resolva o problema do cliente do início ao fim.

Para atender aos critérios de sucesso:
- decida se o cliente é elegível com base na política e nos dados da conta disponíveis
- antes de responder, conclua qualquer ação autorizada que se aplique ao caso
- inclua completed_actions, customer_message e blockers na resposta final
- se faltarem evidências, peça apenas o dado que falta para prosseguir

Evite regras absolutas desnecessárias. Prompts antigos costumam usar termos rígidos como ALWAYS, NEVER, must e only para controlar o comportamento do modelo. Reserve esses termos para requisitos que valem em qualquer circunstância, como regras de segurança, campos obrigatórios de saída ou ações que jamais devem ocorrer. Para escolhas que exigem discernimento, como decidir quando buscar informações, pedir esclarecimentos, usar uma ferramenta ou continuar iterando, prefira definir critérios de decisão.

Evite este estilo de instrução, a menos que todas as etapas sejam realmente obrigatórias:

Primeiro examine A, depois examine B, depois compare cada campo, depois considere
todas as exceções possíveis, depois decida qual ferramenta chamar, depois chame a ferramenta,
depois explique todo o processo ao usuário.

Defina condições de parada explícitas:

Resolva a solicitação do usuário com o mínimo de ciclos de chamadas de ferramentas necessário. Reduzir o número de ciclos não pode comprometer a exatidão da resposta, a consulta a evidências alternativas disponíveis, os cálculos nem a inclusão das marcações de citação exigidas para afirmações factuais.

Após cada resultado, pergunte a si mesmo: "Já consigo responder ao pedido principal do usuário com evidências úteis e citações que sustentem as afirmações factuais?" Se sim, responda.

Defina como agir quando faltarem evidências:

Use apenas as evidências necessárias para responder corretamente, cite-as com precisão e encerre.

Formatação

O GPT-5.5 segue com precisão as orientações sobre o formato e a estrutura da saída. Use esse controle quando ele facilitar a compreensão ou adequar a resposta ao produto.

Defina text.verbosity e descreva a estrutura esperada da saída. Reserve estruturas mais elaboradas para os casos em que elas facilitam a compreensão ou em que a interface do produto exige um artefato com estrutura estável. O valor padrão de text.verbosity na API é medium. Use low quando preferir respostas mais curtas e concisas.

Formatação simples para conversas:

Use a formatação para facilitar a compreensão. Em conversas do dia a dia, explicações, relatórios, documentação e textos técnicos, use parágrafos simples por padrão. Mantenha a apresentação limpa e legível, sem deixar que a estrutura ofusque o conteúdo.

Use títulos, negrito, marcadores e listas numeradas com moderação. Recorra a esses recursos quando o usuário os solicitar, quando for preciso comparar ou classificar itens com clareza ou quando for difícil localizar as informações em texto corrido. Nos demais casos, prefira parágrafos curtos e transições naturais.

Respeite as preferências de formatação do usuário. Se ele pedir uma resposta sucinta, formatação mínima, texto sem marcadores ou sem títulos, ou uma estrutura específica, atenda ao pedido, a menos que haja um motivo importante para fazer diferente.

Especifique o público e a extensão desejada:

Escreva para um público executivo. Use menos de 400 palavras. Escreva parágrafos curtos e use marcadores apenas quando facilitarem a leitura rápida. Apresente primeiro a conclusão, depois o raciocínio e, por fim, as ressalvas.

Para edições, reescritas, resumos ou mensagens destinadas a clientes, diga ao modelo o que preservar antes de pedir que melhore o estilo. Esse padrão é útil quando você quer refinar o texto sem ampliá-lo.

Preserve, em primeiro lugar, o material solicitado, sua extensão, sua estrutura e seu gênero textual. Melhore a clareza, a fluidez e a correção do texto sem comentar os ajustes. Não acrescente afirmações nem seções, nem adote um tom mais promocional, a menos que o usuário peça isso explicitamente.

Fundamentação, citações e limites de recuperação de informações

Para obter respostas fundamentadas, inclua no prompt as regras de citação. Defina quais afirmações precisam de respaldo, o que conta como evidência suficiente e como o modelo deve agir quando faltarem evidências. A ausência de evidências não deve levar automaticamente a uma resposta categórica de “não”. Para mais detalhes e exemplos, consulte o guia de formatação de citações.

Defina um limite explícito para a recuperação de informações

Os limites de recuperação de informações funcionam como regras de parada para a busca. Eles indicam ao modelo quando já há evidências suficientes para responder.

Para perguntas comuns, comece com uma única busca ampla e use palavras-chave curtas que ajudem a distinguir os resultados relevantes. Se os primeiros resultados trouxerem evidências suficientes que você possa citar para responder ao pedido principal, use esses resultados para responder, sem fazer outra busca.

Faça outra chamada de recuperação de informações somente se:
- Os primeiros resultados não responderem à pergunta principal.
- Faltar um fato, parâmetro, responsável, data, ID ou fonte de que você precise para responder.
- O usuário tiver pedido uma análise exaustiva, uma comparação ou uma lista abrangente.
- For preciso consultar um documento, URL, e-mail, reunião, registro ou artefato de código específico.
- Sem outra busca, a resposta incluiria uma afirmação factual importante sem respaldo.

Não repita a busca para melhorar a redação, acrescentar exemplos, citar detalhes secundários ou sustentar uma formulação que possa ser mais genérica sem perda de rigor.

Limites para a redação criativa

Em tarefas de redação, diga ao modelo quais afirmações devem vir de fontes e em quais partes ele pode escrever com liberdade criativa. Isso é especialmente importante em slides, textos de lançamento, resumos para clientes, roteiros de apresentação, textos breves para a liderança e na definição do enfoque de uma narrativa.

Em pedidos de criação de conteúdo, como slides, textos breves para a liderança, mensagens de divulgação, resumos para compartilhar, roteiros de apresentação ou definição do enfoque de uma narrativa, diferencie os fatos respaldados por fontes das escolhas criativas de redação.

- Para afirmações concretas sobre produtos, clientes, métricas, planos de desenvolvimento, datas, recursos ou concorrência, use fatos obtidos na busca ou fornecidos a você e cite as fontes dessas afirmações.
- Não invente nomes específicos, afirmações sobre dados próprios, métricas, informações sobre o andamento dos planos de desenvolvimento, resultados de clientes ou recursos do produto para dar mais força ao texto.
- Se houver pouca ou nenhuma evidência que possa ser citada, escreva um rascunho útil em termos gerais, com campos a preencher ou premissas claramente identificadas. Evite detalhes sem respaldo.

Engenharia de frontend e critérios de design visual

Para trabalhos de frontend, consulte os exemplos de instruções para conhecer formas práticas de orientar a qualidade da interface. Eles abordam o contexto do produto e do usuário, a compatibilidade com o sistema de design, a usabilidade da tela inicial, os controles familiares, os estados esperados e o comportamento responsivo. Também mostram padrões comuns a evitar em interfaces geradas, como seções de destaque genéricas, cartões dentro de cartões, gradientes decorativos, instruções de implementação visíveis ao usuário e layouts quebrados.

Peça ao modelo que verifique o próprio trabalho

Dê ao GPT-5.5 acesso a ferramentas que permitam verificar as saídas quando for possível validá-las.

Para agentes de programação, peça que executem comandos específicos de validação:

Depois de fazer as alterações, execute as verificações disponíveis mais relevantes:
- testes unitários específicos para o comportamento alterado
- verificações de tipos ou de lint, quando aplicáveis
- verificações de build dos pacotes afetados
- um teste de fumaça mínimo quando o custo da validação completa for alto demais

Se não for possível executar a validação, explique o motivo e descreva a melhor verificação alternativa.

Para artefatos visuais, peça uma inspeção após a renderização:

Renderize o artefato antes de finalizar. Examine o resultado para verificar o layout, possíveis cortes, o espaçamento, a presença de todo o conteúdo e a consistência visual. Faça os ajustes necessários até que o resultado renderizado atenda aos requisitos.

Para tarefas de engenharia e planejamento, peça planos de implementação que permitam rastrear como cada requisito será atendido:

Nos planos de implementação, inclua:
- os requisitos e o ponto do plano que atende a cada um deles
- os nomes dos recursos, arquivos, APIs ou sistemas envolvidos
- as transições de estado ou o fluxo de dados, quando relevantes
- os comandos ou procedimentos de validação
- o comportamento em caso de falha
- as considerações sobre privacidade e segurança
- as questões em aberto que afetem significativamente a implementação

Parâmetro phase

Desde o GPT-5.4, fluxos de longa duração ou com uso intensivo de ferramentas na API Responses podem usar os valores de phase nos itens do assistente para distinguir atualizações intermediárias de respostas finais. O GPT-5.5 segue o mesmo padrão.

Se você usar previous_response_id, a API preservará automaticamente o estado anterior do assistente. Se o aplicativo reenviar manualmente itens de saída do assistente na requisição seguinte, preserve o valor original de phase de cada item e reenvie-o sem alterações. Isso é especialmente importante quando a resposta inclui preâmbulos, chamadas repetidas de ferramentas ou uma resposta final após atualizações intermediárias do assistente.

Se você reenviar manualmente os itens do assistente:
- Preserve exatamente os valores de `phase` do assistente.
- Use `phase: "commentary"` para atualizações intermediárias visíveis ao usuário.
- Use `phase: "final_answer"` para a resposta final.
- Não adicione `phase` às mensagens do usuário.

Estrutura sugerida para prompts

Use esta estrutura como ponto de partida para prompts complexos. Mantenha cada seção curta. Acrescente detalhes somente quando eles mudarem o comportamento do modelo.

Papel: [1-2 frases que definam a função do modelo, o contexto em que atua e sua tarefa]

# Personalidade
[tom, postura e estilo de colaboração]

# Objetivo
[resultado visível para o usuário]

# Critérios de sucesso
[condições que devem ser atendidas antes da resposta final]

# Restrições
[limites relativos a políticas, segurança, regras de negócio, uso de evidências e efeitos colaterais]

# Saída
[seções, extensão e tom]

# Regras de parada
[quando tentar novamente, recorrer a uma alternativa, abster-se de responder, fazer uma pergunta ou parar]