Carregando
0x20Lição 3 de 9

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.

20 min Questionário com 6 perguntas 2 exercícios de código
Ao final desta lição, você saberá
  • 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 XP

Mensagem de sistema ou de usuário?

Onde fica cada peça num assistente de suporte ao cliente?

0 de 5 classificadosPontuação 0/0
  • “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.py
template = "<ticket>{{ticket}}</ticket>\nLabel:"
print(template.replace("{{ticket}}", "Charged twice for one order"))
Saída
<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.

Exercício 1

Preencha um template de prompt

+25 XP

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
main.py
Carregando editor…

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.

Exercício 2

Confira uma lista de mensagens

+25 XP

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
main.py
Carregando editor…

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…