A documentação do WooCommerce passou a ser monitorada por um sistema criado para reduzir respostas incorretas de assistentes de inteligência artificial. O projeto surgiu depois que um comerciante não conseguiu encontrar, no leitor de cartões, o botão indicado pela ferramenta de suporte: “tap ‘Simple Payment.’”
Documentação do WooCommerce precisava acompanhar o produto
O problema ocorreu porque o botão havia sido renomeado para “Add Custom Amount” meses antes, enquanto a documentação ainda apresentava o nome antigo. Assim, o assistente consultou uma fonte que parecia confiável, respondeu com segurança, mas acabou orientando o usuário para uma opção inexistente.
O caso foi comunicado à equipe de suporte. Em seguida, o guia de início rápido e a página do produto foram atualizados. Para David Wilson, engenheiro de IA da Automattic, o episódio mostrou que o assistente havia feito exatamente o que deveria: leu a documentação do WooCommerce e reproduziu o que encontrou. A falha estava na diferença entre o material publicado e a versão atual do produto.
Esse descompasso pode aparecer sempre que uma plataforma recebe mudanças frequentes. Um recurso pode trocar de nome, uma configuração pode mudar de lugar ou uma função nova pode ser lançada, enquanto a documentação do WooCommerce permanece temporariamente desatualizada. Por isso, uma resposta de IA pode soar correta mesmo quando não corresponde à tela vista pelo usuário.
Como funciona o sistema de atualização
Para diminuir esse intervalo, a Automattic desenvolveu um plugin de WordPress como projeto interno. A ferramenta acompanha os lançamentos do WooCommerce e os pedidos de correção recebidos pela equipe. Quando identifica uma alteração, um modelo de IA prepara uma sugestão de atualização para a documentação do WooCommerce.
Antes de qualquer publicação, o conteúdo passa por etapas de controle:
- A sugestão recebe uma nota de 1 a 5, com base em critérios como precisão, tom de voz, estrutura, gramática, estilo, facilidade de localização e elementos visuais.
- Verificações automáticas procuram problemas. Um texto é encaminhado para revisão humana se apagar mais de cerca de 30% de uma página, alterar sua formatação, deixar um marcador ou inserir um novo link de imagem.
- Um redator da equipe confere a versão em uma prévia e aprova o material antes que ele seja publicado em woocommerce.com.
Um dos critérios considera que o primeiro parágrafo de cada guia deve funcionar como uma resposta independente, capaz de ser citada por uma IA. Dessa forma, a documentação do WooCommerce não é preparada apenas para pessoas que navegam pelas páginas, mas também para servir de base às respostas automatizadas.
Auditoria encontrou falhas e levou a novos controles
O sistema também avalia páginas que já estão no ar, usando a mesma régua aplicada aos novos textos. Até o fim de junho, 39 dos 117 documentos do WooCommerce analisados estavam abaixo dos padrões de qualidade definidos pela equipe. A automação permite revisar esse material com mais frequência, algo difícil de fazer manualmente após cada lançamento.
Outro recurso aplica automaticamente uma lista de terminologia para manter nomes consistentes, como “WooCommerce”, em vez de “woocommerce”. No entanto, algumas entradas da lista eram orientações de redação, e não simples substituições de palavras. Como o sistema não diferenciou os dois casos, uma página publicada chegou a exibir “(descriptive link text describing the destination)” no local onde deveria haver um link.
Depois de identificar o erro, a equipe auditou os 258 documentos do WooCommerce e encontrou 9 afetados. Todos foram corrigidos, as entradas problemáticas foram removidas e uma barreira adicional foi criada para evitar a repetição do problema. O episódio reforçou que a automação segue as regras literalmente: ela é rápida, mas não avalia o contexto como uma pessoa.
O que fazer ao receber uma resposta de IA
Quando uma instrução fornecida por IA não corresponde ao que aparece na tela, o usuário não deve concluir imediatamente que cometeu um erro. A recomendação é conferir a documentação do WooCommerce usada como fonte, pois ela pode não refletir a versão mais recente do produto.
- Ao usar o assistente de IA, avalie negativamente a resposta ou toque em “Contact Support” para informar o problema.
- Se um guia parecer desatualizado, use o botão “Was this guide helpful?” no fim da página para avisar a equipe.
No caso do leitor de cartões, nem o comerciante nem a IA foram responsáveis pelo desencontro. A solução encontrada foi criar processos para atualizar a documentação do WooCommerce com rapidez, manter a revisão humana em pontos importantes e auditar as etapas automatizadas.
Com informações de woocommerce.com.
