MODULO 1.7

๐Ÿ”„ Iteracao e Refinamento

O ciclo de melhoria continua: testar, avaliar, ajustar e repetir ate atingir a qualidade desejada. Nenhum prompt excelente nasce pronto.

6
Topicos
30
Minutos
Inter.
Nivel
Pratica
Tipo
1

๐Ÿ” O Ciclo de Refinamento

Prompts excelentes raramente surgem na primeira tentativa. O processo e iterativo: enviar โ†’ avaliar โ†’ identificar gaps โ†’ ajustar โ†’ reenviar. Cada ciclo melhora o resultado.

1

Enviar o Prompt

Comece com a melhor versao que voce conseguir. Use o template base e preencha todos os campos que souber.

2

Avaliar o Resultado

Compare com seus criterios de aceitacao. O que esta bom? O que falta? O que veio errado ou fora do esperado?

3

Diagnosticar o Gap

Identifique a causa: faltou contexto? Formato errado? Papel inadequado? Restricao ausente? Mude UMA coisa por vez.

4

Ajustar e Reenviar

Faca o ajuste identificado e reenvie. Compare com a versao anterior. Documente o que mudou e por que.

2

๐Ÿงช Teste em Casos Faceis e Dificeis

Um prompt que funciona so no caso ideal nao e confiavel. Teste com entradas faceis (happy path) E dificeis (edge cases) para validar robustez.

Caso Facil (happy path)

  • โœ“Entrada clara e completa
  • โœ“Dados bem formatados
  • โœ“Tamanho medio/esperado
  • โœ“Se funciona aqui, bom comeco

Caso Dificil (edge case)

  • !Entrada ambigua ou incompleta
  • !Dados com erros ou formato ruim
  • !Muito curto ou muito longo
  • !Se funciona aqui, e robusto
3

๐Ÿ”ง Tecnicas de Ajuste

Quando o resultado nao esta bom, nao reescreva tudo. Identifique o problema e faca ajustes cirurgicos. Uma mudanca por vez permite medir o impacto de cada alteracao.

๐Ÿ”ง Diagnostico por Sintoma

Resposta generica? โ†’ Adicione mais contexto e especifique o publico

Formato errado? โ†’ Inclua exemplo de saida esperada (few-shot)

Tom inadequado? โ†’ Ajuste o papel e adicione restricoes de estilo

Muito longo? โ†’ Adicione limite de palavras/itens explicito

Informacao inventada? โ†’ Adicione "Nao invente dados. Diga 'nao sei' se nao tiver certeza."

Fora do escopo? โ†’ Explicite "Foque apenas em X. Nao aborde Y."

โš ๏ธ Erro Comum

Mudar varias coisas ao mesmo tempo. Quando voce altera papel, contexto e formato de uma vez, nao sabe qual mudanca causou a melhoria (ou piora). Mude uma coisa, teste, avalie, repita.

4

๐Ÿ“Š Comparacao de Versoes

Documente cada versao do prompt e seu resultado. Sem registro sistematico, voce nao sabe se o ajuste realmente melhorou ou se apenas parece diferente.

๐Ÿ“‹ Template de Changelog

v1: Prompt original. Resultado: generico, sem formato.

v2: Adicionei papel + formato tabela. Resultado: formato OK, tom errado.

v3: Ajustei tom para "profissional acessivel". Resultado: โœ“ aprovado.

Mudanca-chave: O papel + tom fizeram a maior diferenca.

5

๐Ÿ“ Biblioteca de Prompts

Prompts testados e aprovados sao ativos valiosos. Organize-os em uma biblioteca pessoal ou de equipe para reutilizacao, evitando recriar do zero a cada vez.

๐Ÿ“‚ Como Organizar

  • โ€ขPor categoria: Marketing, Analise, Codigo, Escrita, Dados
  • โ€ขCom metadata: Nome, descricao, quando usar, variaveis, versao
  • โ€ขCom exemplo: Entrada de exemplo + saida esperada para validacao rapida
  • โ€ขVersionado: Mantenha historico de mudancas e por que mudou

๐Ÿ’ก Onde Guardar

Notion, Google Docs, repositorio Git, ou ate um JSON/YAML. O formato importa menos que o habito. O importante e que seja acessivel, buscavel e atualizado pela equipe.

6

๐Ÿงช Exercicio: Iterar 3 Vezes

Crie um prompt, teste, e faca exatamente 3 iteracoes de refinamento. Documente cada mudanca e seu impacto.

๐Ÿ“‹ Instrucoes

  • 1.Escolha uma tarefa real do seu trabalho
  • 2.Escreva a v1 do prompt e teste
  • 3.Avalie, identifique 1 problema, ajuste โ†’ v2
  • 4.Avalie, identifique 1 problema, ajuste โ†’ v3
  • 5.Documente: qual versao e melhor e por que? O que voce aprendeu?

๐Ÿ“ Resumo do Modulo

โœ“
Ciclo iterativo: enviar โ†’ avaliar โ†’ ajustar โ€” Nunca aceite a primeira versao
โœ“
Teste em faceis E dificeis โ€” Edge cases revelam fragilidades
โœ“
Uma mudanca por vez โ€” Para medir o impacto de cada ajuste
โœ“
Documente versoes e mudancas โ€” Changelog de prompts e essencial
โœ“
Biblioteca de prompts โ€” Prompts aprovados sao ativos reutilizaveis

Proximo Modulo:

1.8 โ€” Avaliacao e Qualidade: criterios objetivos e rubricas para avaliar prompts