Trechos de prompt reutilizáveis entre agentes
Nível: Intermediário
Tempo de leitura: 6 min
Para que serve
Quando você tem vários agentes, uma parte do prompt se repete em todos: quem é a empresa, como ela fala com o cliente, o que nenhum agente pode fazer. Copiar esse texto em cada agente funciona até o dia em que a informação muda. Aí você precisa lembrar de todos os agentes que tinham aquele parágrafo e corrigir um por um.
Um trecho de prompt resolve isso. Você escreve o texto uma vez na Biblioteca, dá um identificador a ele, e usa esse identificador dentro do prompt de quantos agentes quiser. Na hora de responder, a Wevi coloca o conteúdo no lugar do identificador. Quando você edita o trecho, todos os agentes que o usam já respondem com a versão nova, sem precisar abrir nem republicar nenhum deles.
Os candidatos naturais a virar trecho são o contexto da empresa, a identidade verbal, as restrições, as regras de transbordo e qualquer política que valha para a operação inteira.
Como funciona na prática
O trecho tem duas partes: o conteúdo, que é o texto de verdade, e o identificador, que é o apelido curto usado dentro do prompt.
Um trecho chamado "Tom de voz" com o identificador tom_de_voz é usado assim:
Você é a Marina, recepcionista virtual da Odonto Vita.
{{trecho.tom_de_voz}}
Você ajuda o paciente a agendar, remarcar e cancelar consultas.
O agente nunca vê {{trecho.tom_de_voz}}. Ele recebe o texto completo do trecho naquele ponto exato do prompt, como se você tivesse digitado ali.
Como a referência fica no meio do texto, você escolhe a posição. Contexto da empresa costuma render mais no começo do prompt, e restrições no fim, depois das instruções de comportamento.
Trecho de prompt e biblioteca de conhecimento
As duas coisas ficam em Biblioteca e servem para reaproveitar conteúdo, mas resolvem problemas diferentes.
| Trecho de prompt | Biblioteca de conhecimento | |
|---|---|---|
| O que guarda | Instrução de comportamento | Documentos de consulta |
| Quando o agente usa | Sempre, em toda resposta | Só quando a pergunta tem a ver com o documento |
| Tamanho ideal | Alguns parágrafos | Arquivos inteiros |
| Bom para | Tom de voz, limites, contexto fixo | Catálogo, política de trocas, FAQ |
Instrução de como se comportar vira trecho. Informação para consultar vira documento na biblioteca de conhecimento.
Como criar um trecho
- Vá em Configurações, abra a aba Biblioteca e a sub-aba Prompts
- Clique em Novo trecho e dê um nome descritivo, como "Contexto da clínica"
- Confira o identificador. Ele é sugerido a partir do nome e não muda depois de criado, então escolha algo curto e claro
- Clique em Criar. O painel do trecho abre em seguida
- Escreva o conteúdo e clique em Salvar
Como usar o trecho num agente
- Abra o agente e vá até a aba Inteligência
- Clique em Variáveis, na barra acima do prompt
- Clique no trecho desejado na seção Trechos de prompt. A referência é inserida no fim do prompt
- Mova o texto para o ponto onde ele deve entrar
- Salve o agente
Se preferir, copie a referência direto do painel do trecho, no botão ao lado do identificador, e cole no prompt.
Depois de inserir, aparece o botão Prompt montado na barra do prompt. Ele mostra o texto final que o agente vai receber, com os trechos já no lugar, e avisa se alguma referência aponta para um trecho que não existe mais.
Dicas para um bom resultado
Um assunto por trecho. "Contexto da empresa", "Tom de voz" e "Restrições" separados dão mais liberdade que um único trecho com tudo dentro. Nem todo agente precisa de todos.
Nomeie pelo assunto, não pelo agente. "Tom de voz" serve para qualquer agente. "Prompt da Marina" só serve para um, e o nome fica errado assim que você reaproveita.
Cuidado ao editar um trecho muito usado. A mudança vale na próxima resposta de todos os agentes que o referenciam. Antes de salvar, olhe a lista Agentes usando este trecho, no fim do painel, para saber quem é afetado.
Variáveis funcionam dentro do trecho. Você pode escrever {{contact.nome}} ou {{date}} no conteúdo, que a Wevi resolve normalmente na conversa. Veja como usar dados do pré-chat no prompt.
Um trecho pode chamar outro, até três níveis. Use com moderação: prompt montado a partir de muitas camadas fica difícil de acompanhar. Um trecho não pode chamar ele mesmo.
Excluir um trecho não corrige os prompts. As referências continuam escritas nos agentes, mas passam a não trazer nada, e aquele pedaço do prompt some silenciosamente. Se for excluir, tire a referência dos agentes antes.
Quem pode gerenciar trechos
A sub-aba Prompts aparece para membros com perfil Administrador ou Editor, os mesmos que podem editar agentes. Atendentes e membros com perfil Financeiro não visualizam essa aba.