Ir para o conteúdo
Promovaweb

Pós-processamento com IA

StayCloudVPS Agêntica

Uma VPS para os seus agentes trabalharem dia e noite

Instale o SetupVibe Desktop numa VPS da StayCloud em São Paulo, com acesso root e disco NVMe. Deixe Claude Code, Codex e OpenCode rodando no tmux ou no Herdr e feche o notebook sem interromper nada.

Montar minha VPS Agêntica

Link de parceiro da Promovaweb.

Black Friday até 30/11

30%off

nos 2 primeiros meses do plano mensal da VPS

  • Backup diário grátis para sempre
  • Servidores em São Paulo no datacenter da Ascenty
  • Datacenter Tier III manutenção sem parada
  • Acesso root com disco SSD NVMe
  • Réplica do backup em Ashburn, nos EUA

O pós-processamento envia a transcrição a um modelo de linguagem antes de colar, para corrigir pontuação, reorganizar em tópicos, traduzir ou aplicar qualquer instrução sua. Ele é experimental, tem atalho próprio e, com um provedor na nuvem, envia o texto para fora do computador, enquanto a transcrição comum continua local.

Sumário da página

  1. Da fala crua ao texto arrumado
  2. Um atalho separado
  3. Os provedores
  4. O prompt e a variável de saída
  5. Modelos locais pelo LM Studio
  6. Os limites

Da fala crua ao texto arrumado

A fala tem ritmo de conversa. Você repete uma ideia, volta atrás, fala “vírgula” esperando uma vírgula. O modelo de transcrição escreve o que ouviu. O resultado precisa de uma passada antes de virar um prompt limpo ou uma lista de requisitos. O pós-processamento faz essa passada com um modelo de linguagem, entre a transcrição e a colagem.

A documentação oficial marca o recurso como Alpha. Ele pode corrigir gramática, reformatar o texto, traduzir, inserir pontuação ou aplicar qualquer transformação descrita num prompt. O texto que chega ao campo é a saída do modelo, não a transcrição crua.

Um atalho separado

O pós-processamento fica atrás da chave de recursos experimentais. Na aba Advanced, você liga Experimental Features e depois Post Processing. Uma seção nova aparece na barra lateral das configurações. Ali entram o provedor, a chave de API, o modelo e o prompt.

O recurso tem um atalho próprio. A documentação é clara: só esse atalho aciona o pós-processamento. O atalho comum de transcrição entrega só o texto cru. No macOS, o padrão é Option+Shift+Space. Assim você escolhe, a cada ditado, se o texto passa ou não pelo modelo. O README mostra o comando handy --toggle-post-process para acionar o mesmo modo por linha de comando.

  1. Transcrição local

    O modelo de fala transcreve o áudio no computador, como num ditado comum.

  2. Prompt montado

    A variável ${output} do seu prompt recebe a transcrição crua.

  3. Modelo de linguagem

    O provedor escolhido, na nuvem ou local, processa o prompt.

  4. Texto colado

    A resposta do modelo é colada no campo ativo e entra no histórico.

O caminho de um ditado com o atalho de pós-processamento, com o modelo de linguagem entre a transcrição e a colagem.

Os provedores

A documentação lista provedores na nuvem, um modelo no dispositivo e um endpoint próprio. Na nuvem, aparecem a OpenAI, com o GPT-4o-mini recomendado, a Anthropic, com o Claude Haiku, o OpenRouter, que dá acesso a vários modelos com uma chave só, o Groq e o Cerebras, pela velocidade, além da Z.AI, com o GLM-4.5-Air. A política de privacidade inclui ainda o AWS Bedrock entre os provedores suportados.

No dispositivo, o Apple Intelligence funciona em Macs com Apple Silicon e macOS 26 ou mais recente. O provedor Custom aceita qualquer endpoint compatível com a API da OpenAI. É por ele que entram os modelos locais. Desde a 0.10.0, o provedor Custom também aceita o formato da API Messages da Anthropic, segundo as notas da release.

TipoExemplos da documentaçãoPara onde vai o texto
NuvemOpenAI, Anthropic, OpenRouter, Groq, Cerebras e Z.AI.Para o provedor, direto do seu computador, com a sua chave.
No dispositivoApple Intelligence, em Macs com Apple Silicon e macOS 26 ou mais recente.Fica no computador.
Endpoint próprioQualquer API compatível com a OpenAI, como o servidor local do LM Studio.Para o endereço configurado. Num servidor local, fica na máquina.

O prompt e a variável de saída

O prompt é seu. A variável ${output} marca o lugar da transcrição crua, que o Handy substitui antes de enviar. A documentação traz exemplos: corrigir gramática e pontuação sem mudar o sentido nem o tom, converter o texto em tópicos curtos, traduzir para outro idioma e trocar palavras faladas como “ponto” ou “vírgula” pelos sinais. O guia de perguntas frequentes informa que os modelos de fala não aceitam pontuação por comando de voz. O prompt de pontuação é o caminho indicado.

Para o ditado de prompts e specs, um prompt de pós-processamento pode exigir a mesma estrutura toda vez: o objetivo numa frase, os arquivos envolvidos, o comportamento esperado e o que não pode mudar. A fala solta chega ao campo já organizada. Você revisa o conteúdo em vez da forma. A discussão 715 do repositório reúne prompts compartilhados pela comunidade.

Modelos locais pelo LM Studio

Para manter o texto no computador, a documentação descreve o uso de um servidor local compatível com a API da OpenAI. Com o LM Studio, você carrega um modelo, liga o servidor local e aponta o provedor Custom do Handy para o endereço http://localhost:1234/v1. O autor relata bons resultados com o Qwen3 8B e modelos maiores. Ele avisa que modelos acima de 8 bilhões de parâmetros costumam ir bem, mas sem perfeição garantida.

Na nuvem, a recomendação é escolher um modelo razoavelmente capaz. Pelo OpenRouter, a sugestão é um modelo com mais de 20 bilhões de parâmetros.

Os limites

A documentação lista outros limites. O pós-processamento acrescenta espera, porque depende de uma chamada à API ou do tempo de inferência local. Sem internet, os provedores na nuvem falham, mas a transcrição continua funcionando. Modelos com menos de 3 bilhões de parâmetros costumam ignorar o prompt. Modelos de raciocínio podem devolver as marcações do raciocínio no texto colado. Desde a 0.10.0, quando o pós-processamento devolve um texto vazio, o Handy preserva o ditado original.

O recurso é opcional e fica fora do caminho comum. Para prompts curtos, a transcrição crua com uma revisão rápida resolve. Para specs longas ou briefings que precisam de formato fixo, o atalho de pós-processamento entrega o texto pronto para editar. O hub de histórico e privacidade mostra o que fica salvo em cada caso.

Continue na comunidade

Leve ao Discord da Promovaweb o modelo que erra o seu idioma, a colagem que não chega ao terminal ou o prompt ditado que o agente entendeu mal. A versão do Handy e o sistema operacional ajudam a comunidade a entender o caso.