EnglishEdit.ai: como construí a IA da ferramenta de escrita em inglês

EnglishEdit.ai é uma ferramenta web pra quem escreve em inglês como segunda língua. Você cola o rascunho, escolhe quão pesada deve ser a edição e pra quem está escrevendo, e recebe o texto reescrito com cada mudança destacada. Ela também transforma gravações de reunião em transcrições legíveis, com identificação de quem falou. O produto está em englishedit.ai.

O produto não é meu. Em 2023 e 2024 fui o desenvolvedor contratado pra construir a camada de IA por baixo dele: dois plugins WordPress sob medida que conectam o site às APIs da OpenAI e se encaixam no sistema de usuários e créditos que já existia. Esta página é sobre esse trabalho, o que a ferramenta fazia quando entreguei e as decisões que fizeram funcionar. No que o produto virou depois, quem decide são os donos.

Plugin de Reescrita de Texto

O plugin de edição permite que o usuário configure parâmetros antes de enviar o texto: quão agressiva deve ser a edição (leve, moderada ou pesada), para quem está escrevendo (geral, negócios, acadêmico, e-mail, casual), qual variante do inglês usar e qual é o objetivo do texto.

Cada combinação alimenta um prompt que eu monto dinamicamente em PHP, a partir de strings de instrução mapeadas. O prompt é enviado para a API de completions da OpenAI e o resultado é comparado com o original usando uma biblioteca de diff em nível de caractere. Assim, em vez de simplesmente substituir o texto, o usuário vê exatamente o que mudou, destacado no próprio conteúdo. Essa visão de diff foi uma das partes mais legais do projeto, porque torna a sugestão da IA revisável, e não uma “caixa-preta”.

O plugin também registra cada requisição numa tabela de banco de dados dedicada (texto original, texto reescrito, contagem de tokens, timestamp), com uma tarefa agendada que remove registros com mais de 30 dias. Existe um painel administrativo onde o cliente consegue acompanhar o uso por usuário.

Plugin de Transcrição de Áudio

O plugin de transcrição permite que o usuário envie gravações de reuniões e receba transcrições formatadas. Ele usa o Whisper (OpenAI) para fala-para-texto, com uma etapa opcional de tradução quando o áudio não está em inglês.

O principal desafio técnico foi o limite de 25MB por arquivo na API do Whisper. Para gravações maiores, o plugin lê o arquivo em partes, envia cada trecho para o Whisper separadamente e depois recompõe o texto. Após a transcrição “crua”, o resultado passa por uma segunda chamada (GPT-4, com um prompt configurável de identificação de falantes). Assim, em vez de um muro de texto sem marcação, o usuário recebe uma transcrição legível, com atribuição de falas. Esse prompt fica configurável no admin do WordPress, permitindo ajustar a formatação sem mexer no código.

O plugin integra com o sistema de créditos já existente no site, descontando o uso com base na duração do áudio antes do processamento. O usuário também pode salvar as transcrições diretamente como posts no WordPress.

Abordagem

Os dois plugins seguem convenções padrão do WordPress: Settings API para configuração, handlers AJAX com verificação de nonce e shortcodes para embutir em páginas. O frontend é jQuery. O trabalho de IA é principalmente engenharia de prompt e integração de APIs: escolher o modelo certo para cada etapa, estruturar instruções e tratar os casos de borda.

APIs: OpenAI (GPT-3.5-turbo-instruct, Whisper, GPT-4)

Bibliotecas: orhanerday/openai-php, jfcherng/php-diff

Plataforma: WordPress (PHP, jQuery)