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 escrever prompts

Escreva prompts úteis para o Chat, o ChatGPT Work e o Codex

O que é um prompt?

É por meio de um prompt que você diz ao ChatGPT o que quer saber, criar ou mudar. Um prompt pode ser uma pergunta, uma instrução ou um objetivo. Você não precisa usar uma sintaxe técnica nem seguir uma fórmula rígida. Comece com suas próprias palavras, leia a resposta e envie outras mensagens para ajustar o resultado.

Muitas vezes, um prompt curto basta. Para tarefas maiores ou mais importantes, inclua os elementos que fazem diferença:

  • Objetivo: O que o ChatGPT deve fazer?
  • Contexto: Que informações ou fontes podem ajudar?
  • Resultado: De que formato, extensão ou nível de detalhe você precisa?
  • Limites: O que deve permanecer como está? O que o ChatGPT deve evitar ou confirmar com você antes de agir?

Use apenas os elementos que ajudam na tarefa. Você não precisa preencher todos os itens nem seguir um formato obrigatório.

Descreva o resultado de que você precisa

Comece pelo resultado, sem listar cada etapa em detalhes. Indique o público ou o formato quando isso fizer diferença para o que o ChatGPT deve produzir.

Transforme estas anotações da reunião em um informe curto para a equipe do projeto.
Comece pelas decisões e pelos próximos passos.

Esse prompt explica o que criar e quem vai ler o texto. Descreva o processo quando ele for importante por si só. Nos demais casos, dê ao ChatGPT liberdade para pesquisar, comparar informações e ajustar a abordagem.

Acrescente contexto relevante

Compartilhe as informações que podem mudar o resultado. Inclua apenas as fontes relevantes e explique o que o ChatGPT deve extrair de cada uma.

  • Anexe documentos, planilhas, apresentações ou arquivos PDF quando quiser que o ChatGPT resuma, compare ou transforme o material, ou crie arquivos para revisão.
  • Inclua uma captura de tela, um diagrama ou outra imagem de entrada quando a tarefa depender de contexto visual. Indique qual parte merece atenção, em vez de contar apenas com a imagem.
  • Peça ao ChatGPT que use a pesquisa na Web quando a resposta depender de informações atuais. Peça também as fontes quando precisar conferir o resultado.
  • Use um projeto quando conversas relacionadas precisarem compartilhar arquivos, fontes ou uma pasta local.

Use fontes conectadas

Quando o ChatGPT tiver acesso a fontes conectadas, indique onde ele deve procurar e o que deve encontrar. Você não precisa descrever cada busca que ele deve fazer.

Prepare um informe sobre o andamento do projeto. Use a versão mais recente do plano do projeto no Drive e as decisões e atualizações relevantes do canal do projeto no Slack.

Cada fonte conectada exige o plugin correspondente. A disponibilidade pode depender do seu plano e das configurações do espaço de trabalho.

Use plugins

Os plugins oferecem ao ChatGPT e ao Codex instruções reutilizáveis e conexões com ferramentas como Google Drive, Gmail, Slack e GitHub. Os dois produtos usam o mesmo diretório universal de plugins públicos. Peça o resultado de que precisa e deixe que a interface em uso escolha entre as ferramentas disponíveis. No ChatGPT, digite @ no campo de mensagem para escolher um plugin específico.

Saiba mais sobre plugins

Encontre, instale e use plugins no ChatGPT e no Codex.

Personalize o ChatGPT

Em Configurações > Personalização, adicione como instruções personalizadas as preferências que devem valer para todas as conversas. Deixe no prompt os detalhes que só importam para a conversa atual.

Confira as configurações de personalização

Defina a personalidade padrão, as instruções personalizadas e outras preferências do aplicativo.

Defina limites para evitar problemas concretos

Os limites são as poucas instruções de que o ChatGPT precisa para evitar retrabalho ou uma ação que você não pretendia autorizar. Defina um limite quando alterar o detalhe errado puder inutilizar o resultado ou quando você quiser revisar algo antes que afete outras pessoas.

  • Mantenha as datas e os valores do orçamento que já foram aprovados.
  • Use apenas as fontes fornecidas. Indique o que estiver faltando em vez de tentar adivinhar.
  • Faça recomendações que caibam no orçamento informado.
  • Prepare um rascunho da mensagem. Não envie.

Concentre-se nos limites mais importantes, um ou dois ao todo. Você não precisa controlar cada etapa do trabalho do ChatGPT.

Deixe o resultado pronto para uso

Diga ao ChatGPT como você pretende usar o resultado. Isso ajuda a definir a extensão, o nível de detalhe e a organização do conteúdo.

  • Faça um resumo de uma página que um diretor consiga ler rapidamente antes da reunião. Comece pela decisão e pelos próximos passos.
  • Transforme estas anotações em um e-mail de acompanhamento com as decisões, os responsáveis e os prazos.
  • Crie uma tabela que facilite a comparação entre os gastos previstos e os realizados. Destaque as diferenças superiores a 10%.

Em trabalhos importantes, peça ao ChatGPT que faça uma verificação final. Por exemplo, peça que confirme se cada ação tem um responsável e um prazo ou que indique quais informações não conseguiu verificar. Depois, revise o resultado antes de usá-lo ou compartilhá-lo.

Aprimore o resultado com novas mensagens

Seu primeiro prompt não precisa ser perfeito. Revise o resultado e peça a alteração específica que você deseja.

Deixe a abertura mais direta, mantenha as evidências e coloque a recomendação antes da seção que apresenta o contexto.

Você pode acrescentar uma fonte que faltou, corrigir o rumo, pedir outra opção ou mudar o nível de detalhe sem começar de novo.

Direcione a execução ou coloque mensagens na fila

Quando o Codex já estiver trabalhando, você pode enviar outra mensagem sem esperar que a execução atual termine:

  • Direcionar adiciona a mensagem à execução atual. Use essa opção para mudar o rumo do trabalho, acrescentar um detalhe que faltou ou compartilhar novas informações.
  • Colocar na fila guarda a mensagem para a próxima execução. Use essa opção para pedidos que devem esperar até a conclusão do trabalho atual.

No aplicativo ChatGPT para desktop, escolha o comportamento padrão em Configurações > Geral > Comportamento das mensagens de acompanhamento. As mensagens na fila aparecem acima do campo de mensagem, onde você pode editá-las, mudar a ordem, enviá-las ou excluí-las. A configuração também mostra o atalho para usar a outra opção em uma única mensagem sem alterar o padrão.

Na CLI do Codex, pressione Enter enquanto o Codex trabalha para direcionar o turno atual ou pressione Tab para colocar a mensagem na fila do próximo turno. Consulte os atalhos interativos para mais detalhes.

Combine os elementos em um prompt

Para preparar um informe sobre um projeto usando fontes conectadas, você pode escrever um prompt completo como este:

Prepare um informe de uma página sobre o andamento do projeto para a reunião da liderança de segunda-feira. Use a versão mais recente do plano do projeto no Drive e as decisões e atualizações relevantes do canal do projeto no Slack.

Comece pelas decisões que a liderança precisa tomar e pelos próximos passos. Resuma o progresso e indique os riscos, os responsáveis e os prazos. Mantenha as datas e os valores do orçamento já aprovados. Sinalize informações conflitantes ou ausentes. Não envie nem publique nada.

Antes de concluir, verifique se cada próximo passo tem um responsável e um prazo.

Esse prompt define o Objetivo, o Contexto, o Resultado e os Limites. Ao final, pede uma verificação sem precisar detalhar cada etapa.

Use o ditado por voz

No aplicativo ChatGPT para desktop, selecione Ditar no campo de mensagem e comece a falar. O ChatGPT transcreve sua fala nesse campo para que você possa revisar e editar o texto antes de enviar o prompt.

Exemplos de prompts para o Chat

Use o Chat para tirar dúvidas, explorar ideias, preparar rascunhos e tomar decisões do dia a dia. Comece pelo resultado que deseja e acrescente detalhes apenas quando fizerem diferença para a resposta.

Entenda um assunto

Explique como funcionam os juros compostos para alguém que nunca investiu.
Dê um exemplo concreto e explique cada termo financeiro que usar.

Escreva e aprimore um texto

Escreva um e-mail cordial recusando este convite porque estarei viajando.
Use menos de 120 palavras e deixe em aberto a possibilidade de participar de outro evento.

Compare opções

Compare estes dois planos de celular para uma pessoa que viaja ao exterior duas vezes por ano. Mostre as principais diferenças em uma tabela. Depois, recomende um dos planos e explique o que a pessoa ganha e do que abre mão ao escolhê-lo.

Faça um plano prático

Planeje cinco jantares para os dias úteis, cada um com menos de 30 minutos de preparo. Evite amendoim, aproveite os mesmos ingredientes em mais de uma refeição e termine com uma única lista de compras para todos os jantares.

Como escrever prompts para o ChatGPT Work

Use o Chat para perguntas rápidas, pequenas revisões de texto, troca de ideias e rascunhos simples. Use o ChatGPT Work para tarefas que recorrem a fontes ou ferramentas diferentes, envolvem uma sequência de etapas, fazem alterações ou geram um material mais extenso.

No ChatGPT Work, descreva o resultado de que precisa, forneça o material de referência, indique o público e explique como você vai revisar o trabalho. Peça ao ChatGPT que planeje as etapas, reúna as informações necessárias, crie os arquivos e os confira antes de concluir.

Use o ChatGPT Work com eficiência

O ChatGPT Work é útil para tarefas demoradas ou recorrentes, ou quando você precisa de arquivos prontos que possa reutilizar. Uma tarefa que consome mais créditos ainda pode valer a pena se economizar tempo, melhorar a qualidade do trabalho ou ajudar você a tomar uma decisão importante.

Comece com um único resultado que você possa revisar:

  • Inclua apenas fontes relevantes e delimite o período quando fizer sentido.
  • Defina o público, o formato do resultado e a extensão desejada.
  • Diferencie o que é obrigatório das melhorias ou dos ajustes opcionais.
  • Peça um plano quando a abordagem for importante. Exija sua aprovação antes que o ChatGPT envie, publique ou altere informações das quais outras pessoas dependem.
  • Reduza o escopo ou interrompa a tarefa se o ChatGPT começar a fazer algo de que você já não precisa.

Revise o primeiro resultado, ajuste as instruções e reutilize o fluxo de trabalho quando ele funcionar bem.

Transforme o material de referência em arquivos prontos para uso

Use os relatórios trimestrais anexos para criar um resumo para a liderança e uma apresentação de seis slides.

O público é a diretoria. Comece pelas três decisões que os diretores precisam tomar. Diferencie os fatos relatados da sua análise, indique o arquivo de origem de cada número e, antes de concluir, confira se as informações do resumo e dos slides são consistentes entre si.

Pesquise para embasar uma decisão

Pesquise três plataformas de atendimento ao cliente para uma empresa com 50 pessoas. Use fontes atuais para comparar preços, segurança, integrações e o esforço necessário para a migração. Entregue um memorando com sua recomendação, os links das fontes, as premissas adotadas e as perguntas que devemos responder antes de assinar um contrato.

Coordene um lançamento

Crie um plano de lançamento com base no resumo do produto em anexo. Inclua o cronograma, os responsáveis, as dependências, os riscos, um rascunho do anúncio, perguntas frequentes para os clientes e uma lista de verificação para o dia do lançamento. Indique quais decisões estão pendentes antes de produzir os arquivos finais.

Para trabalhos recorrentes, primeiro ajuste o prompt em uma conversa comum. Quando o resultado for confiável, agende uma tarefa nessa conversa. Crie uma tarefa agendada independente se cada execução precisar iniciar uma nova conversa.

Como escrever prompts para o Codex

Use o Codex quando quiser que o ChatGPT trabalhe com código, uma base de código ou ferramentas de desenvolvimento. Um bom prompt para o Codex descreve o comportamento desejado, indica o código relevante ou as etapas para reproduzir o problema, explicita as restrições que devem ser respeitadas e informa como verificar a alteração.

Para tarefas com várias etapas, digite /plan no campo de mensagem do aplicativo quando quiser que o Codex investigue e proponha uma abordagem antes de editar. Quando o modo Meta estiver disponível, use /goal depois do plano para definir uma meta persistente. Consulte os comandos de barra do aplicativo para ver a lista atualizada.

Como ler os exemplos

Cada fluxo de trabalho apresenta:

  • Quando usar e qual interface do Codex é mais adequada (IDE, CLI ou nuvem).
  • Etapas com exemplos de prompts de usuário.
  • Notas sobre o contexto: o que o Codex vê automaticamente e o que você deve anexar.
  • Verificação: como conferir o resultado.

Observação: A extensão para IDE inclui automaticamente os arquivos abertos como contexto. Na CLI, indique os caminhos explicitamente ou anexe arquivos com /mention e o preenchimento automático de caminhos com @.

O Codex executa comandos locais em um sandbox que limita o acesso a arquivos e à rede. Se uma tarefa exigir acesso além desses limites, o Codex seguirá sua política de aprovação antes de prosseguir.

Entenda uma base de código

Use este fluxo quando estiver começando em um projeto, assumindo a manutenção de um serviço ou tentando entender um protocolo, um modelo de dados ou o fluxo de uma requisição.

Fluxo na extensão para IDE (a opção mais rápida para exploração local)

  1. Abra os arquivos mais relevantes.

  2. Selecione o trecho de código que você quer entender (opcional, mas recomendado).

  3. Envie um prompt ao Codex:

    Explique o caminho que a requisição percorre no código selecionado.
    
    Inclua:
    - um breve resumo das responsabilidades de cada módulo envolvido
    - quais dados são validados e onde ocorre a validação
    - uma ou duas armadilhas a evitar ao alterar esse código

Verificação:

  • Peça um diagrama ou uma lista de verificação que você possa conferir:
Resuma o fluxo da requisição em uma lista numerada de etapas. Depois, liste os arquivos envolvidos.

Fluxo na CLI (para obter um registro da sessão e os comandos de shell)

  1. Inicie uma sessão interativa:

    codex
  2. Anexe os arquivos (opcional) e envie o prompt:

    Preciso entender o protocolo usado por este serviço. Leia @foo.ts @schema.ts e explique o schema e o fluxo de requisições e respostas. Destaque quais campos são obrigatórios, quais são opcionais e quais regras se aplicam à compatibilidade com versões anteriores.

Notas sobre o contexto:

  • No campo de mensagem, use @ para inserir caminhos de arquivos do espaço de trabalho ou /mention para anexar um arquivo específico.

Corrija um bug

Use este fluxo quando conseguir reproduzir uma falha localmente.

Fluxo na CLI (ciclo curto de reprodução e verificação)

  1. Inicie o Codex na raiz do repositório:

    codex
  2. Informe ao Codex as etapas para reproduzir o bug e indique os arquivos em que você suspeita que ele esteja:

    Bug: às vezes, ao clicar em "Save" na tela de configurações, aparece a mensagem "Saved", mas a alteração não fica salva.
    
    Para reproduzir:
    1) Inicie o aplicativo: npm run dev
    2) Acesse /settings
    3) Mude o estado de "Enable alerts"
    4) Clique em Save
    5) Recarregue a página: a opção volta ao estado anterior
    
    Restrições:
    - Não altere a estrutura da API.
    - Faça a menor alteração necessária para corrigir o bug e acrescente um teste de regressão, se for viável.
    
    Primeiro, reproduza o bug localmente. Depois, proponha um patch e execute as verificações.

Notas sobre o contexto:

  • Você fornece as etapas para reproduzir o bug e as restrições. Esses detalhes importam mais do que uma descrição geral.
  • O Codex fornece a saída dos comandos, os pontos do código em que identificou chamadas e os rastreamentos de pilha gerados durante a execução.

Verificação:

  • O Codex deve repetir as etapas de reprodução depois da correção.
  • Se você tiver um fluxo padrão de verificações, peça que ele o execute:
Depois da correção, execute o lint e a menor suíte de testes relevante. Informe os comandos executados e os resultados.

Fluxo na extensão para IDE

  1. Abra o arquivo em que você suspeita que esteja o bug e o arquivo mais próximo que chama esse código.

  2. Envie um prompt ao Codex:

    Encontre o bug que faz a mensagem "Saved" aparecer sem que as alterações fiquem salvas. Depois de propor a correção, explique como posso verificá-la na interface.

Escreva um teste

Use este fluxo quando quiser definir exatamente o que testar.

Fluxo na extensão para IDE (com seleção de código)

  1. Abra o arquivo que contém a função.

  2. Selecione as linhas que definem a função. Na paleta de comandos, escolha “Add to Codex Thread” para incluir essas linhas no contexto.

  3. Envie um prompt ao Codex:

    Escreva um teste unitário para esta função. Siga as convenções usadas nos outros testes.

Notas sobre o contexto:

  • O comando “Add to Codex Thread” fornece as linhas selecionadas (o escopo definido pelos números de linha), além dos arquivos abertos.

Fluxo na CLI (com o caminho e o intervalo de linhas no prompt)

  1. Inicie o Codex:

    codex
  2. Envie um prompt com o nome da função:

    Adicione um teste para a função invert_list em @transform.ts. Cubra o cenário de sucesso e os casos extremos.

Crie um protótipo a partir de uma captura de tela

Use este fluxo quando quiser transformar um modelo de design, uma captura de tela ou uma referência de interface em um protótipo funcional.

Fluxo na CLI (imagem e prompt)

  1. Salve a captura de tela localmente (por exemplo, em ./specs/ui.png).

  2. Execute o Codex:

    codex
  3. Arraste o arquivo de imagem para o terminal para anexá-lo ao prompt.

  4. Envie as restrições e descreva a estrutura desejada:

    Crie um novo painel com base nesta imagem.
    
    Restrições:
    - Use React, Vite e Tailwind. Escreva o código em TypeScript.
    - Reproduza o espaçamento, a tipografia e o layout com a maior fidelidade possível.
    
    Entregue:
    - Uma nova rota ou página que renderize a interface
    - Os pequenos componentes necessários
    - Um README.md com instruções para executar o painel localmente

Notas sobre o contexto:

  • A imagem mostra os requisitos visuais, mas você ainda precisa especificar as restrições de implementação, como framework, roteamento e estilo dos componentes.
  • Descreva em texto os comportamentos que a imagem não mostra, como estados ao passar o ponteiro, regras de validação ou interações pelo teclado.

Verificação:

  • Peça ao Codex que inicie o servidor de desenvolvimento, se isso for permitido, e indique exatamente onde visualizar o protótipo:
Inicie o servidor de desenvolvimento e indique a URL ou rota local em que posso ver o protótipo.

Fluxo na extensão para IDE (imagem e arquivos existentes)

  1. Anexe a imagem à conversa do Codex arrastando e soltando o arquivo ou colando a imagem.

  2. Envie um prompt ao Codex:

    Crie uma nova página de configurações. Use a captura de tela anexa como referência para a interface.
    Siga os padrões de design e de apresentação visual dos outros arquivos deste projeto.

Ajuste a interface e acompanhe as mudanças em tempo real

Use este fluxo para alternar rapidamente entre criar, ajustar, atualizar a página e ajustar de novo enquanto o Codex edita o código.

Fluxo na CLI (execute o Vite e faça ajustes com prompts curtos)

  1. Inicie o Codex:

    codex
  2. Inicie o servidor de desenvolvimento em outra janela do terminal:

    npm run dev
  3. Peça ao Codex que faça alterações:

    Proponha de 2 a 3 melhorias no estilo da página de destino.
  4. Escolha uma direção e faça ajustes com prompts curtos e específicos:

    Siga a opção 2.
    
    Altere apenas o cabeçalho:
    - dê à tipografia um estilo mais editorial
    - aumente os espaços em branco
    - verifique se o resultado continua visualmente agradável em dispositivos móveis
  5. Repita com pedidos específicos:

    No próximo ajuste, reduza o excesso de elementos visuais.
    Mantenha o layout, mas simplifique a paleta de cores e remova as bordas redundantes.

Verificação:

  • Confira as mudanças no navegador à medida que o Codex atualiza o código.
  • Faça commit das alterações que quiser manter e reverta as demais.
  • Se você reverter ou modificar uma alteração, avise o Codex para que ele não sobrescreva sua edição ao trabalhar no próximo prompt.

Delegue uma refatoração à nuvem

Use este fluxo quando quiser planejar uma abordagem com o contexto local e delegar a implementação mais demorada a uma conversa na nuvem que possa ser executada em paralelo.

Planejamento local (IDE)

  1. Faça commit das alterações atuais ou, pelo menos, guarde-as em um stash para facilitar a comparação com as próximas mudanças.

  2. Peça ao Codex que elabore um plano de refatoração. Se a habilidade $plan estiver disponível, invoque-a explicitamente:

    $plan
    
    Precisamos refatorar o subsistema de autenticação para:
    - separar as responsabilidades de análise de tokens, carregamento de sessões e tratamento de permissões
    - reduzir as importações circulares
    - facilitar os testes
    
    Restrições:
    - Preserve o comportamento que o usuário vê.
    - Mantenha as APIs públicas estáveis.
    - Inclua um plano de migração passo a passo.
  3. Revise o plano e discuta os ajustes necessários:

    Revise o plano para:
    - especificar exatamente quais arquivos serão movidos em cada marco
    - incluir uma estratégia para reverter as alterações

Notas sobre o contexto:

  • O planejamento funciona melhor quando o Codex pode examinar localmente o código atual, incluindo os pontos de entrada, os limites entre módulos e os indícios de como as dependências se relacionam.

Delegação à nuvem (IDE → Nuvem)

  1. Se ainda não tiver feito isso, configure um ambiente de nuvem do Codex.

  2. Clique no ícone de nuvem abaixo do campo de mensagem e selecione seu ambiente de nuvem.

  3. Quando você enviar o próximo prompt, o Codex criará uma conversa na nuvem com o contexto da conversa atual, incluindo o plano e as alterações locais no código-fonte.

    Implemente o marco 1 do plano.
  4. Revise o diff na nuvem e peça ajustes, se necessário.

  5. Crie um PR diretamente na nuvem ou baixe as alterações para testar e concluir o trabalho localmente.

  6. Repita o processo para os demais marcos do plano.

As tarefas delegadas à nuvem são executadas em ambientes isolados. Durante a fase de execução do agente, o acesso à internet fica desativado, a menos que você o habilite para o ambiente. Saiba mais sobre o acesso à internet na nuvem.

Faça uma revisão de código local

Use este fluxo quando quiser que o Codex revise suas alterações antes de fazer commit ou criar um PR.

Fluxo na CLI (revise sua árvore de trabalho)

  1. Inicie o Codex:

    codex
  2. Execute o comando de revisão:

    /review
  3. Se quiser, indique os pontos que merecem mais atenção:

    /review Concentre-se nos casos extremos e nos problemas de segurança

Verificação:

  • Aplique as correções com base nos comentários da revisão. Depois, execute /review novamente para confirmar que os problemas foram resolvidos.

Revise um pull request no GitHub

Use este fluxo quando quiser receber comentários de revisão sem baixar o branch localmente.

Antes de começar, ative a Revisão de código do Codex no repositório. Consulte Revisão de código.

Fluxo no GitHub (por comentários)

  1. Abra o pull request no GitHub.

  2. Marque o Codex em um comentário e indique os pontos em que a revisão deve se concentrar:

    @codex review
  3. Se quiser, forneça instruções mais específicas.

    @codex review Verifique se há vulnerabilidades e outros riscos de segurança

Atualize a documentação

Use este fluxo quando precisar alterar a documentação com clareza e precisão.

Fluxo na IDE ou na CLI (edição e validação locais)

  1. Identifique os arquivos de documentação que precisam mudar. Abra-os na IDE ou mencione-os com @ na IDE ou na CLI.

  2. Envie ao Codex um prompt com o escopo e os requisitos de validação:

    Atualize a documentação de "advanced features" com orientações para diagnosticar e resolver problemas de autenticação. Verifique se todos os links são válidos.
  3. Depois que o Codex preparar as alterações, revise a documentação e peça os ajustes necessários.

Verificação:

  • Leia a página renderizada.