Skip to main content
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.
Os agentes da Kiraa 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).
Texto é o modo padrão ao abrir o Playground. Use-o para iterar rápido em prompts e validar respostas; use Voz quando quiser confirmar que tudo funciona em chamada real.

​
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.
Apenas agentes ativos aparecem no seletor. Se você não vê seu agente, verifique se ele está ativo em Studio de IA > Agentes.

​
Modo Voz (LiveKit + microfone)

​
Como funciona

1

Selecione o modo Voz

Clique na aba Voz na tela inicial.
2

Escolha agente e (opcional) cliente

Selecione o agente e, se quiser, um cliente do CRM para anexar contexto.
3

Permita o microfone

O navegador solicita permissão na primeira vez — clique em Permitir.
4

Inicie a chamada

Clique em Iniciar. O Playground conecta na sessão LiveKit.
5

Comece a conversar

O agente fala a mensagem inicial (se configurada) e ouve o microfone. Não precisa pressionar nada para falar — o sistema detecta automaticamente.

​
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

1

Selecione o modo Texto

Clique na aba Texto na tela inicial (é o padrão).
2

Escolha agente e (opcional) cliente

Mesmo seletor da configuração de voz.
3

Inicie o chat

Clique em Iniciar. Sem permissão de microfone, sem LiveKit — abre direto o chat.
4

Digite e envie

O agente responde por texto. Cada mensagem aciona o LLM e tools normalmente.

​
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.
O modo Texto é ideal para iteração rápida: ajusta prompt → testa → ajusta de novo. Sem precisar gastar créditos de á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.
Em produção, o Playground move clientes reais. Se for testar move_to_stage ou mark_converted, use um cliente de teste ou crie um cliente dedicado para Playground.

​
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)
Handoff NÃO funciona no Playground — usa WebRTC, não SIP. Para validar transferência, faça uma chamada real para o número vinculado ao agente. Veja Handoff em Tools.

​
Resolução de Problemas

​
Não consigo iniciar a sessão

​
Modo Voz não funciona

​
Modo Texto não funciona

​
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