Ciclo de Vida da Sessão

Uma sessão é a unidade central de trabalho no Whisperer: a janela de tempo durante a qual o cliente escuta uma reunião, transcreve a fala e recebe respostas do LLM. Compreender o ciclo de vida ajuda você a usar iniciar/pausar corretamente, interpretar os status no painel e solucionar problemas.

Quando Ler Isto

Leia este artigo se quiser entender:

  • o que acontece com seus dados em cada fase de uma reunião;
  • por que uma resposta às vezes demora e quando a transcrição é salva;
  • como funciona a conexão entre o cliente e o servidor.

Fases da Sessão

1. Iniciar

Pressionar o botão "Iniciar" (ou o atalho de teclado) coloca o cliente em modo ativo:

  1. O cliente abre uma conexão com o servidor e envia o identificador do dispositivo e o token.
  2. O servidor valida a assinatura e a cota de minutos. Se a verificação for aprovada, ele confirma o início da sessão e retorna o identificador da sessão.
  3. O cliente ativa a captura de áudio e começa a gravar.

2. Gravação (Streaming)

O áudio é transmitido em pequenos blocos a cada ~0,8 segundos. Cada bloco é rotulado com o falante: o usuário ou o interlocutor.

O servidor armazena os blocos em buffer e os envia para reconhecimento. A transcrição é retornada ao cliente em tempo real e exibida na LiveTranscriptStrip.

3. Solicitação e Resposta

Quando o usuário pressiona "Perguntar" (ou o atalho de teclado), o cliente envia um quadro ask com o contexto atual da transcrição.

O servidor monta o prompt do sistema (prompt de papel → contexto do usuário → RAG da base de conhecimento) e consulta o LLM. A resposta chega em streaming: o texto aparece à medida que é gerado e é exibido imediatamente na AnswerArea com suporte a Markdown e paginação (caso haja várias respostas).

4. Pausar

Pressionar "Pausar" interrompe a captura de áudio, mas a conexão WebSocket permanece aberta. O cronômetro da sessão é pausado. Retome pressionando "Retomar".

5. Encerrar

Pressionar "Parar" ou fechar o cliente:

  1. O cliente envia um quadro session.end.
  2. O servidor descarrega as transcrições em buffer e a lista de respostas concluídas no banco de dados.
  3. O WebSocket é fechado.
  4. No painel web, a sessão aparece na seção Histórico com a transcrição completa e a análise.

📸 [Captura de tela: painel do Whisperer em modo de gravação — LiveTranscriptStrip e botões de controle visíveis]

Armazenamento de Dados

Por padrão, a transcrição e as respostas do LLM são salvas no banco de dados e ficam acessíveis no painel. Se o modo no-logs estiver ativado, os dados são excluídos após o término da sessão — mas os minutos consumidos continuam sendo contabilizados.

Erros Comuns

Erro Causa Solução
A sessão não inicia E-mail não confirmado ou ausência de assinatura ativa Verifique o status da conta e a cota
"Não consigo ouvir a outra pessoa" Permissão de gravação de tela não concedida (macOS) ou captura de áudio do sistema indisponível (Windows) Permissões do macOS / Windows
A transcrição não aparece Conexão de internet ruim ou perda do WebSocket Verifique sua rede; reinicie a sessão
A resposta do LLM demora demais O provedor de IA está sobrecarregado ou um modelo lento está selecionado Troque o modelo nas configurações

Boas Práticas

  • Encerre a sessão explicitamente com o botão "Parar" — isso garante que os dados sejam gravados no histórico.
  • Pause durante pausas longas na reunião — o cronômetro para e os minutos não são desperdiçados.
  • Use o modo no-logs para reuniões confidenciais em que armazenar a transcrição não é desejável.

Artigos Relacionados