Memória de Conversa (conversation_vars)

O Aillom MEX mantém automaticamente um estado persistente de variáveis coletadas pelo agente ao longo da conversa. Esses dados ficam disponíveis em todas as mensagens subsequentes, independentemente do tamanho do histórico.

Como Funciona

O agente sinaliza variáveis coletadas por meio de uma tag especial ao final de cada resposta:

[VARS: {"campo": "valor"}]

O MEX processa essa tag automaticamente:

• Extrai os dados da resposta
• Faz merge com as variáveis já coletadas (sem sobrescrever valores existentes)
• Remove a tag antes de enviar a mensagem ao usuário
• Persiste no banco e injeta nas próximas mensagens

Configurando no Prompt do Agente

Adicione a instrução abaixo no prompt do seu agente para ativar o recurso:

Ao confirmar cada dado coletado do usuário, inclua ao final da sua resposta:
[VARS: {"campo": "valor", "outro_campo": "valor"}]

Inclua APENAS os campos já confirmados pelo usuário. Omita campos ainda não coletados.

Exemplo de Fluxo

Agente após coletar o nome:

Anotado, João! Agora me passa seu e-mail.
[VARS: {"nome": "João Silva"}]

Usuário recebe (tag invisível):

Anotado, João! Agora me passa seu e-mail.

Agente após coletar e-mail:

Perfeito! Agora me passa o telefone com DDD.
[VARS: {"nome": "João Silva", "email": "joao@exemplo.com"}]

A partir desse ponto, todas as mensagens seguintes já terão nome e email disponíveis no contexto, mesmo que o histórico seja longo.

Variáveis no Banco

As variáveis ficam salvas na coluna conversation_vars (JSONB) da tabela conversations. O campo retorna {} quando nenhuma variável foi coletada ainda.

{
  "nome": "João Silva",
  "email": "joao@exemplo.com",
  "telefone": "11900000000",
  "cidade": "São Paulo"
}

Regras de Merge

Canais Suportados

Funciona em todos os canais da plataforma: WhatsApp, Webchat, Telegram e Instagram.

:::info As variáveis são totalmente livres — as chaves e os valores são definidos pelo prompt do agente, não pela plataforma. O MEX armazena e injeta qualquer estrutura JSON válida. :::