Escrever o system instruction

O system instruction e o prompt de sistema enviado ao modelo em toda requisicao, antes de qualquer mensagem do cliente. E o que define a personalidade, o papel e as regras do seu agente.

Estrutura recomendada

Um bom system instruction tem 4 blocos:

1. Papel — quem o agente e.
2. Tom — como ele fala.
3. Escopo — sobre o que ele pode ou nao responder.
4. Regras — o que ele deve ou nao fazer.

Exemplo 1 — Ateliê de decoracao

Voce e a Clara, atendente virtual do Ateliê Flor de Lis, especializado em
decoracao para festas infantis em Curitiba.

Tom: informal, caloroso, use emojis com moderacao (1-2 por mensagem).
Chame o cliente pelo primeiro nome quando souber.

Escopo:
- Tirar duvidas sobre pacotes, precos basicos, disponibilidade.
- Agendar visitas presenciais ou calls.
- Explicar diferenciais (temas exclusivos, entrega no Curitiba e regiao).

Regras:
- Nunca prometa data de disponibilidade sem confirmar com a equipe.
- Nunca de preco fechado — sempre diga "o valor depende do tamanho e tema,
  posso te enviar uma proposta personalizada?"
- Se o cliente pedir para falar com humano, responda "Vou chamar a Carol
  aqui, um momento!" e nao envie mais nada.
- Se a conversa sair do tema (politica, religiao, etc.), redirecione
  educadamente para o assunto da festa.

Exemplo 2 — Loja de cursos online

Voce e atendente da plataforma de cursos CriaDigital.

Tom: profissional, direto, sem gírias.

Escopo:
- Apresentar a grade de cursos (mencionando "Criacao de Conteudo 101" e
  "Trafego Pago Avancado").
- Explicar formato, duracao, investimento.
- Coletar email para envio do material gratuito.

Regras:
- Nao invente cursos que nao estao na grade acima.
- Nao de descontos por conta propria; diga "temos promocoes pontuais, quer
  que eu te avise por email quando sair a proxima?"
- Finalize sempre com uma pergunta aberta para manter o engajamento.

Dicas praticas

Seja especifico no tom

"Seja simpatico" e vago. "Use linguagem casual, com emojis, e trate o cliente pelo primeiro nome" e util. O modelo segue instrucoes concretas melhor do que adjetivos.

Restricoes valem mais que permissoes

E mais efetivo dizer o que nao fazer do que listar tudo o que pode fazer. Ex.: "Nao de preco fechado" e mais robusto que "seja discreto sobre precos".

Use Dados guiados (JSON) para informacoes estruturadas

Se voce tem 10 produtos com precos que variam, em vez de colocar tudo no system instruction, use o campo Dados guiados (JSON) no form do agente:

{
  "produtos": [
    {"nome": "Curso A", "preco": 297, "duracao": "4 semanas"},
    {"nome": "Curso B", "preco": 497, "duracao": "8 semanas"}
  ],
  "horario_atendimento": "Segunda a sexta, 9h-18h"
}

No system instruction, voce adiciona: "Consulte os produtos e horarios em 'dados_guiados' para responder com precisao." Isso mantem o prompt enxuto e permite atualizar so o JSON quando algo mudar.

Teste iterativo

Nao tente acertar o prompt na primeira tentativa. Ativar o agente, testar com alguem de confianca mandando DMs, e ajustar o prompt e o ciclo normal. Cada ajuste leva segundos para salvar e ja vale na proxima resposta.

Limites

• O system instruction nao tem limite rigido de tamanho, mas prompts longos consomem mais tokens por requisicao. Um prompt de 500 tokens somado a 10 mensagens de historico ja consome 1500-2500 tokens antes da resposta — custo direto na sua chave BYOK.
• Informacoes muito dinamicas (estoque em tempo real, pedidos) nao cabem no system instruction. Para isso, precisa integracao externa (nao disponivel na v1).

Proximo passo

Depois de escrever o prompt, veja Escolher modelo e parametros para calibrar temperature e max tokens.