Estruture os prompts com tags, papéis e templates
Separe as instruções dos dados com tags XML, use bem as mensagens de sistema e de usuário e construa templates de prompt reutilizáveis.
- Usar tags no estilo XML para separar instruções, contexto e entrada
- Saber o que vai na mensagem de sistema e o que vai na mensagem de usuário
- Construir templates de prompt com variáveis e mantê-los sob controle de versão
Prompts reais misturam instruções, documentos de referência, exemplos e entradas do usuário. As tags os mantêm separados, para que nem você nem o modelo confundam uma coisa com outra:
<instructions>Classify the ticket. Reply with one label.</instructions>
<labels>billing, shipping, technical</labels>
<ticket>{{ticket_text}}</ticket>Não há nada de mágico nos nomes das tags - seja consistente e faça referência a elas (“o texto em <ticket>”).
Os papéis das mensagens acrescentam outra camada de estrutura. A mensagem de sistema (chamada de developer em algumas APIs) guarda as regras permanentes da aplicação - quem o assistente é, o que ele deve e não deve fazer. As mensagens de usuário trazem o pedido e os dados dele. O comportamento que precisa valer na conversa toda vai na mensagem de sistema; o conteúdo variável vai na vez do usuário.
Experimente
Até 15 XPMensagem de sistema ou de usuário?
Onde fica cada peça num assistente de suporte ao cliente?
“Você é o assistente de suporte da Acme Bikes. Responda só a partir do manual fornecido.”
“O meu freio traseiro chia quando chove - o que devo fazer?”
“Nunca prometa reembolsos; encaminhe esses pedidos a um atendente humano.”
“<manual_section>Manutenção dos freios…</manual_section> recuperado para esta pergunta”
“Responda no idioma do cliente, em menos de 150 palavras.”
Templates
Os prompts de produção são templates: instruções fixas com {{variables}} preenchidas em tempo de execução. Mantenha-os na sua base de código, sob controle de versão, revise as mudanças como código e teste cada versão no seu conjunto de avaliação antes de lançar (o guia de prompting da OpenAI recomenda o mesmo). Coloque o conteúdo estável primeiro e o variável por último - isso também permite que os provedores façam cache do prefixo estável.
template = "<ticket>{{ticket}}</ticket>\nLabel:"
print(template.replace("{{ticket}}", "Charged twice for one order"))<ticket>Charged twice for one order</ticket> Label:
Principais conclusões
As tags separam instruções, contexto, exemplos e entrada.
Mensagem de sistema: regras permanentes. Mensagem de usuário: o pedido e os dados dele.
Trate os prompts como templates versionados; as partes estáveis primeiro, as variáveis por último.
Quiz da aula
6 perguntas · aprovação com 5 acertos · até 50 XP
Ao passar, você conclui a aula e mantém sua sequência. As perguntas erradas voltarão em sessões de revisão.
Pratique: escreva código em Python
Escreva código Python no editor e execute os testes com exemplos. O Python roda localmente no navegador usando WebAssembly.
Preencha um template de prompt
A primeira linha é um objeto JSON de variáveis. As linhas restantes são um template com marcadores {{name}}. Imprima o template preenchido. Se algum marcador não tiver variável, imprima só error: missing variable NAME (o primeiro, na ordem em que aparece).
- Todas as variáveis presentes
- Uma variável faltando
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Confira uma lista de mensagens
Cada linha é role: content. Uma conversa válida tem no máximo uma mensagem system, que precisa vir primeiro, e depois mensagens user e assistant estritamente alternadas, começando e terminando com user. Imprima valid: N messages ou invalid: e o primeiro problema: system message must come first, consecutive ROLE messages, must start with user, must end with user ou unknown role ROLE.
- Válida
- Dois usuários seguidos
- Mensagem de sistema atrasada
- Termina com o assistente
O Python é executado em um ambiente isolado no navegador, com limite de 60 segundos. O runtime é carregado pelo CDN do Pyodide; seu código permanece neste navegador.
Dúvidas sobre esta lição
Travou em algum ponto? Pergunte. Descobriu algo? Compartilhe. Explicar também é uma ótima forma de aprender.
Carregando publicações…