> ## Documentation Index
> Fetch the complete documentation index at: https://help.treble.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Playground

> Valide e otimize seu agente de IA em um ambiente seguro antes de implementá-lo no WhatsApp

O **Playground** é o ambiente ideal para testar e aperfeiçoar seu agente de IA antes de testá-lo diretamente em uma conversa do WhatsApp. Aqui você pode experimentar, identificar problemas e otimizar conversas sem afetar seus clientes reais.

<img src="https://mintcdn.com/trebleai/7IH-SHsVEOAxl8kZ/images/Screenshot2025-10-02at9.20.13AM.png?fit=max&auto=format&n=7IH-SHsVEOAxl8kZ&q=85&s=c67baf2e66e4dca5b5a9a68fab6a89e7" alt="Screenshot 2025-10-02 at 9.20.13 AM.png" width="1912" height="710" data-path="images/Screenshot2025-10-02at9.20.13AM.png" />

## Por que usar o Playground?

**🚀 Validação rápida sem necessidade de enviar um fluxo pelo WhatsApp**

* Teste conversas completas em segundos
* Não precisa enviar mensagens reais do WhatsApp
* Experimente sem limites até estar satisfeito

**🔍 Encontre problemas antes que seus clientes**

* Identifique respostas confusas ou incorretas
* Detecte lacunas em sua base de conhecimento
* Teste cenários difíceis e objeções

<Note>
  **Importante:** O Playground apenas testa a lógica conversacional do agente. As integrações com CRM não são executadas aqui. Você precisará testar essas funções com uma conversa real do WhatsApp.
</Note>

## 🎯 Metodologia de teste em 5 passos

### **Passo 1: Teste o fluxo básico (Happy Path)**

Simule um cliente ideal que segue o fluxo previsto:

<Tabs>
  <Tab title="Leve seus clientes a um objetivo">
    **Cenário:** Cliente interessado e colaborativo

    ```
    VOCÊ: "Olá, tenho dúvidas sobre seus serviços"
    AGENTE: [Resposta de boas-vindas]

    VOCÊ: "Quais são seus horários?"
    AGENTE: [Informações de horários]

    VOCÊ: "Quanto custa uma consulta?"
    AGENTE: [Informações de preços]

    VOCÊ: "Estou interessado em agendar"
    AGENTE: [Direção para o objetivo]
    ```

    **✅ Verifique que o agente:**

    * Responde todas as perguntas corretamente
    * Fornece informações completas e atualizadas
    * Guia naturalmente para o objetivo
    * Mantém um tom apropriado
  </Tab>

  <Tab title="Qualificação de leads">
    **Cenário:** Prospecto que fornece informação completa

    ```
    VOCÊ: "Olá, estou interessado em informações"
    AGENTE: [Saudação e primeira pergunta]

    VOCÊ: "Meu nome é João Silva"
    AGENTE: [Confirma e próxima pergunta]

    VOCÊ: "joao@email.com"
    AGENTE: [Próxima pergunta de qualificação]

    [Continua fornecendo toda a informação solicitada]
    ```

    **✅ Verifique que o agente:**

    * Faz perguntas em ordem lógica
    * Confirma informação recebida
    * Adapta perguntas segundo respostas
    * Indica claramente que informação falta
  </Tab>

  <Tab title="Automatize tarefas complexas">
    **Cenário:** Cliente que consulta informações de sua conta e plano atual

    ```
    VOCÊ: "Olá, gostaria de saber qual plano tenho contratado"
    AGENTE: [Lê propriedades do HubSpot e fornece informações do plano]

    VOCÊ: "Quando é meu próximo pagamento?"
    AGENTE: [Consulta data de renovação no HubSpot]

    VOCÊ: "Perfeito, pode me enviar essa informação por email?"
    AGENTE: [Cria ticket no HubSpot para acompanhamento]
    ```

    **✅ Verifique que o agente:**

    * Consulta corretamente as propriedades de contato no HubSpot
    * Utiliza ferramentas apropriadas segundo a solicitação
    * Fornece informação precisa do sistema
    * Executa ações como criar tickets quando necessário
  </Tab>
</Tabs>

### **Passo 2: Teste cenários reais de clientes**

Simule comportamentos típicos de seus clientes:

<AccordionGroup>
  <Accordion title="🤔 Cliente indeciso">
    **Como atuar:**

    * Faça perguntas vagas: "Pode me ajudar?"
    * Solicite comparações: "O que é melhor, A ou B?"
    * Mostre dúvidas: "Não tenho certeza se isso é para mim"

    **O que avaliar?**

    * O agente clarifica necessidades específicas
    * Fornece comparações úteis
    * Lida com a incerteza sem pressionar
  </Accordion>

  <Accordion title="⚡ Cliente apressado">
    **Como atuar:**

    * Use frases curtas: "Preço", "Horários", "Disponibilidade"
    * Interrompa explicações: "Apenas me diga o custo"
    * Indique urgência: "Preciso disso já"

    **O que avaliar?**

    * Respostas concisas e diretas
    * Informação essencial primeiro
    * Não explica demais quando não pedido
  </Accordion>

  <Accordion title="💰 Cliente sensível ao preço">
    **Como atuar:**

    * Pergunte preços imediatamente
    * Compare com concorrência: "No lugar X é mais barato"
    * Busque descontos: "Vocês têm promoções?"

    **O que avaliar?**

    * Lida apropriadamente com objeções de preço
    * Destaca valor, não apenas preço
    * Oferece alternativas quando relevante
  </Accordion>

  <Accordion title="🔒 Cliente cauteloso">
    **Como atuar:**

    * Evite dar informação pessoal
    * Faça muitas perguntas antes de decidir
    * Expresse desconfiança: "Isso é seguro?"

    **O que avaliar?**

    * Respeita a privacidade do usuário
    * Fornece informação de segurança
    * Gera confiança progressivamente
  </Accordion>
</AccordionGroup>

### **Passo 3: Teste casos extremos e objeções**

Os cenários difíceis revelam fraquezas:

**🚫 Testes de limites:**

```
❌ "Isso é muito caro, vocês têm algo grátis?"
❌ "Não entendo nada do que você diz"
❌ "Quero falar com um humano JÁ"
❌ "Por que precisam da minha informação pessoal?"
```

**✅ Avalie se o agente:**

* Lida com objeções sem ser insistente
* Explica claramente quando não entende
* Respeita decisões do usuário

### **Passo 4: Valide sua base de conhecimento**

Faça perguntas específicas do seu negócio:

<Tabs>
  <Tab title="📋 Informação básica">
    * Quais são seus horários de atendimento?
    * Onde estão localizados?
    * Quais são seus métodos de pagamento?
    * Fazem entregas/envios?
    * Têm garantia?
  </Tab>

  <Tab title="🔧 Detalhes técnicos">
    * Pergunte por produtos/serviços específicos
    * Solicite especificações técnicas
    * Pergunte por compatibilidades ou requisitos
    * Consulte sobre processos internos
    * Peça comparações entre opções
  </Tab>

  <Tab title="💼 Casos complexos">
    * Situações que requerem múltiplas fontes de informação
    * Perguntas que combinam vários temas
    * Cenários que sua concorrência lida diferentemente
    * Casos especiais ou exceções
    * Perguntas sobre atualizações recentes
  </Tab>
</Tabs>

### **Passo 5: Otimização iterativa**

**🔄 Processo de melhoria contínua:**

<Steps>
  <Step title="Identifique problemas">
    Anote respostas incorretas, confusas ou incompletas durante os testes.
  </Step>

  <Step title="Atualize sua base de conhecimento">
    Adicione informação faltante ou esclareça conteúdo ambíguo.
  </Step>

  <Step title="Reinicie e teste novamente">
    Use "Reset conversation" e repita os cenários problemáticos.
  </Step>

  <Step title="Valide a melhoria">
    Confirme que os problemas identificados foram resolvidos.
  </Step>
</Steps>

<Warning>
  **Reinicie a conversa após cada mudança**: O botão "Reset conversation" limpa toda a sessão. Use-o cada vez que modificar a configuração do agente para testar as mudanças.
</Warning>

## Sinais de que você precisa mais otimização

**🔴 Problemas críticos:**

* Respostas incorretas sobre informação básica
* Não pode guiar para o objetivo principal
* Fornece informação contraditória
* Se confunde com perguntas simples

**🟡 Áreas de melhoria:**

* Respostas muito longas ou curtas
* Dificuldade com jargão ou termos específicos
* Não lida bem com objeções
* Falta informação sobre casos especiais

**🟢 Pronto para produção:**

* Responde consistentemente bem em todos os cenários
* Lida com casos extremos profissionalmente
* Fornece valor claro em cada interação
* Os usuários podem alcançar seus objetivos facilmente

## ⚡ Dicas para testes eficientes

<Tip>
  **Simule personalidades reais**: Pense em 3-4 tipos de clientes típicos que você tem e atue como cada um durante os testes.
</Tip>

<Tip>
  **Documente os problemas**: Mantenha uma lista de respostas problemáticas para poder corrigi-las sistematicamente.
</Tip>

## 🔄 Depois do Playground: Validação final

Uma vez satisfeito com os testes no Playground:

<Steps>
  <Step title="Teste no WhatsApp real">
    Envie uma conversa do WhatsApp para verificar que tudo funciona no ambiente real.
  </Step>

  <Step title="Valide integrações CRM">
    Se usar HubSpot ou Salesforce, confirme que os dados são salvos corretamente.
  </Step>

  <Step title="Monitore as primeiras conversas">
    Observe as primeiras interações reais para identificar ajustes finais.
  </Step>

  <Step title="Iterate segundo feedback real">
    Use conversas reais para continuar otimizando seu agente.
  </Step>
</Steps>

## Próximos passos

Seu agente já está funcionando bem no Playground? É hora de:

1. [**Configurar seu agente em conversas**](/pt/docs/main-platform/ai-center/overview#usar-agentes-de-ia-em-conversas) - Integre seu agente em fluxos do WhatsApp
2. [**Otimizar sua base de conhecimento**](/pt/docs/main-platform/ai-center/knowledge-base) - Melhore a qualidade das respostas
3. [**Revisar melhores práticas por tipo de agente**](/pt/docs/main-platform/ai-center/overview#tipos-de-agentes-disponiveis) - Dicas específicas segundo seu agente