Pular para o conteúdo principal

Voz (fala para texto)

A voz no Imaginne é fala para texto (STT): você fala, a transcrição aparece no composer e você revisa e envia. Ela nunca envia a mensagem sozinha — é um jeito de digitar mais rápido, não um assistente de voz. O recurso está disponível no Desktop, na TUI e no chat no navegador.

Onde funciona​

SuperfícieComo acionarDisponibilidade
DesktopBotão de microfone no composerVem compilado no app; requer permissão de microfone
Terminal (TUI)Ctrl+G ou F2Depende do build com a tag voice
Chat no navegadorBotão de microfone no composerRequer navegador com gravação de áudio e permissão de microfone
VS Code—Não disponível
Duas formas de capturar

Desktop e TUI capturam o áudio nativamente e transcrevem em tempo real — o texto vai aparecendo enquanto você fala. O chat web usa a gravação do navegador: você grava, para, e o trecho é transcrito de uma vez. O serviço de transcrição é o mesmo; o que muda é a captura. A extensão do VS Code não tem ditado por voz.

No Desktop​

  1. Clique no botão de microfone no composer (canto do campo de mensagem). Se o recurso estiver indisponível, o botão fica oculto.
  2. Fale. A transcrição parcial vai aparecendo no campo de texto enquanto você dita.
  3. Clique novamente no microfone para parar a captura.
  4. Revise o texto, ajuste o que for preciso e envie com Enter.

A transcrição entra no mesmo campo onde você digita, então dá para misturar voz e teclado: dite um trecho, complete digitando e envie.

Ignore o tooltip "Ctrl+Y"

Em algumas versões do Desktop existe um tooltip mencionando Ctrl+Y, mas esse atalho não aciona a voz. Use o botão de microfone.

Na TUI​

  1. Pressione Ctrl+G ou F2 para iniciar a captura.
  2. Fale. A transcrição é anexada ao seu prompt atual.
  3. Pressione Esc para cancelar a captura sem inserir nada.
  4. Revise e envie com Enter.

A voz na TUI depende de o binário ter sido compilado com a tag voice. Hoje, isso vale para o release darwin-arm64; em outras plataformas a voz pode não estar disponível. Se os atalhos não fizerem nada, o seu build provavelmente não inclui voz — veja Instalar a TUI.

O comportamento da captura pode ser ajustado por variáveis de ambiente IMAGINNE_VOICE_* (veja Variáveis de ambiente).

No chat no navegador​

  1. Clique no botão de microfone no composer. Na primeira vez, o navegador pede permissão para usar o microfone.
  2. Fale. O status ao lado do botão mostra "Gravando… toque para parar".
  3. Clique de novo para parar. Aparece "Transcrevendo áudio…" e, em seguida, o texto entra no campo de mensagem.
  4. Revise e envie com Enter.

Detalhes do comportamento no chat web:

  • A transcrição é inserida na posição do cursor e nunca apaga o que você já tinha escrito — dá para ditar um trecho, corrigir digitando e ditar mais.
  • Uma gravação vai até 2 minutos; passando disso, ela para sozinha e é transcrita.
  • Trocar de conversa, fechar a aba ou sair cancela a gravação e libera o microfone.
  • Se o navegador não suportar gravação de áudio, o botão simplesmente não aparece.

Mensagens comuns: "O acesso ao microfone foi bloqueado" (autorize o microfone nas configurações do navegador), "Nenhum microfone foi encontrado neste dispositivo" e "Nenhuma fala foi detectada" (a gravação saiu vazia ou curta demais).

Cancelar​

Em todas as superfícies, nada é enviado automaticamente: cancelar descarta o que ainda não foi transcrito e o texto já no campo permanece. No Desktop e no chat web, clicar de novo no microfone para a captura; na TUI, Esc cancela.

Como a voz é processada​

O áudio é transcrito pelo serviço de voz da plataforma, não por um modelo de chat. O fluxo é: o app captura o áudio do microfone, envia para o serviço e recebe de volta a transcrição, que aparece no composer. Só então, quando você enviar, o texto vira uma mensagem para o agente — o áudio em si não é enviado ao modelo.

Por ser um passo separado do chat, a voz depende de a sua organização ter o recurso habilitado, independentemente do modelo que você usa na conversa.

A voz não substitui o teclado

Trate a transcrição como um rascunho: revise nomes próprios, números e termos técnicos antes de enviar. Você pode ditar um trecho, corrigir digitando e só então mandar — tudo no mesmo campo de mensagem.

Idioma​

A transcrição segue a configuração de idioma do app (por exemplo, PT ou EN no Desktop, em Configurações → Info). Fale no idioma configurado para obter o melhor reconhecimento.

Requisitos​

Para usar a voz, você precisa de:

  • Um microfone e a permissão para o Imaginne acessá-lo — do sistema operacional (Desktop/TUI) ou do navegador (chat web). No primeiro uso, a autorização é solicitada.
  • Credenciais de voz habilitadas pela sua organização. A transcrição é processada pelo serviço de voz da plataforma; se a sua org não habilitou esse recurso, a voz fica indisponível mesmo com microfone.
  • Na TUI, um build com a tag voice (veja acima).
  • No chat web, um navegador com suporte a gravação de áudio (Chrome, Edge, Firefox e Safari recentes).
Voz indisponível?

Se o botão (Desktop e chat web) ou os atalhos (TUI) não funcionam, verifique nesta ordem: permissão de microfone, se a org habilitou voz e, na TUI, se o build tem a tag voice. Veja Solução de problemas.

Veja também​

Usar no Desktop

O composer, os comandos e o resto da interface.

Abrir →Usar no terminal

Atalhos e comandos da TUI.

Abrir →Solução de problemas

Quando a voz não aparece.

Abrir →