Váriáveis
Atualizado
Documentação
Atualizado
Durante uma conversa, o lead pode fornecer uma sequência de informações como: nome, email entre outros. Com o uso de Variáveis, é possível organizar a captura desses dados sem precisar instruir explicitamente o Agente IA a buscá-los diretamente nos estágios. Após a captura, ainda é possível utilizá-las em tomadas de decisão para a seleção e acionamento de um estágio conversacional.
As Variáveis servirão como base de informações para a execução de ações nos estágios, no futuro. Portanto, compreender essa funcionalidade é essencial para criar agentes de IA eficazes.
O seu Agente é responsável pelo atendimento de uma agência de viagens. É importante capturar alguns dados do lead para dar sequencia ao atendimento. Por exemplo: destino, total de dias e quais experiências ele gostaria de ter. Configurando os estágios conversacionais com o uso de variáveis, é possível extrair de forma estruturada todas as informações de interesse para um atendimento mais eficiente.
Uma vez que os dados já estão disponíveis, é possível criar estágios referenciando variáveis como no exemplo abaixo. 👇
Todas as variáveis utilizadas em um determinado estágio serão solicitadas pelo Agente automaticamente e, somente após a coleta completa, os objetivos serão acionados de fato.
IMPORTANTE: Caso você utilize uma variável em uma condição, tenha certeza de coletá-la anteriormente. Como a seleção de um estágio acontece antes da execução de uma condição ou objetivo, é necessário que o dado já tenha sido descoberto pela IA em outro estágio para que a condição de acionamento seja avaliada.
Na configuração abaixo, foram adicionadas três variáveis que precisam ser coletadas. Nesse caso, quando o estágio for selecionado, em vez de utilizar o objetivo na geração da resposta, o Agente de IA concentrará seus esforços na coleta dos dados do lead. Somente após a coleta dos dados do lead, o objetivo e, futuramente, as ações do estágio serão de fato executados.
No exemplo abaixo utilizamos @data.destino para complementar o objetivo do estágio. Nesse caso, antes da execução, o Agente IA também coletará o dado. Logo, quando estamos falando de variáveis, as referências no texto serão substituídas pelos valores reais antes de serem enviados para a LLM, devendo sempre ser coletadas antes do uso.
É comum que nos estágios finais você não precise coletar mais nenhum dado. Mas, muitas vezes, para acionar esse estágio é importante que o agente tenha feito o caminho completo da coleta de dados e acionado os estágios relevantes. Nesses casos, um recurso que se pode utilizar é a seleção de todos os atributos como dados requeridos. Dessa forma você aumenta as chances do objetivo (e futuramente ações) ser executado somente após todos os outros estágios.
Como explicado aqui, um estágio que utilize referencias de variáveis nas condições somente será elegível caso o dado já tenha sido coletado anteriormente. Logo, utilizar esses dados nas condições possibilita um nível de segurança ainda maior na tomada de algumas decisões.
Abaixo, você pode ver um use case onde o estágio de recomendação de bebidas alcoólicas só será feito se a idade tiver sido informada e se o lead for maior de 18 anos.
Exclusão de variáveis previamente utilizadas
A utilização de variáveis não definidas significa que a variável nunca será preenchida, logo, o estágio nunca será selecionado.
Ao excluir variáveis, é importante que todos os estágios sejam revisados e que o uso da variável também seja removido dos mesmos. Não fazer isso fará com que estágios que dependem do dado em questão jamais sejam acionados.
