Sistema de Variáveis no Super Agentes
O sistema de variáveis permite armazenar e utilizar informações dinâmicas durante as conversas, funcionando como “memória” do agente para personalizar respostas e manter contexto.Antes de começar
- Ter um agente criado
- Configurar ferramentas básicas
- Acesso às configurações do agente
Pré-requisitos
Antes de configurar variáveis, certifique-se de que:- Seu agente está ativo
- Você tem permissões de edição
- Compreende a sintaxe:
{{nome_da_variavel}}
- Você criou variáveis em ferramentas de variáveis.
Configurando Variáveis
Acessando o Módulo
- Acesse a barra lateral do Super Agentes
- Clique na aba Agentes
- Selecione o agente desejado
- Vá para Configurações → Ferramentas
- Clique em Variáveis
Criando Variáveis Personalizadas
Adicionar Ferramenta de Variáveis
- Clique em + Adicionar Ferramenta
- Selecione Variáveis na lista
- Clique em Conectar variáveis
Configurar Variáveis
- Nome da variável: Identificador único (ex:
nome_cliente
) - Descrição: Explique quando e como será utilizada
- Seja específico sobre o contexto de uso
- Inclua exemplos de valores esperados
Templates Disponíveis
Template Padrão
Template Padrão
nome
- Nome completo do usuárioemail
- Endereço de email do usuário- Use o botão Preencher com template para aplicar
Configuração Manual
Configuração Manual
- Clique em + Adicionar variável
- Defina nome e descrição personalizados
- Repita para cada variável necessária
Tipos de Variáveis
Variáveis Customizadas
- Criadas por você
- Específicas do seu negócio
- Exemplos:
{{produto_interesse}}
,{{data_agendamento}}
Variáveis Globais
- Capturadas automaticamente
- Baseadas no canal de comunicação
- Exemplos:
{{user-name}}
,{{user-email}}
Variáveis de Runtime
- Geradas pelo sistema
- Atualizadas dinamicamente
- Exemplos:
{{today}}
,{{conversation-id}}
Variáveis Globais por Canal
Dashboard
{{user-name}}
- Nome do usuário logado{{user-email}}
- E-mail do usuário logado, caso tenha conta no Super Agentes- Capturadas automaticamente da sessão
{{user-name}}
- Nome do contato{{user-phone-number}}
- Número de telefone- Extraídas do perfil do WhatsApp
Variáveis de Sistema
{{today}}
- Data/hora atual{{conversation-id}}
- ID da conversa{{conversation-status}}
- Status da conversa{{conversation-channel}}
- Canal de comunicação
Variáveis de Runtime (Sistema)
As variáveis de runtime são geradas automaticamente pelo sistema durante a execução das conversas. Elas fornecem informações contextuais em tempo real e não precisam ser configuradas manualmente.Lista Completa de Variáveis de Runtime
Data e Tempo
{{today}}
- Data e hora atual no formato ISO
- Formato: YYYY-mm-ddTHH:MM:SS
- Atualizada a cada execução
- Exemplo:
2024-01-15T14:30:25
Identificação da Conversa
{{conversation-id}}
- ID único da conversa
- Gerado automaticamente pelo sistema
- Útil para integrações e logs
- Exemplo:
clr8x9y2k0001abc123def456
Status da Conversa
{{conversation-status}}
- Status atual da conversa
- Valores possíveis:
OPEN
,RESOLVED
,PENDING
- Atualizado conforme ações do usuário
- Útil para workflows condicionais
Prioridade
{{conversation-priority}}
- Nível de prioridade da conversa
- Valores:
LOW
,MEDIUM
,HIGH
,URGENT
- Pode ser definida manualmente ou por regras
- Influencia ordem de atendimento
Canal de Comunicação
{{conversation-channel}}
- Canal onde a conversa está acontecendo
- Valores:
whatsapp
,dashboard
,website
,api
- Útil para personalizar respostas por canal
- Permite lógica condicional
Métricas da Conversa
{{conversation-total-messages}}
- Contagem total de mensagens na conversa
- Inclui mensagens do usuário e do agente
- Útil para análise de engajamento
- Exemplo:
15
Data de Criação
{{conversation-created-at}}
- Data e hora de início da conversa
- Formato ISO: YYYY-mm-ddTHH:MM:SS
- Não muda durante a conversa
- Exemplo:
2024-01-15T09:15:30
Casos de Uso das Variáveis de Runtime
Personalização por Canal
Personalização por Canal
{{conversation-channel}}
para adaptar o comportamento:Controle de Tempo
Controle de Tempo
{{today}}
e {{conversation-created-at}}
para lógica temporal:Escalação por Prioridade
Escalação por Prioridade
{{conversation-priority}}
para workflows:Análise de Engajamento
Análise de Engajamento
{{conversation-total-messages}}
para insights:Integrações com CRM
Integrações com CRM
Diferenças entre Tipos de Variáveis
Tipo | Configuração | Persistência | Atualização | Exemplos |
---|---|---|---|---|
Runtime | Automática | Por conversa | Dinâmica | {{today}} , {{conversation-id}} |
Global | Automática | Por conversa | No início | {{user-name}} , {{user-email}} |
Customizada | Manual | Por conversa | Quando coletada | {{nome_cliente}} , {{produto_interesse}} |
Limitações das Variáveis de Runtime
- Não são editáveis: Valores são gerados automaticamente pelo sistema
- Específicas por conversa: Cada conversa tem seus próprios valores
- Dependem do contexto: Algumas podem estar vazias dependendo do canal
- Formato fixo: Datas seguem sempre o padrão ISO
Monitoramento de Runtime Variables
Para visualizar os valores atuais das variáveis de runtime:- Logs da Conversa: Acesse uma conversa específica nos logs
- Debug do Agente: Use o preview para ver valores em tempo real
- Ferramentas HTTP: Configure endpoints de teste para capturar os valores
- Perfil da Conversa: Visualize metadados na interface de logs
Boas Práticas com Runtime Variables
✅ Recomendado:- Use
{{conversation-id}}
para rastreamento em integrações - Combine
{{today}}
com lógica temporal nos prompts - Utilize
{{conversation-channel}}
para personalizar experiência - Aproveite
{{conversation-status}}
para workflows condicionais
- Tentar modificar valores de runtime variables
- Assumir que todas estarão sempre preenchidas
- Usar em cálculos complexos de data (use sistema externo)
- Depender exclusivamente delas para lógica crítica
Usando Variáveis
Em Prompts do Sistema
- Acesse Configurações → Prompt
- Use a sintaxe
{{variavel}}
no texto - Exemplo:
Em Estágios
- Acesse Configurações → Estágios
- Configure objetivos e instruções com variáveis
- Exemplo no objetivo:
Em Ferramentas HTTP
Configurar Requisição
- Acesse Ferramentas → HTTP
- Use variáveis no Body, Headers ou Parameters
Exemplo no Body
Exemplo em Headers
Em Follow-ups
- Acesse Ferramentas → Follow Up
- Configure o objetivo com variáveis
- Exemplo:
Monitoramento e Status
Visualizando Variáveis Ativas
Em Conversa
Logs do Agente
Debug Mode
Perfil do Usuário
Exemplos Práticos
E-commerce
Configuração de Variáveis
Configuração de Variáveis
Prompt do Sistema
Prompt do Sistema
Follow-up (24 horas)
Follow-up (24 horas)
Agendamento de Consultas
Variáveis Necessárias
Variáveis Necessárias
Estágio de Coleta
Estágio de Coleta
Integração HTTP
Integração HTTP
Suporte Técnico
Sistema de Protocolos
Sistema de Protocolos
Prompt Personalizado
Prompt Personalizado
Follow-up Automático
Follow-up Automático
Boas Práticas
1. Nomenclatura
- Use nomes descritivos:
{{nome_cliente}}
ao invés de{{n}}
- Use snake_case:
{{data_nascimento}}
ao invés de{{dataNascimento}}
- Evite caracteres especiais e espaços
- Mantenha consistência entre variáveis relacionadas
2. Descrições e Documentação
- Sempre forneça descrições detalhadas das variáveis
- Explique quando e como a variável será utilizada
- Inclua exemplos de valores esperados
- Mantenha documentação interna atualizada
3. Segurança e Privacidade
- Não armazene informações sensíveis em variáveis
- Cuidado com dados pessoais (LGPD/GDPR)
- Use variáveis apenas para informações necessárias
- Monitore o acesso e uso das variáveis
4. Performance e Organização
- Evite criar muitas variáveis desnecessárias
- Reutilize variáveis globais quando possível
- Agrupe variáveis relacionadas com prefixos
- Teste sempre antes de colocar em produção
Solução de Problemas
Variável não está sendo substituída
Variável não está sendo substituída
- Verifique a sintaxe:
{{nome_variavel}}
- Confirme se a variável foi configurada na ferramenta
- Verifique se o agente está coletando o valor corretamente
- Teste com uma conversa nova no preview
Variável aparece vazia
Variável aparece vazia
- Confirme se o valor foi armazenado durante a conversa
- Verifique se a variável global está disponível no canal
- Teste com uma conversa nova
- Verifique os logs da conversa para debug
Erro em ferramentas HTTP
Erro em ferramentas HTTP
- Verifique se as variáveis estão sendo substituídas antes da requisição
- Confirme se os valores são válidos para o endpoint
- Teste a requisição manualmente com valores fixos
- Valide o formato JSON se aplicável
Variáveis não aparecem no dropdown
Variáveis não aparecem no dropdown
- Salve a configuração da ferramenta de variáveis
- Recarregue a página de configurações
- Verifique se a ferramenta está ativa
- Confirme se você tem permissões adequadas
Perguntas Frequentes
Quantas variáveis posso criar por agente?
Quantas variáveis posso criar por agente?
As variáveis persistem entre diferentes conversas?
As variáveis persistem entre diferentes conversas?
Como monitorar o uso das variáveis?
Como monitorar o uso das variáveis?
Posso importar/exportar configurações de variáveis?
Posso importar/exportar configurações de variáveis?
Variáveis funcionam em todos os canais?
Variáveis funcionam em todos os canais?