Criação de prompts

Visão geral da criação de prompts

A criação de prompts é a forma de dizer ao ChatGPT o que pretende saber, criar ou alterar. Um prompt pode ser uma pergunta, uma instrução ou um objetivo. Não precisa de sintaxe técnica nem de uma fórmula rígida. Comece por usar as suas próprias palavras, reveja a resposta e utilize mensagens de seguimento para aperfeiçoar o resultado.

Muitas vezes, um prompt curto é suficiente. Para tarefas maiores ou mais importantes, inclua os elementos relevantes:

• Objetivo: O que deve o ChatGPT fazer?
• Contexto: Que informações ou fontes serão úteis?
• Resultado: De que formato, extensão ou nível de detalhe precisa?
• Limites: O que deve permanecer inalterado? O que deve o ChatGPT evitar ou confirmar consigo antes de agir?

Utilize apenas os elementos que forem úteis. Não precisa de preencher todos os itens nem de seguir um formato obrigatório.

Descreva o resultado de que precisa

Comece pelo resultado, não por uma lista detalhada de passos. Inclua o público ou o formato quando esses detalhes alterarem o que o ChatGPT deve produzir.

Turn these meeting notes into a short update for the project team.
Put the decisions and next steps first.

Este prompt explica o que deve ser criado e quem irá lê-lo. Descreva um processo quando o próprio processo for importante. Caso contrário, dê ao ChatGPT espaço para pesquisar, comparar informações e ajustar a sua abordagem.

Adicione contexto útil

Partilhe as informações que possam alterar o resultado. Adicione apenas as fontes relevantes e explique o que o ChatGPT deve retirar de cada uma.

• Anexe documentos, folhas de cálculo, apresentações ou ficheiros PDF quando pretender que o ChatGPT os resuma, compare, transforme ou crie ficheiros para revisão.
• Adicione uma captura de ecrã, um diagrama ou outro elemento visual quando a tarefa depender de contexto visual. Indique a área relevante em vez de depender apenas da imagem.
• Peça ao ChatGPT para utilizar a pesquisa na Web quando a resposta depender de informações atuais e peça fontes quando precisar de verificar o resultado.
• Utilize um projeto quando conversas relacionadas devam partilhar ficheiros, fontes ou uma pasta local.

Utilize fontes associadas

Quando o ChatGPT tiver acesso a fontes associadas, indique onde deve procurar e o que deve encontrar. Não precisa de descrever cada pesquisa que deve executar.

Use the latest project plan in Drive and relevant decisions and updates from
the project's Slack channel to prepare a status update.

As fontes associadas requerem o plugin correspondente e a disponibilidade pode depender do seu plano e das definições do espaço de trabalho.

Utilize plugins

Os plugins fornecem ao ChatGPT instruções reutilizáveis e ligações a ferramentas como o Google Drive, Gmail, Slack e GitHub. Peça o resultado de que precisa e deixe que o ChatGPT escolha entre as ferramentas disponíveis. Para escolher um plugin específico, escreva @ no compositor.

Personalize o ChatGPT

Coloque as preferências que devem ser aplicadas a todas as conversas em Settings > Personalization como instruções personalizadas. Mantenha no prompt os detalhes que sejam relevantes apenas para a conversa atual.

Tópicos e continuidade do contexto

Um tópico contém os seus prompts, as respostas do modelo e as chamadas de ferramentas. As mensagens de seguimento mantêm o contexto desse tópico, o que torna o mesmo tópico útil para adicionar fontes, corrigir a orientação, adicionar testes ou pedir revisões do mesmo resultado.

Pode executar vários tópicos em paralelo, mas não permita que dois tópicos editem os mesmos ficheiros ao mesmo tempo. Quando um trabalho de programação exigir execução em paralelo, dê preferência a worktrees separados.

Todo o contexto tem de caber na janela de contexto do modelo. Durante tarefas longas, o ChatGPT ou o Codex podem compactar o contexto, resumindo informações relevantes e eliminando detalhes menos importantes. Mesmo quando a compactação for automática, remova ficheiros irrelevantes, registos repetidos e requisitos que já não se apliquem.

Defina limites que evitem problemas reais

Os limites são as poucas instruções de que o ChatGPT precisa para evitar criar trabalho adicional ou realizar uma ação que não pretendia. Adicione um limite quando alterar o detalhe errado tornaria o resultado inutilizável ou quando quiser rever algo antes de este afetar outras pessoas.

• Mantenha inalteradas as datas e os valores orçamentais aprovados.
• Utilize apenas as fontes fornecidas. Assinale as informações em falta em vez de fazer suposições.
• Mantenha as recomendações dentro do orçamento indicado.
• Prepare a mensagem como rascunho. Não a envie.

Concentre-se no limite ou nos dois limites mais importantes. Não precisa de controlar todos os passos que o ChatGPT executa.

Prepare o resultado para utilização imediata

Diga ao ChatGPT como pretende utilizar o resultado. Isto ajuda-o a escolher a extensão, o nível de detalhe e a organização adequados.

• Transforme isto num resumo de uma página que um diretor consiga consultar rapidamente antes da reunião. Coloque a decisão e os próximos passos no início.
• Transforme estas notas num e-mail de seguimento com as decisões, os responsáveis e os prazos.
• Crie uma tabela clara das despesas planeadas e reais e destaque qualquer diferença superior a 10%.

Para trabalhos importantes, peça ao ChatGPT uma verificação final, como confirmar que cada tarefa tem um responsável e um prazo ou assinalar informações que não conseguiu verificar. Em seguida, reveja pessoalmente o resultado antes de o utilizar ou partilhar.

Melhore o resultado com mensagens de seguimento

O seu primeiro prompt não precisa de ser perfeito. Reveja o resultado e, em seguida, peça a alteração específica que pretende.

Make the opening more direct, keep the evidence, and move the recommendation
above the background section.

Pode adicionar uma fonte em falta, corrigir a orientação, pedir outra opção ou alterar o nível de detalhe sem recomeçar.

Orientação e colocação em fila

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

• Orientar adiciona a mensagem à execução atual. Utilize esta opção para mudar de direção, adicionar um detalhe em falta ou partilhar novas informações.
• Colocar em fila guarda a mensagem para a próxima execução. Utilize esta opção para um seguimento que deva aguardar até que o trabalho atual termine.

Na aplicação ChatGPT para computador, escolha o comportamento predefinido em Settings > General > Follow-up behavior. As mensagens em fila aparecem acima do compositor, onde pode editá-las, reordená-las, enviá-las ou eliminá-las. A definição também mostra o atalho para utilizar o outro comportamento numa mensagem sem alterar a sua predefinição.

No Codex CLI, prima Enter enquanto o Codex estiver a trabalhar para orientar o turno atual ou prima Tab para colocar a mensagem em fila para o turno seguinte. Consulte os atalhos interativos para obter mais informações.

Combine todos os elementos

Para uma atualização de projeto que utilize fontes associadas, um prompt completo poderá ter este aspeto:

Prepare a one-page project status update for Monday's leadership meeting. Use
the latest project plan in Drive and relevant decisions and updates from the
project's Slack channel.

Lead with the decisions leadership needs to make and the next steps. Summarize
progress, risks, owners, and due dates. Keep approved dates and budget figures
unchanged. Flag any conflicting or missing information, and don't send or
publish anything.

Before you finish, check that every next step has an owner and due date.

Este prompt abrange o Objetivo, o Contexto, o Resultado e os Limites e, em seguida, pede uma verificação final sem especificar todos os passos.

Utilize o ditado por voz

Na aplicação ChatGPT para computador, mantenha premidas as teclas Ctrl+M enquanto o compositor estiver visível e, em seguida, comece a falar. O ChatGPT transcreve a sua voz para o compositor, para que possa rever e editar o texto antes de enviar o prompt.

Exemplos de prompts para o Chat

Utilize o Chat para perguntas, ideias, rascunhos e decisões do quotidiano. Comece pelo resultado que pretende e adicione detalhes apenas quando estes alterarem a resposta.

Compreender um tema

Explain how compound interest works for someone who has never invested.
Use one concrete example and define any financial terms you introduce.

Redigir e aperfeiçoar textos

Draft a friendly email declining this invitation because I will be traveling.
Keep it under 120 words and leave the door open for a future event.

Comparar opções

Compare these two phone plans for one person who travels internationally twice
a year. Show the important differences in a table, then recommend one and explain
the tradeoff.

Criar um plano prático

Plan five weekday dinners that take less than 30 minutes. Avoid peanuts, reuse
ingredients across meals, and finish with one consolidated shopping list.

Criação de prompts para o ChatGPT Work

Utilize o Chat para perguntas rápidas, reformulações breves, sessões de ideias e rascunhos simples. Utilize o ChatGPT Work para tarefas que recorram a diferentes fontes ou ferramentas, envolvam uma sequência de passos, efetuem alterações ou produzam um resultado de maior dimensão.

No ChatGPT Work, descreva o resultado de que precisa, forneça o material de origem, indique o público e explique como irá rever o trabalho. Peça ao ChatGPT para planear, recolher as informações necessárias, criar ficheiros e verificá-los antes de terminar.

Utilize o ChatGPT Work de forma eficiente

O ChatGPT Work é útil para tarefas demoradas ou recorrentes, ou para ficheiros finais que possa reutilizar. Uma tarefa que utilize mais créditos pode continuar a valer a pena se poupar tempo, melhorar a qualidade ou ajudar a tomar uma decisão importante.

Comece por um resultado que possa rever:

• Inclua apenas fontes relevantes e limite o intervalo de datas quando for adequado.
• Defina o público, o formato do resultado e a extensão pretendida.
• Separe o trabalho obrigatório das melhorias ou do aperfeiçoamento opcionais.
• Peça um plano quando a abordagem for importante. Exija a sua aprovação antes de o ChatGPT enviar, publicar ou alterar informações das quais outras pessoas dependam.
• Restrinja ou interrompa a tarefa se esta começar a realizar trabalho de que já não precisa.

Reveja o primeiro resultado, aperfeiçoe as instruções e reutilize o fluxo de trabalho quando este funcionar.

Transforme o material de origem em ficheiros finais

Use the attached quarterly reports to create a leadership brief and a six-slide
presentation.

The audience is the executive team. Lead with the three decisions they need to
make, distinguish reported facts from your analysis, cite each number to its
source file, and check that the brief and slides agree before you finish.

Pesquisar para tomar uma decisão

Research three customer-support platforms for a 50-person company. Compare
pricing, security, integrations, and migration effort using current sources.
Deliver a recommendation memo with links, assumptions, and the questions we
should answer before signing a contract.

Coordenar um lançamento

Create a launch plan for the attached product brief. Include the timeline,
owners, dependencies, risks, announcement draft, customer FAQ, and a checklist
for launch day. Flag any missing decisions before producing the final files.

Para trabalho recorrente, comece por aperfeiçoar o pedido numa conversa normal. Quando o resultado for fiável, agende uma tarefa nessa conversa. Em alternativa, crie uma tarefa agendada autónoma quando cada execução agendada deva iniciar uma nova conversa.

Escrever pedidos para o Codex

Utilize o Codex quando pretender que o ChatGPT trabalhe com código, uma base de código ou ferramentas de desenvolvimento. Um pedido útil para o Codex descreve o comportamento pretendido, indica o código relevante ou os passos de reprodução, preserva as restrições importantes e explica como verificar a alteração.

Modo Plan e modo Goal

Para uma tarefa com vários passos, introduza /plan no compositor da aplicação quando pretender que o Codex investigue e proponha uma abordagem antes de editar. Quando o modo Goal estiver disponível, utilize /goal após o plano para definir um objetivo persistente. Consulte os comandos de barra da aplicação para obter a lista atual de comandos.

O texto do objetivo funciona simultaneamente como pedido inicial e como critério de conclusão. Um bom objetivo identifica normalmente um resultado concreto, as restrições necessárias e critérios mensuráveis de teste ou revisão.

Migrate this codebase from JavaScript to TypeScript. Preserve existing behavior,
compile in strict mode without explicit `any` types, and make the full test suite pass.

Pode continuar a orientar o Codex depois de o objetivo começar, adicionando restrições relativas a bibliotecas, compatibilidade ou abordagens que não podem ser utilizadas. Utilize uma conversa paralela quando precisar de um resumo do estado sem interromper a tarefa principal.

Como interpretar estes exemplos

Cada fluxo de trabalho inclui:

• Quando o utilizar e qual a interface do Codex mais adequada (IDE, CLI ou cloud).
• Passos com exemplos de pedidos do utilizador.
• Notas de contexto: o que o Codex vê automaticamente e o que deve anexar.
• Verificação: como confirmar o resultado.

O Codex executa comandos locais dentro de uma sandbox que limita o acesso a ficheiros e à rede. Se uma tarefa precisar de ultrapassar esse limite, o Codex segue a sua política de aprovação antes de continuar.

Explicar uma base de código

Utilize este fluxo quando estiver a familiarizar-se com um projeto, a assumir um serviço ou a tentar compreender um protocolo, modelo de dados ou fluxo de pedidos.

Fluxo de trabalho da extensão para IDE (o mais rápido para exploração local)

1. Abra os ficheiros mais relevantes.

2. Selecione o código que lhe interessa (opcional, mas recomendado).

3. Envie um pedido ao Codex:

   Explain how the request flows through the selected code.
   
   Include:
   - a short summary of the responsibilities of each module involved
   - what data is validated and where
   - one or two "gotchas" to watch for when changing this

Verificação:

• Peça um diagrama ou uma lista de verificação que possa validar:

Summarize the request flow as a numbered list of steps. Then list the files involved.

Fluxo de trabalho da CLI (adequado quando pretende uma transcrição e comandos de shell)

1. Inicie uma sessão interativa:

   codex

2. Anexe os ficheiros (opcional) e envie o pedido:

   I need to understand the protocol used by this service. Read @foo.ts @schema.ts and explain the schema and request/response flow. Focus on required vs optional fields and backward compatibility rules.

Notas de contexto:

• Pode utilizar @ no compositor para inserir caminhos de ficheiros da área de trabalho ou /mention para anexar um ficheiro específico.

Corrigir um erro

Utilize este fluxo quando existir um comportamento incorreto que consiga reproduzir localmente.

Fluxo de trabalho da CLI (ciclo rápido de reprodução e verificação)

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

   codex

2. Forneça ao Codex instruções de reprodução e os ficheiros que considera suspeitos:

   Bug: Clicking "Save" on the settings screen sometimes shows "Saved" but doesn't persist the change.
   
   Repro:
   1) Start the app: npm run dev
   2) Go to /settings
   3) Toggle "Enable alerts"
   4) Click Save
   5) Refresh the page: the toggle resets
   
   Constraints:
   - Do not change the API shape.
   - Keep the fix minimal and add a regression test if feasible.
   
   Start by reproducing the bug locally, then propose a patch and run checks.

Notas de contexto:

• Fornecido por si: os passos de reprodução e as restrições (estes são mais importantes do que uma descrição geral).
• Fornecido pelo Codex: resultados dos comandos, locais de chamada encontrados e quaisquer rastreios da pilha que desencadeie.

Verificação:

• O Codex deve voltar a executar os passos de reprodução após a correção.
• Se tiver um processo de verificação padrão, peça-lhe que o execute:

After the fix, run lint + the smallest relevant test suite. Report the commands and results.

Fluxo de trabalho da extensão para IDE

1. Abra o ficheiro onde considera que se encontra o erro e o respetivo chamador mais próximo.

2. Envie um pedido ao Codex:

   Find the bug causing "Saved" to show without persisting changes. After proposing the fix, tell me how to verify it in the UI.

Escrever um teste

Utilize este fluxo quando pretender definir o âmbito exato a testar.

Fluxo de trabalho da extensão para IDE (baseado na seleção)

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

2. Selecione as linhas que definem a função. Escolha "Add to Codex Thread" na paleta de comandos para adicionar estas linhas ao contexto.

3. Envie um pedido ao Codex:

   Write a unit test for this function. Follow conventions used in other tests.

Notas de contexto:

• Fornecido pelo comando "Add to Codex Thread": as linhas selecionadas (este é o âmbito do "número de linha"), além dos ficheiros abertos.

Fluxo de trabalho da CLI (caminho e intervalo de linhas descritos no pedido)

1. Inicie o Codex:

   codex

2. Envie um pedido com o nome de uma função:

   Add a test for the invert_list function in @transform.ts. Cover the happy path plus edge cases.

Criar um protótipo a partir de uma captura de ecrã

Utilize este fluxo quando pretender transformar uma maquete, captura de ecrã ou referência de interface num protótipo funcional.

Fluxo de trabalho da CLI (imagem e pedido)

1. Guarde a captura de ecrã localmente (por exemplo, ./specs/ui.png).

2. Execute o Codex:

   codex

3. Arraste o ficheiro de imagem para o terminal para o anexar ao pedido.

4. Indique depois as restrições e a estrutura:

   Create a new dashboard based on this image.
   
   Constraints:
   - Use react, vite, and tailwind. Write the code in typescript.
   - Match spacing, typography, and layout as closely as possible.
   
   Outputs:
   - A new route/page that renders the UI
   - Any small components needed
   - README.md with instructions to run it locally

Notas de contexto:

• A imagem fornece requisitos visuais, mas terá ainda de especificar as restrições de implementação (framework, encaminhamento, estilo dos componentes).
• Descreva em texto os comportamentos que a imagem não mostra, como estados ao passar o cursor, regras de validação ou interações com o teclado.

Verificação:

• Peça ao Codex para executar o servidor de desenvolvimento (se permitido) e indicar exatamente onde deve verificar:

Start the dev server and tell me the local URL/route to view the prototype.

Fluxo de trabalho da extensão para IDE (imagem e ficheiros existentes)

1. Anexe a imagem na conversa do Codex (arraste e largue ou cole).

2. Envie um pedido ao Codex:

   Create a new settings page. Use the attached screenshot as the target UI.
   Follow design and visual patterns from other files in this project.

Iterar sobre a interface com atualizações em tempo real

Utilize este fluxo quando pretender um ciclo rápido de "conceber → ajustar → atualizar → ajustar" enquanto o Codex edita o código.

Fluxo de trabalho da CLI (executar o Vite e depois iterar com pedidos breves)

1. Inicie o Codex:

   codex

2. Inicie o servidor de desenvolvimento numa janela de terminal separada:

   npm run dev

3. Peça ao Codex para efetuar alterações:

   Propose 2-3 styling improvements for the landing page.

4. Escolha uma direção e faça iterações com pedidos breves e específicos:

   Go with option 2.
   
   Change only the header:
   - make the typography more editorial
   - increase whitespace
   - ensure it still looks good on mobile

5. Repita com pedidos direcionados:

   Next iteration: reduce visual noise.
   Keep the layout, but simplify colors and remove any redundant borders.

Verificação:

• Reveja as alterações no browser à medida que o Codex atualiza o código.
• Faça commit das alterações que pretende manter e reverta as restantes.
• Se reverter ou modificar uma alteração, informe o Codex para que este não substitua a sua edição ao processar o pedido seguinte.

Delegar uma refatoração na cloud

Utilize este fluxo quando pretender conceber uma abordagem com contexto local e, em seguida, delegar a implementação prolongada numa conversa na cloud que possa ser executada em paralelo.

Planeamento local (IDE)

1. Certifique-se de que o seu trabalho atual tem commit ou, pelo menos, está guardado em stash, para poder comparar as alterações de forma clara.

2. Peça ao Codex para criar um plano de refatoração. Se tiver a skill $plan disponível, invoque-a explicitamente:

   $plan
   
   We need to refactor the auth subsystem to:
   - split responsibilities (token parsing vs session loading vs permissions)
   - reduce circular imports
   - improve testability
   
   Constraints:
   - No user-visible behavior changes
   - Keep public APIs stable
   - Include a step-by-step migration plan

3. Reveja o plano e negoceie alterações:

   Revise the plan to:
   - specify exactly which files move in each milestone
   - include a rollback strategy

Notas de contexto:

• O planeamento funciona melhor quando o Codex consegue analisar localmente o código atual (pontos de entrada, limites dos módulos e indicações do grafo de dependências).

Delegação na cloud (IDE → Cloud)

1. Se ainda não o tiver feito, configure um ambiente cloud do Codex.

2. Clique no ícone da cloud por baixo do compositor de pedidos e selecione o seu ambiente cloud.

3. Quando introduzir o pedido seguinte, o Codex cria uma nova conversa na cloud que mantém o contexto da conversa existente (incluindo o plano e quaisquer alterações locais ao código-fonte).

   Implement Milestone 1 from the plan.

4. Reveja o diff da cloud e faça iterações, se necessário.

5. Crie um PR diretamente a partir da cloud ou obtenha as alterações localmente para as testar e concluir o trabalho.

6. Continue a iterar sobre as etapas adicionais do plano.

As tarefas delegadas na cloud são executadas em ambientes isolados. O acesso à Internet está desativado durante a fase do agente, a menos que o ative para o ambiente. Saiba mais sobre o acesso à Internet na cloud.

Efetuar uma revisão local do código

Utilize este fluxo quando pretender uma segunda análise antes de fazer commit ou criar um PR.

Fluxo de trabalho da CLI (rever a árvore de trabalho)

1. Inicie o Codex:

   codex

2. Execute o comando de revisão:

   /review

3. Opcional: forneça instruções de análise específicas:

   /review Focus on edge cases and security issues

Verificação:

• Aplique correções com base nos comentários da revisão e volte a executar /review para confirmar que resolveu os problemas.

Rever um pull request do GitHub

Utilize este fluxo quando pretender obter comentários de revisão sem obter localmente o branch.

Antes de poder utilizar esta funcionalidade, ative a Code review do Codex no seu repositório. Consulte Code review.

Fluxo de trabalho do GitHub (orientado por comentários)

1. Abra o pull request no GitHub.

2. Deixe um comentário que mencione o Codex e indique explicitamente as áreas de foco:

   @codex review

3. Opcional: forneça instruções mais específicas.

   @codex review for security vulnerabilities and security concerns

Atualizar a documentação

Utilize este fluxo quando precisar de uma alteração precisa e clara à documentação.

Fluxo de trabalho da IDE ou CLI (edições locais e validação local)

1. Identifique e abra os ficheiros de documentação a alterar (IDE) ou mencione-os com @ (IDE ou CLI).

2. Indique ao Codex o âmbito e os requisitos de validação:

   Update the "advanced features" documentation to provide authentication troubleshooting guidance. Verify that all links are valid.

3. Depois de o Codex preparar as alterações, reveja a documentação e faça as iterações necessárias.

Verificação:

• Leia a página renderizada.