Neste artigo, você vai entender como funciona a transformação da mensagem do cliente utilizando o histórico da conversa. Essa é uma ferramenta desenvolvida para aprimorar a qualidade da primeira interação do usuário.
Como Funciona a Transformação da Mensagem
Quando a primeira mensagem do usuário chega, levamos em consideração as mensagens anteriores marcadas como histórico na conversa. No exemplo a seguir, o histórico é composto das seguintes mensagens:
Consideramos essas mensagens, além da mensagem mais recente do usuário, para fazer uma alteração na pergunta que é enviada para a Claudia. Isso permite modificar a mensagem utilizada para a consulta das sessões, tornando-a mais precisa.
Se analisarmos as sessões utilizadas para a resposta gerada no exemplo anterior, podemos ver que o termo de pesquisa é diferente das mensagens que o usuário enviou:
O termo de pesquisa "como acessar e aproveitar os boletos de impostos mencionados na notificação" foi gerado pelo processo de transformação de consulta do histórico, garantindo uma busca mais assertiva. Sem essa funcionalidade, o termo de pesquisa original seria apenas "como posso fazer isso?", o que poderia levar a respostas menos precisas.
Ativação da Funcionalidade
Atualmente, essa funcionalidade não pode ser ativada pelo HUB. Quando necessário, entre em contato com a equipe da Cloud para ativação manual.
A ativação deve ser feita da seguinte forma:
Dentro da configuração do projeto, adicionar o seguinte objeto JSON na raiz do documento:
{
"conversationHistoryQueryTransformationSettings": {
"enabled": true,
"prompt": "Analise as mensagens do usuário e do agente abaixo: \n\n {CONVERSATION_HISTORY} \n\n Resuma a dúvida do USER considerando as mensagens enviadas pelo AGENT como contexto. Responda somente com a dúvida resumida, nada além disso.",
"_class": "com.cloudhumans.claudia.domain.entities.ConversationHistoryQueryTransformationSettings"
}
}
Parâmetros do JSON:
-
enabled: Indica que a feature está ativada.
-
prompt: Instruição utilizada para transformar a mensagem do usuário.
-
{CONVERSATION_HISTORY}: Placeholder substituído pelo histórico da conversa.
Exemplo de Substituição do Placeholder
No exemplo citado anteriormente, o placeholder foi substituído pelo seguinte histórico:
AGENT: Notificação enviada pela Agilize: Olá, Rafael Viana! Tudo bem? No início de cada mês, gostaríamos de lembrar sobre os impostos a serem pagos. Aqui estão as informações importantes para este mês: 🗓️ Datas de Liberação: Os boletos estarão disponíveis entre 01 e 15 de cada mês. 📍 Onde Acessar os Boletos: Voc...
USER: Não sabia, como posso aproveitar isso?
USER: Como posso fazer isso?
Com essa abordagem, a ferramenta melhora significativamente a precisão da resposta, garantindo uma interação mais eficaz e relevante para o usuário.