Utilizando Variáveis no Super Agentes
Guia completo para configurar e utilizar variáveis para armazenar e gerenciar informações durante conversas com seus agentes
Este guia explica como configurar e utilizar variáveis no Super Agentes, permitindo que seus agentes armazenem, recuperem e manipulem informações durante as conversas.
O que são Variáveis?
As variáveis no Super Agentes funcionam como “caixas” que armazenam informações durante a conversa. Elas permitem que você:
- Colete dados dos usuários (nome, e-mail, telefone)
- Armazene informações geradas pelo agente (relatórios, insights)
- Busque dados externos e os mantenha disponíveis durante toda a conversa
- Transfira informações entre diferentes estágios da conversa
- Exporte dados para sistemas externos (planilhas, CRMs)
Quando Usar Variáveis
As variáveis são especialmente úteis em cenários como:
- Captura de leads: Armazenar nome, e-mail e telefone dos usuários
- Geração de relatórios: Criar resumos estruturados de conversas
- Personalização: Manter informações do usuário para personalizar respostas
- Integração com sistemas externos: Preparar dados para exportação
- Fluxos complexos: Manter o contexto entre diferentes estágios da conversa
Configurando Variáveis
Acessando a Configuração de Variáveis
- Acesse seu agente no Super Agentes
- Vá para a aba Ferramentas
- Role para baixo até encontrar Variáveis e clique em Adicionar
Criando Variáveis
Na tela de configuração de variáveis, você pode:
- Clicar em Adicionar variável para criar uma nova variável
- Para cada variável, definir:
- Nome da variável: Como ela será referenciada no prompt (ex:
nome_usuario
) - Descrição da variável: Explicação sobre o propósito e uso da variável
- Nome da variável: Como ela será referenciada no prompt (ex:
Exemplos de Variáveis Comuns
Nome da Variável | Descrição |
---|---|
nome | Nome completo do usuário |
email | Endereço de e-mail do usuário |
telefone | Número de telefone do usuário |
empresa | Nome da empresa do usuário |
interesse | Principal interesse/necessidade do usuário |
relatorio | Relatório gerado pelo agente sobre a conversa |
Usando o Template
Para agilizar a configuração, você pode clicar no botão Preencher com template, que adicionará automaticamente variáveis comuns como nome e e-mail.
Como as Variáveis Funcionam
Ciclo de Vida das Variáveis
- Definição: Você configura as variáveis que seu agente poderá utilizar
- Coleta: O agente solicita informações ao usuário ou gera dados
- Armazenamento: Os dados são armazenados em Redis com a chave
conversation:{conversationId}:variables
- Recuperação: O agente pode acessar essas variáveis a qualquer momento durante a conversa
- Utilização: As informações são utilizadas para personalizar respostas ou gerar relatórios
Persistência das Variáveis
- As variáveis persistem durante toda a conversa
- Elas são mantidas entre diferentes estágios da conversa
- Elas são específicas para cada conversa (não são compartilhadas entre conversas diferentes)
Utilizando Variáveis nos Prompts
Referenciando Variáveis
Para utilizar variáveis nas instruções do seu agente, você pode referenciar o nome da variável no prompt:
Instruções para Coleta de Variáveis
Você pode incluir instruções específicas para a coleta de variáveis:
Exemplo de Uso em Estágios
Você pode configurar estágios específicos para coletar informações:
- Estágio de Boas-vindas: Coleta o nome do usuário
- Estágio de Qualificação: Coleta informações de contato e necessidades
- Estágio de Solução: Utiliza as variáveis coletadas para personalizar a solução
Casos de Uso Avançados
Geração de Relatórios
Como mencionado no vídeo, você pode usar variáveis para gerar relatórios estruturados:
Integração com Planilhas
Você pode exportar as variáveis para planilhas ou outros sistemas externos:
- Configure uma integração HTTP com Google Sheets ou similar
- Utilize as variáveis coletadas como dados para a integração
- Acione a exportação em momentos específicos da conversa
Personalização Dinâmica
Use variáveis para personalizar dinamicamente o comportamento do agente:
Exemplo Prático: Agente de CS
Como demonstrado no vídeo, um agente de Customer Success pode:
- Receber informações de subagentes sobre interações com usuários
- Armazenar essas informações em variáveis como:
primeiro_nome
: Nome do usuárioexperiencia_usuario
: Feedback do usuário sobre a experiênciafuncionalidade
: Funcionalidade específica sendo discutidainsight
: Análise gerada pelo agente sobre a interação
- Compilar essas variáveis em um
relatorio
estruturado - Exportar o relatório para uma planilha para análise posterior
Dicas e Melhores Práticas
Nomenclatura de Variáveis
- Use nomes descritivos e sem espaços (ex:
nome_completo
em vez denome
) - Mantenha consistência na nomenclatura (ex: sempre use snake_case ou camelCase)
- Evite nomes genéricos como
var1
,var2
Descrições Claras
- A descrição da variável funciona como uma instrução para o agente
- Seja específico sobre quando e como a variável deve ser coletada
- Inclua exemplos de valores esperados quando relevante
Segurança e Privacidade
- Não armazene informações sensíveis como senhas ou dados de cartão de crédito
- Informe os usuários sobre quais dados estão sendo coletados
- Considere a conformidade com leis de proteção de dados (LGPD, GDPR)
Perguntas Frequentes
Próximos Passos
Após configurar suas variáveis, você pode:
Configurar Estágios
Use estágios para controlar quando coletar e utilizar variáveis
Adicionar Subagentes
Configure subagentes para compartilhar variáveis em fluxos complexos
Integração HTTP
Exporte variáveis para sistemas externos via integrações HTTP
Google Calendar
Use variáveis para personalizar agendamentos de reuniões