Como montar uma biblioteca de prompts para o seu time

Um sistema prático de templates de prompt de IA compartilhados no trabalho: o que incluir em cada entrada, como nomear e versionar prompts, como revisar a qualidade antes de compartilhar e quando aposentar um template.

Última atualização: · Versão em Markdown

Por que uma biblioteca compartilhada supera os prompts particulares de cada um

  • A mesma tarefa recorrente (relatório semanal, triagem de tickets, estrutura de proposta) recebe uma saída consistente, não importa quem a execute.
  • Quem chega ao time começa com prompts que já funcionam, em vez de redescobrir as mesmas correções.
  • Quando um prompt gera um resultado ruim, há um único lugar para corrigi-lo, e todo mundo recebe a correção.
  • Isso torna o uso da IA visível: você consegue ver quais fluxos dependem de IA e revisá-los.

O que toda entrada da biblioteca precisa ter

  • Um nome que diga a tarefa, não a ferramenta: 'Resposta a escalonamento de cliente' em vez de 'Prompt do ChatGPT 3'.
  • Quando usar e quando não usar (uma linha cada).
  • O próprio prompt, com marcadores entre [colchetes] para cada parte que o usuário precisa preencher.
  • Em qual modelo ou quais modelos ele foi testado. Prompts que funcionam bem em um modelo podem precisar de ajustes em outro.
  • Um exemplo de entrada e uma breve descrição de como é uma boa saída.
  • Um responsável e a data da última revisão, para que os prompts desatualizados sejam percebidos.

Como manter a qualidade

  • Revise antes de publicar: confira se o prompt declara um objetivo, o contexto, o formato de saída e o que fazer quando faltar informação. Um avaliador de prompts como o Promptea torna essa verificação rápida e consistente.
  • Teste com duas ou três entradas reais, incluindo uma bagunçada, antes de acrescentar um prompt à biblioteca.
  • Versione as mudanças: guarde o texto anterior e uma nota de uma linha sobre o motivo da mudança. Se a qualidade da saída cair, você pode voltar atrás.
  • Remova dados sensíveis dos exemplos. Uma biblioteca é compartilhada; nomes de clientes e números internos nos exemplos vão junto com ela.
  • Aposente os prompts que ninguém usou em um trimestre, ou que foram escritos para um modelo que o seu time não usa mais.

Templates

Transformar um prompt que funcionou em um template reutilizável

Abaixo está um prompt que usei uma vez e que gerou um bom resultado. Transforme-o em um template reutilizável para o meu time.

<prompt>
[cole o prompt que você usou]
</prompt>

Retorne:
1. Um nome baseado na tarefa (no máximo 6 palavras).
2. "Use quando" e "Não use quando" (uma linha cada).
3. O template, com cada detalhe específico da situação substituído por um [marcador descritivo]. Mantenha as instruções, a estrutura e as restrições sem alterações.
4. Uma lista dos marcadores com uma explicação de uma linha para cada.
5. Tudo o que o prompt original deixa pouco claro e que um colega precisaria saber (contexto ausente, formato não declarado, nenhuma instrução para informação ausente).

Não acrescente requisitos novos que não estavam no prompt original.
Abre o analisador com o prompt já preenchido.

Revisar um prompt da biblioteca antes de compartilhar

Revise este template de prompt antes que o meu time o acrescente à nossa biblioteca de prompts compartilhada.

<template>
[cole o template]
</template>

Uso previsto: [a tarefa para a qual ele serve]
Testado em: [nomes dos modelos]

Confira e informe cada item como OK ou Problema, com um motivo em uma frase:
- Objetivo: o resultado esperado está claro?
- Contexto: ele pede tudo de que o modelo precisa?
- Formato de saída: o formato está especificado?
- Informação ausente: ele diz o que fazer quando a entrada estiver incompleta?
- Marcadores: cada [marcador] é compreensível sem perguntar ao autor?
- Dados sensíveis: ele contém nomes, números ou detalhes que não deveriam ser compartilhados?

Depois, dê no máximo 3 edições concretas, da mais importante para a menos. Não reescreva o template inteiro.
Abre o analisador com o prompt já preenchido.

Perguntas frequentes

Onde um time deve guardar sua biblioteca de prompts?
Onde o seu time já guarda a documentação compartilhada: uma página de wiki, um documento compartilhado ou uma pasta na sua base de conhecimento. O que importa é um local combinado, um formato de entrada consistente e um responsável por prompt. Algumas ferramentas de IA oferecem prompts salvos ou instruções de projeto; são práticas, mas prendem a biblioteca a uma ferramenta, então mantenha uma cópia independente de ferramenta.
Os templates de prompt precisam mudar para cada modelo de IA?
O núcleo (objetivo, contexto, formato, restrições) funciona bem de um modelo para outro. Os detalhes mudam: onde vai o contexto longo, quanto as instruções passo a passo ajudam e com que rigor o modelo segue as regras de formato. Registre em qual modelo cada template foi testado e teste de novo quando o seu time trocar de modelo. O Promptea pode adaptar um template a um modelo de destino específico e apontar o que está faltando.