Código do widget de chat com instruções privadas: como escrever um prompt de sistema que funciona

Dois widgets de chat podem ter a mesma linha de código de incorporação e se comportar de forma totalmente diferente. A diferença está na instrução privada, muitas vezes chamada de prompt de sistema. Ela fica guardada no servidor junto com o widget, é enviada em cada conversa e nunca é mostrada aos visitantes.

Onde fica a instrução

Abra um widget de chat em Widgets e role até Comportamento. O campo de instruções aceita até 4.000 caracteres. Como ela fica no servidor, um visitante que inspeciona sua página vê apenas o id do widget na tag script:

<script src="https://api14.com/widget.js" data-widget="YOUR_WIDGET_ID" async></script>

Uma alteração na instrução vale a partir da próxima mensagem. Você nunca precisa atualizar o código no seu site.

Uma estrutura que funciona

Uma boa instrução responde quatro perguntas para o modelo.

1. Quem é você? "Você é o assistente da Northwind, uma loja online de equipamentos para atividades ao ar livre."
2. O que você sabe? Cole os fatos que importam: prazos de entrega, regras de devolução, horário de atendimento, linhas de produtos. O modelo só consegue ser tão preciso quanto os fatos que você fornece.
3. O que você deve evitar? "Não prometa descontos. Não dê conselhos médicos ou jurídicos. Se não tiver certeza, diga isso e indique a página de contato."
4. Qual deve ser o seu tom? "Responda em duas ou três frases curtas. Use o idioma do visitante."

Mantenha cada regra curta e concreta. Parágrafos longos e vagos são mais difíceis de seguir para um modelo do que uma lista curta.

Teste como um visitante

A pré-visualização do editor envia solicitações reais com a sua instrução ainda não salva, então você pode iterar rápido:

• Faça as cinco perguntas que mais chegam à sua caixa de suporte.
• Pergunte algo que a instrução não cobre e confira se o widget admite que não sabe.
• Tente fazê-lo quebrar uma regra, por exemplo pedindo um código de desconto.

Ajuste a instrução depois de cada rodada. Pequenas mudanças de redação costumam resolver a maioria dos problemas.

Mantenha a marca consistente

O widget de chat é white label: não tem logo nem linha "powered by". Defina o título, a saudação, o texto do campo, o texto do botão e a mensagem de erro com as suas palavras e depois ajuste a cor de destaque, o arredondamento dos cantos e o tema ao seu site. Os textos que você deixar vazios usam padrões no idioma da sua conta.

Combine a instrução com limites

Uma instrução molda as respostas, mas não é um orçamento. Defina um limite de tamanho da resposta (máximo de tokens) para manter as respostas curtas e escolha a chave de API com que o widget funciona. O limite de gasto diário e os modelos permitidos dessa chave valem para cada solicitação dos visitantes, o que dá a você uma segunda rede de segurança, independente.

Comece com um rascunho na página de widgets e depois refine no seu painel.