Utilizando Variáveis no Super 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

1. Acesse seu agente no Super Agentes
2. Vá para a aba Ferramentas
3. Role para baixo até encontrar Variáveis e clique em Adicionar

​

Criando Variáveis

Na tela de configuração de variáveis, você pode:

1. Clicar em Adicionar variável para criar uma nova variável
2. 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

​

Exemplos de Variáveis Comuns

​

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

1. Definição: Você configura as variáveis que seu agente poderá utilizar
2. Coleta: O agente solicita informações ao usuário ou gera dados
3. Armazenamento: Os dados são armazenados em Redis com a chave conversation:{conversationId}:variables
4. Recuperação: O agente pode acessar essas variáveis a qualquer momento durante a conversa
5. 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:

Sempre cumprimente o usuário pelo nome: {{nome}}

Ao final da conversa, envie um e-mail para: {{email}}

​

Instruções para Coleta de Variáveis

Você pode incluir instruções específicas para a coleta de variáveis:

Colete as seguintes informações do usuário:
- Nome completo (variável: nome)
- E-mail (variável: email)
- Telefone (variável: telefone)

Armazene essas informações nas respectivas variáveis.

​

Exemplo de Uso em Estágios

Você pode configurar estágios específicos para coletar informações:

1. Estágio de Boas-vindas: Coleta o nome do usuário
2. Estágio de Qualificação: Coleta informações de contato e necessidades
3. 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:

Crie um relatório detalhado da conversa e armazene na variável 'relatorio' com o seguinte formato:
- Nome do usuário: {{nome}}
- Problema relatado: [resumo do problema]
- Solução oferecida: [resumo da solução]
- Próximos passos: [ações recomendadas]

​

Integração com Planilhas

Você pode exportar as variáveis para planilhas ou outros sistemas externos:

1. Configure uma integração HTTP com Google Sheets ou similar
2. Utilize as variáveis coletadas como dados para a integração
3. Acione a exportação em momentos específicos da conversa

​

Personalização Dinâmica

Use variáveis para personalizar dinamicamente o comportamento do agente:

Se a variável {{interesse}} contiver "preço", forneça informações detalhadas sobre planos e valores.
Se a variável {{interesse}} contiver "funcionalidades", foque em demonstrar os recursos do produto.

​

Exemplo Prático: Agente de CS

Como demonstrado no vídeo, um agente de Customer Success pode:

1. Receber informações de subagentes sobre interações com usuários
2. Armazenar essas informações em variáveis como:
   • primeiro_nome: Nome do usuário
   • experiencia_usuario: Feedback do usuário sobre a experiência
   • funcionalidade: Funcionalidade específica sendo discutida
   • insight: Análise gerada pelo agente sobre a interação
3. Compilar essas variáveis em um relatorio estruturado
4. 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 de nome)
• 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: