Prompts do Sistema

O System Prompt é o coração do seu agente de IA — ele define a personalidade, comportamento, tom de voz e regras que o agente seguirá em todas as conversas. Um prompt bem escrito é a diferença entre um assistente útil e um bot genérico.

Como funciona

O system prompt que você escreve é a base que o CloudWhats combina com outras informações para criar o prompt final enviado ao modelo de IA:

Seu System Prompt — a instrução base que você escreveu
Contexto de Conhecimento — trechos relevantes da base de conhecimento (RAG)
Ferramentas disponíveis — lista de ações que o agente pode executar
Contexto do contato — dados do contato que está conversando
Instruções de handoff — regras de quando transferir para humano
Aviso de privacidade — disclosure de dados do cliente

Foque no seu system prompt principal — o CloudWhats cuida automaticamente de injetar o contexto adicional (conhecimento, ferramentas, contato).

Boas práticas para escrever prompts

1. Defina a identidade

Comece dizendo quem é o agente: "Você é a Sofia, assistente virtual da Loja Exemplo. Você é simpática, profissional e responde em português brasileiro."

2. Defina o escopo

Especifique o que o agente deve e NÃO deve fazer: "Você responde dúvidas sobre nossos produtos e horário de funcionamento. Não forneça informações sobre preços de concorrentes."

3. Defina o tom de voz

Seja específico: "Use linguagem informal mas respeitosa. Pode usar emojis com moderação. Evite gírias regionais."

4. Inclua regras claras

Adicione restrições: "Nunca invente informações. Se não souber a resposta, diga que vai verificar e transfira para um atendente."

5. Defina fallbacks

Instrua o que fazer em situações inesperadas: "Se o cliente pedir algo fora do seu escopo, peça desculpas e ofereça transferir para um humano."

Prompt de handoff

Além do system prompt principal, você pode definir um prompt de handoff separado que instrui o agente sobre quando e como transferir a conversa para um atendente humano.

Se você não definir um prompt de handoff customizado, o CloudWhats gera automaticamente um baseado nos usuários e times permitidos para receber transferências.

Use o prompt de handoff para especificar situações como: "Transfira para o time de vendas quando o cliente demonstrar interesse em comprar" ou "Transfira para suporte quando houver reclamação técnica."

Parâmetros avançados

Além do texto do prompt, você pode ajustar parâmetros que influenciam o comportamento da IA:

Parâmetro	Padrão	Descrição
Temperature	0.7	Criatividade das respostas (0.0 = determinístico, 1.0 = mais criativo)
Max Tokens	Variável	Limite máximo de tokens na resposta do agente
Top P	Variável	Nucleus sampling — controla a diversidade de palavras escolhidas
Thinking	Desativado	Modo de raciocínio estendido — o agente "pensa" antes de responder

Temperaturas muito altas (acima de 0.9) podem gerar respostas incoerentes ou inventar informações. Para atendimento ao cliente, recomendamos entre 0.3 e 0.7.

Testando seu prompt

Use o Preview na tela de edição do agente para testar como o agente responde com seu prompt. O preview simula uma conversa real incluindo o contexto de conhecimento e ferramentas, permitindo ajustar o prompt antes de ativá-lo em produção.