Template e versionamento de prompt

Um template de prompt é um prompt com espaços variáveis a serem preenchidos em cada chamada, como o nome do cliente, os trechos recuperados ou os dados do pedido. Permite reutilizar a mesma estrutura com conteúdos diferentes. Versionamento de prompt é tratar cada mudança no prompt como uma nova versão de software: com número, registro do que mudou, avaliação de regressão e possibilidade de voltar à versão anterior. Um catálogo ou biblioteca de prompts centraliza os templates aprovados, para que diferentes times usem as mesmas versões e não criem variações descontroladas.

Em Produto, sem versionamento, uma mudança bem-intencionada em um prompt pode quebrar outro caso silenciosamente, e ninguém descobre por semanas. É um dos problemas mais comuns em produtos com IA que crescem rápido. A regra prática é: todo prompt em produção tem versão, dono e avaliação associada, e não é editado diretamente na plataforma do fornecedor. Por exemplo, a versão 2.3 do prompt de resposta ao cliente adicionou uma regra sobre franquia; a avaliação passou em 47 de 50 casos, contra 44 da versão anterior. Esse registro permite entender o que mudou e decidir com dados.

Use template quando a mesma estrutura de prompt é usada com dados diferentes em cada chamada. Use versionamento para toda mudança em prompts que estão em produção. Use catálogo de prompts quando mais de um time ou produto usa os mesmos prompts. Uma forma simples de diferenciar: template é a forma; versionamento é o histórico; catálogo é a biblioteca compartilhada.

Prática de LLMOps consolidada por frameworks (LangChain, 2022) e plataformas de observabilidade (Langfuse, Braintrust, 2023).

Langfuse documentation, Prompt management; OpenAI Platform docs, Prompt caching