O Playground é seu ambiente de testes para conversar com seus agentes antes de colocá-los em produção. Ele tem dois modos — Voz (chamada LiveKit com microfone) e Texto (chat stateless) — usando o mesmo agente, as mesmas tools e a mesma base de conhecimento.Documentation Index
Fetch the complete documentation index at: https://docs.kiraa.com.br/llms.txt
Use this file to discover all available pages before exploring further.
Os agentes da Tropicall são omnichannel: o mesmo cérebro atende voz e WhatsApp em produção. O Playground reflete isso — você pode validar o agente em ambos os modos antes de ativá-lo.
Os dois modos
Voz
Conversa por microfone com LiveKit em tempo real. Reproduz exatamente o que acontece numa ligação real (com STT, TTS, detecção de fim de fala).
Texto
Chat stateless com o agente — útil para validar tom, escopo de respostas e tools que rodam em texto (como o agente WhatsApp em produção).
Configuração inicial (Welcome View)
Ao acessar o Playground, você vê uma tela de configuração com:- Tabs Voz / Texto — escolhe o modo de teste.
- Seletor de Agente — apenas agentes ativos aparecem.
- Seletor de Cliente (opcional) — vincula a sessão a um cliente do CRM. Útil para validar tools de CRM Action, classificação de etapa pós-conversa e contexto do agente.
- Detalhes do Agente — voz selecionada, número de tools, base de conhecimento.
- Botão Iniciar — começa a sessão no modo escolhido.
Modo Voz (LiveKit + microfone)
Como funciona
Escolha agente e (opcional) cliente
Selecione o agente e, se quiser, um cliente do CRM para anexar contexto.
Interface da sessão de voz
- Visualizador de áudio — animação que responde à voz do agente.
- Transcrição em tempo real — histórico da conversa por escrito.
- Barra de controles — ativar/desativar microfone, mostrar transcrição, encerrar.
Consumo de créditos
O modo Voz consome créditos da sua conta — usa os mesmos recursos de uma chamada real (STT, LLM, TTS, LiveKit). Veja consumo em Uso.
Modo Texto (chat stateless)
Como funciona
O que esperar
- Conversa efêmera: as mensagens não ficam salvas após encerrar (chat é stateless).
- Tools rodam normalmente: tools de tipo
endpoint,agendamento,crm_action(move_to_stage, create_task, schedule_callback) funcionam em texto. Tools voice-only (handoff, encerrar chamada, mark_*, add_client_tag) não aparecem. - Anexos não suportados ainda — diferente do agente WhatsApp em produção que aceita imagem e áudio.
Por que existe um modo separado?
O agente WhatsApp em produção usa OpenAI function calling com schema diferente do agente de voz (LiveKit Agents). O Playground texto reproduz o comportamento do agente WhatsApp — assim você valida em ambiente parecido com o que o cliente final vai ver no WhatsApp.Vincular cliente do CRM à sessão
Tanto Voz quanto Texto aceitam um cliente opcional na configuração inicial. Quando você vincula:- O agente recebe o contexto do cliente (nome, dados, custom fields, tags).
- Tools CRM Action (
move_to_stage,create_task,schedule_callback, etc.) podem operar nesse cliente — útil para validar permissões, whitelist de etapas, criação de tarefa. - Classificação automática pós-call (em modo Voz) é aplicada — o cliente pode ser movido de etapa quando a sessão termina.
O que validar antes de produção
Mensagem inicial
Está correta? O tom é apropriado para o cenário?
Escopo do agente
Responde dentro do escopo definido nas Skills e Rules?
Tools
Aciona as tools certas no momento certo? Ex: agendamento, CRM action.
Base de conhecimento
Encontra informações dos documentos? Cita fontes corretas?
Tom e personalidade
Voz, velocidade, formalidade — combinam com a marca?
Transferência humana
Aciona handoff quando deve? (apenas em chamada real — não funciona no Playground)
Resolução de Problemas
Não consigo iniciar a sessão
| Problema | Solução |
|---|---|
| Nenhum agente aparece | Crie e ative um agente em Studio de IA > Agentes |
| Saldo insuficiente (modo Voz) | Adicione créditos em Billing |
| Botão desabilitado | Selecione um agente no dropdown |
Modo Voz não funciona
| Problema | Solução |
|---|---|
| Microfone bloqueado | Permita acesso nas configurações do navegador |
| Sem áudio do agente | Verifique volume do dispositivo e fones de ouvido |
| Muito ruído de fundo | Use fones com mic, ou troque para modo Texto |
Modo Texto não funciona
| Problema | Solução |
|---|---|
| Tool não acionada | Verifique se a tool está vinculada e se não é voice-only |
| Resposta vazia | Tente reiniciar a sessão; cheque logs do agente |
Erro {code, message} | Mostra erro estruturado — código indica a causa |
Próximos Passos
Adquirir Número
Conecte um número de telefone para receber chamadas reais
Tools (CRM Action)
Configure tools que o agente usa para agir no CRM durante a conversa
Clientes (CRM)
Crie clientes de teste para validar contexto de pipeline e custom fields
Board e Pipelines
Configure descrições claras de etapa para classificação automática pós-call
Automações
Conecte mudanças de etapa do Playground a réguas reativas
Acompanhar Uso
Monitore desempenho e uso após colocar o agente em produção