Glossário de entidades-chave

Visão geral

Este glossário reúne as definições dos conceitos centrais do Whisperer — da sessão de chamada à base de conhecimento e aos planos. Ele existe para que o restante da documentação seja lido sem suposições: ao se deparar com um termo em qualquer artigo, você encontrará aqui o seu significado exato.

Esta é uma página de referência. Em vez de um procedimento passo a passo, ela inclui uma seção "Como as entidades se conectam" — que mostra como os conceitos se unem em um único fluxo de trabalho do produto.

Quando usar

Você está lendo a documentação pela primeira vez e quer conferir os termos.
Outro artigo usou um termo desconhecido (por exemplo, "no-logs" ou "papel de modelo").
Você está configurando prompts, a base de conhecimento ou uma assinatura e quer entender os limites dos conceitos.

Termos

Sessão — uma sessão do assistente em uma chamada. Ela tem um ciclo de vida: início (session.start) → gravação de áudio → perguntas e respostas → encerramento com salvamento dos dados. A uma sessão estão vinculados uma transcrição, as perguntas feitas e as respostas do modelo. A sessão é a unidade de contabilização de minutos e a base do histórico no painel.

Segmento de transcrição (Segment) — um fragmento de fala reconhecida que o Whisperer forma em tempo real a partir do áudio em streaming. Cada segmento é marcado com um locutor e um carimbo de tempo. Os segmentos se somam para formar a transcrição completa da sessão, exibida como um ticker no cliente e salva no histórico (exceto no modo no-logs).

Locutor ([Me] / [Other]) — o rótulo do locutor na transcrição. [Me] é a sua voz do microfone, [Other] é a voz do áudio do sistema (o que toca nos seus fones/alto-falantes). Essa identificação é possível porque o cliente captura duas fontes de áudio independentes e marca cada trecho de áudio com um rótulo de locutor.

Mapa mental (nó: topic / action_item / decision) — o mapa da reunião que o Whisperer extrai após uma sessão. Os nós (MeetingMapNode) vêm em três tipos: topic (um tópico discutido), action_item (uma tarefa a ser feita), decision (uma decisão tomada). No painel, o mapa pode ser visualizado e enriquecido posteriormente (enrich-mindmap).

Modelo de prompt (prompt de papel) — um rascunho de instrução de sistema para o modelo, adaptado a um papel específico. Definido por você no Prompt Studio e inserido no prompt de sistema antes do contexto do usuário e do bloco da base de conhecimento.

Papel do modelo — a finalidade para a qual um modelo é selecionado. O Whisperer tem sete papéis: responses (respostas regulares de chat), coding (código), vision (capturas de tela e imagens), system_design (resposta estruturada com diagramas Mermaid), generation (geração e enriquecimento do mapa mental), transcription (reconhecimento de fala, Whisper), embedding (vetorização de texto para RAG). Você pode definir um modelo separado para cada papel.

Base de conhecimento / Nota (Note) — seu repositório pessoal de conhecimento no painel. Uma nota contém um título, texto em Markdown e tags. Wiki-links no formato [[...]] conectam as notas em um grafo (vizinhos, caminho mais curto, centralidade). A base de conhecimento é mantida até que você a exclua.

RAG (Retrieval-Augmented Generation) — o mecanismo pelo qual a resposta do modelo é enriquecida com fatos da sua base de conhecimento. As notas são divididas em chunks (~512 tokens, sobreposição de 64), transformadas em embeddings e armazenadas em um banco de dados vetorial; para cada consulta, o sistema usa busca por cosseno para encontrar os top-k fragmentos relevantes e os insere no prompt. Dessa forma, as sugestões se baseiam nos seus materiais, e não apenas no conhecimento geral do modelo.

Contexto do usuário — dados arbitrários que você fornece ao assistente com antecedência (por exemplo, uma descrição do seu papel, produto ou currículo). Definido no seu perfil, ele influencia o tom e a profundidade das respostas em todas as sessões.

Assinatura / Plano (Plan) — seu nível de acesso ao produto: Free, Start, Pro, Max. O plano determina o limite de minutos, o acesso à base de conhecimento, multi-screenshot, o modo System Design e os modelos frontier. O núcleo do produto (sessões, base de conhecimento) requer uma assinatura paga ativa.

Cota de minutos — o limite de tempo de reconhecimento dentro de um plano. No Free são 60 minutos por mês; nos planos pagos os minutos são ilimitados. Os minutos de uma sessão contam para a cota, inclusive no modo no-logs (um contador separado, no_logs_minutes_used). A cota é flexível: a sessão atual será concluída, mas você não conseguirá iniciar uma nova até que ela seja reabastecida.

Modo no-logs (efêmero) — um modo de sessão privada no qual a transcrição e as respostas não são gravadas no banco de dados e são excluídas após o término da sessão. Útil para conversas sensíveis. Importante: os minutos ainda são consumidos da cota.

Modelos frontier — os LLMs de ponta, os mais poderosos (por exemplo, Claude Opus, GPT de nível superior e equivalentes). No Whisperer, eles são desbloqueados apenas nos planos Max.

Indicação (Referral) — um usuário que você convidou. Para cada compra qualificada de um indicado (plano Pro ou Max), você recebe uma recompensa de 500 ₽; uma recompensa por convidado.

Código promocional — um código de desconto. Dois tipos: percent (um desconto percentual sobre o preço) e bonus_days (dias bônus de assinatura). A margem de conversão de moeda não é aplicada a descontos e bônus.

Como as entidades se conectam

Os conceitos do Whisperer formam um único fluxo — da conversa ao conhecimento:

Você inicia uma sessão. O cliente captura duas fontes de áudio e as marca com os locutores [Me] / [Other].
O reconhecimento (o papel de modelo transcription) transforma o áudio em segmentos de transcrição.
Quando você faz uma pergunta, o prompt de sistema é montado: o modelo de prompt do papel do modelo escolhido → contexto do usuário → o bloco RAG da sua base de conhecimento.
O modelo responde; no modo no-logs, nem a transcrição nem as respostas são salvas, mas os minutos ainda são deduzidos da cota definida pelo plano.
Após a sessão, o Whisperer extrai um mapa mental (topic / action_item / decision) para o resumo da reunião.
O nível de acesso a tudo isso é definido pela assinatura; códigos promocionais e indicações ajudam a estendê-la ou baratear, e os modelos frontier são habilitados no Max.

Capturas de tela

📸 [Captura de tela: transcrição ao vivo com rótulos [Me] e [Other]]

📸 [Captura de tela: mapa mental da reunião com nós topic/action_item/decision]

📸 [Captura de tela: grafo da base de conhecimento construído a partir de wiki-links]

Erros comuns

Confundir uma sessão com uma transcrição. A sessão é toda a sessão, com contabilização de minutos; a transcrição (um conjunto de segmentos) é apenas parte dela.
Tratar o no-logs como "gratuito". Os minutos no no-logs são consumidos normalmente; apenas os dados não são salvos.
Esperar modelos frontier no Pro. O frontier está disponível apenas no Max.
Tentar dar comandos por meio do contexto do usuário. O contexto fornece fatos sobre você; use um modelo do Prompt Studio para controlar como o assistente responde.

Boas práticas

Consulte o glossário antes de configurar prompts e papéis de modelo — isso economiza tempo de depuração.
Preencha seu contexto do usuário e sua base de conhecimento com antecedência: o RAG insere seus fatos em cada resposta.
Use wiki-links entre as notas para que o grafo de conhecimento ajude na busca e na navegação.
Para chamadas sensíveis, ative o no-logs, lembrando que os minutos ainda são consumidos.