Saltar para o conteúdo
Aristo

Aprender

Exemplos e referências6 minutos

Mostre, além de explicar

Quando as palavras não chegam para fixar a forma ou o critério que pretende, dê alguns exemplos variados e delimitados, incluindo um caso difícil.

Porque é importante

Há coisas mais fáceis de mostrar do que de descrever: um estilo da casa, uma classificação no limite, o formato exato de um registo. Nesses casos, um ou dois exemplos bem escolhidos valem mais do que um parágrafo de instruções. O guia da Google recomenda incluir alguns exemplos para mostrar ao modelo o padrão pretendido, e o da Anthropic sugere três a cinco para melhores resultados, entre etiquetas <example>, para não serem confundidos com instruções.

Os exemplos são poderosos, e é por isso que exigem cuidado. Um modelo copia o que vê, incluindo o que não queria ensinar: se todos os exemplos forem sobre o mesmo produto, ou tiverem a mesma extensão, a resposta também terá. A Google avisa que exemplos a mais podem levar o modelo a colar-se demasiado a eles. Varie-os, mantenha o formato idêntico e inclua pelo menos um caso difícil, de preferência com uma nota a explicar porque fica onde fica. O artigo da Anthropic sobre engenharia de contexto recomenda poucos exemplos diversos e representativos em vez de uma longa lista de casos particulares.

Nem sempre são precisos exemplos. Numa tarefa simples, ou quando o contrato de saída já fixa a forma, acrescentam pouco; a OpenAI aconselha, para os modelos de raciocínio, a experimentar primeiro sem exemplos e a acrescentá-los quando a saída é complexa. A grelha considera este critério não aplicável quando um exemplo não acrescentaria nada.

Como é um bom prompt

  • 0 — Faltam claramente exemplos. «Classifica cada pedido de apoio por urgência.» Urgência segundo quem?
  • 1 — Uma referência mencionada, mas não fornecida. «…como no mês passado.» O modelo não estava lá no mês passado.
  • 2 — Um exemplo, ou vários que mostram o mesmo caso. O modelo pode colar-se a ele.
  • 3 — Dois a cinco exemplos variados, num formato coerente e delimitado. Urgente, normal e baixa, cada um mostrado uma vez.
  • 4 — Exemplos variados com um caso-limite ou contraexemplo, cada um com uma breve justificação. «“Não consigo iniciar sessão (um só utilizador)” → normal, não urgente: só uma pessoa é afetada.»

Erros comuns

  • Remeter para exemplos («como antes», «como no anexo») sem os incluir.
  • Exemplos que contradizem as instruções, deixando o modelo a escolher entre os dois.
  • Exemplos todos iguais, de modo que o modelo copia a extensão, o tema ou a formulação.
  • Formatos diferentes entre exemplos, ou exemplos que não estão separados da entrada real.
  • Acrescentar exemplos por hábito a uma tarefa que não precisa deles.

Experimente com o seu prompt

Cole na área de trabalho um prompt em que a forma ou o critério importem. Escreva dois exemplos tão diferentes entre si como as suas entradas reais, e um caso difícil com uma frase a explicar a decisão. Coloque-os entre etiquetas, compare a pontuação dos exemplos e confirme se a resposta segue o padrão sem o copiar.

Exemplos resolvidos

Encaminhar mensagens de clientes

Fraco
Organiza estas mensagens de clientes por categorias, como da outra vez.
Forte
Coloca cada mensagem de cliente numa única categoria: entrega, faturação, defeito do produto ou outro. Eis como decidimos, com uma nota sobre o porquê:

<exemplos>
<exemplo>
Mensagem: «A encomenda aparece como entregue, mas não está cá.»
Categoria: entrega
Nota: o problema é onde está o artigo, não o artigo em si.
</exemplo>
<exemplo>
Mensagem: «Fui cobrado duas vezes pela mesma encomenda.»
Categoria: faturação
</exemplo>
<exemplo>
Mensagem: «A chaleira chegou com a tampa rachada.»
Categoria: defeito do produto
Nota: um dano detetado à chegada conta como defeito, não como problema de entrega, porque a substituição sai da equipa de produto.
</exemplo>
<exemplo>
Mensagem: «Vendem cartões-oferta?»
Categoria: outro
Nota: é uma pergunta, não um problema; não há nada a resolver.
</exemplo>
</exemplos>

<mensagens>
{{cole aqui as mensagens}}
</mensagens>

Dá uma linha por mensagem, no formato «número: categoria».

«Como da outra vez» remete para exemplos que o modelo nunca viu. A versão forte dá quatro exemplos variados e delimitados, incluindo o caso-limite do artigo danificado à chegada, com o raciocínio por trás das decisões difíceis.

Descrições de produto no estilo da casa

Fraco
Escreve descrições de produtos com a voz da nossa marca.
Forte
Escreve uma descrição de produto com 40 a 60 palavras para cada artigo listado no fim. Segue a voz dos dois exemplos: calorosa, concreta e com um toque de ironia, dirigida ao leitor.

<exemplo>
Produto: pano de cozinha de linho
Descrição: Vai usá-lo todos os dias e nunca o vai passar a ferro. O linho lavado seca depressa, fica mais macio a cada lavagem e não deixa pelos nos copos. Pendura-se por uma presilha de algodão, e a risca é tecida, por isso não desbota antes de o pano se gastar.
</exemplo>

<exemplo>
Produto: tacho de ferro fundido, 24 cm
Descrição: Pesado o suficiente para manter um guisado a fervilhar durante horas, leve o suficiente para o levantar com uma mão e um pano. Aloura no fogão, termina no forno e serve à mesa. Não precisa de ser curado; precisa, isso sim, de uma prateleira resistente.
</exemplo>

Assim não, porque é vago e exaltado: «Descubra o máximo do luxo na cozinha com este artigo incrível e indispensável!»

<artigos>
{{cole aqui a lista de produtos}}
</artigos>

Uma voz é difícil de descrever e fácil de mostrar. Dois exemplos de produtos diferentes, mais um contraexemplo justificado, permitem ao modelo seguir o estilo sem copiar nenhum exemplo em particular.

Exercício

Acrescente a este prompt três a cinco exemplos variados, incluindo pelo menos um caso difícil, num formato coerente e delimitado.

Reescreva este prompt para que os exemplos estejam mesmo lá, variados, cada um com uma nota curta sobre o que o torna bom.

Reescreva este prompt com duas respostas de exemplo contrastantes e um contraexemplo que mostre o que evitar, e porquê.

Experimente com o seu próprio prompt

Fontes