AI Microcópia e Convenções de Nomenclatura

Last Updated outubro 20, 2026

Observação importante

Este artigo aborda convenções de nomenclatura e microcópia para os recursos do WalkMe AI: Joule (Barra de ação), AI SmartTips e AI Answers. Para obter conteúdo do DAP, como Smart Walk-Thrus, Launchers e SmartTips, visite Microcopy & Editor Organization Principles.

Breve Visão Geral

Padronizar a forma como você nomeia e escreve conteúdo de IA é uma das etapas mais impactantes que você pode dar para escalar seu programa de adoção de IA. Isso inclui regras de nomeação para itens no Editor e no Console, e a microcópia — texto de prompt, mensagens de validação e respostas de conversa — que molda a forma como os usuários experimentam a orientação de IA.

Uma boa microcópia de IA gera confiança do usuário. O feedback de IA específico, consistente e baseado na marca aumenta a probabilidade de os usuários se envolverem com os recursos de IA e agirem com base nas orientações que recebem.

Lembre-se: a padronização requer responsabilidade. Atribua um proprietário, como Líder de Projeto ou Gerente de Programa, e defina pontos de verificação antes de publicar.

 

Como isso afeta seu programa

Benefícios da operacionalização
  • Reduz a duplicação de prompts e fontes de conhecimento no Editor e no Console
  • Melhora a consistência e a qualidade das respostas geradas por IA vistas pelos usuários finais
  • Torna a localização e a atualização de itens de IA mais rápidos à medida que as políticas mudam
  • Cria confiança, garantindo que a orientação de IA pareça intencional e alinhada à marca

Riscos de não operacionalizar

  • Prompts conflitantes que produzem resultados de IA inconsistentes ou incorretos
  • Fontes de conhecimento duplicadas que levam a respostas de IA contraditórias
  • Aumento de solicitações de suporte e perda de confiança do usuário nos recursos de IA

Convenções de nomenclatura interna

Melhores práticas gerais

Evite adicionar o tipo de recurso WalkMe AI (AI SmartTip, AI Action, AI Answers) como um nome autônomo. Aqui estão exemplos de convenções de nomenclatura otimizadas por tipo de item de IA:

Joule Action (Action Bar)

  • Em vez de: Resumir
  • Uso: Ordem de Compra – Resumir

AI SmartTip Set

  • Em vez de: AI SmartTips Set 1
  • Use: Workday – Job Requisition Form – AI Validation

AI Answers Knowledge Source

  • Em vez de: Documentos de RH
  • Use: HR – Onboarding Policy Guide – 2025

Perguntas e Respostas personalizadas

  • Em vez de: Pergunta sobre VPN
  • Use: TI – Acesso: como faço para solicitar acesso à VPN?

Itens no menu WalkMe

Lembre-se de que os itens adicionados ao menu WalkMe , por exemplo, Smart Walk-Thrus ou recursos, exibirão o nome fornecido no editor para os usuários também. Você pode usar convenções de nomenclatura internas para dar mais contexto à sua equipe interna.

Observação: os Smart Walk-Thrus e os Recursos podem ter uma nomenclatura somente interna adicionada para fornecer mais contexto aos construtores.

Qualquer texto dentro de dois caracteres "|" no início do item WalkMe, só estará visível no editor para usuários internos do WalkMe. O texto fora desses caracteres estará visível para todos, incluindo os usuários finais.

Exemplo:

|Versão 1.0|Criar uma Oportunidade aparecerá no menu como Criar uma Oportunidade.

Barra de ação

O Joule integra o copiloto de IA corporativa da SAP com a Barra de ação do WalkMe, estendendo a assistência de IA a aplicativos SAP e de terceiros. Os construtores configuram Joule Skills, ações de IA personalizadas e lançadores de IA no Action Bar Console e no WalkMe Editor.

Convenção de Nomenclatura

Siga a mesma estrutura Processo – Objeto – Ação usada para Eventos Rastreados e outro conteúdo do DAP. Isso mantém a nomenclatura consistente em todo o seu programa WalkMe.

Aqui estão exemplos de uso da estrutura Processo - Objeto - Ação:

  • Ordem de Compra – Resumo – Gerar
  • Revisão de Desempenho – Draft – Criar
  • Fatura do fornecedor – Tradução – Executar

Microcópia: Rótulos de ação voltados para o usuário

Aplique os princípios de microcópia neste artigo. Além disso:

  • Comece com um verbo de ação: Resumir, Draft, Translate, Rewrite, Find, Convert.
  • Mantenha os rótulos no máximo de 3 a 5 palavras — os usuários escaneiam a Barra de ação, eles não a leem.
  • Associe os nomes das habilidades do Joule ao que o Joule Chat exibe, para evitar confundir os usuários que alternam entre os dois.
✓ Do ✗ Não
Resumir a Ordem de Compra Resumir
Reescreva no Tom Formal Ação de gravação de IA

 

SmartTips de IA

O AI SmartTips usa IA generativa para avaliar entradas de texto aberto em relação a um prompt definido pelo construtor, fornecendo feedback em tempo real enquanto os usuários digitam. Ao contrário do Validation SmartTips padrão, eles usam um prompt de linguagem natural, não uma regra fixa, para julgar se a entrada atende aos seus critérios.

Convenção de Nomenclatura

Use a mesma estrutura que os Conjuntos de SmartTips padrão, com um sufixo – AI para distingui-los dos SmartTips que não utilizam IA na mesma página ou formulário.

Formato: [App] – [Page/Form] – AI Validation

Exemplo: Workday – Job Requisition Form – AI Validation

Respostas de IA

O AI Answers é uma ferramenta de pesquisa por conversação no Menu WalkMe Pro. Baseado em fontes de conhecimento específicas da empresa, ele permite que os usuários façam perguntas em linguagem natural e recebam respostas contextuais sem sair do fluxo de trabalho.

Convenção de Nomenclatura

Formato: [Dept] – [Doc Type] – [Versão/Ano]

Exemplo: HR – Onboarding Policy Guide – 2025

Baixar modelos e ferramentas

Práticas recomendadas de microcópia - Exemplo de SOP

Inclui oito (8) dicas de microcópias e exemplos do que fazer/não fazer para cada. Com base neste guia, você pode criar uma lista de princípios padrão de microcópias do WalkMe para seus DAP Builders, Innovation Expert, AI SME e Content Authors.

Baixe aqui.

Começando: Lista de verificação para padronizar

As seguintes são considerações ao criar um Procedimento Operacional Padrão nesta área:

Lista de verificação de convenções de nomenclatura

☐ Quais são os meus padrões para nomear itens de IA no Editor (AI SmartTip Sets, AI Launchers)?

☐ Considerei quais nomes estão visíveis para os usuários finais na Barra de ação ou no Menu Pro?

☐ Quais são os meus padrões para nomear Ações do Joule usando a estrutura Processo – Objeto – Action?

☐ Quais são os meus padrões para nomear fontes de conhecimento do AI Answers e entradas de Perguntas e Respostas personalizadas?

☐ Quais são os meus padrões para nomear Eventos Rastreados relacionados a IA no Insights?

☐ Todas as mensagens de IA voltadas para o usuário seguem os seis princípios de microcópia?

☐ As mensagens são curtas (menos de 12 palavras por frase) e livres de voz passiva?

☐ Os rótulos e CTAs dizem aos usuários exatamente o que acontecerá?

☐ Os prompts do construtor são específicos, linguagem simples e referenciados a políticas, quando relevante?

☐ As respostas de Perguntas e Respostas personalizadas lideram a resposta direta e permanecem sob 150 palavras?

 

Pré-publicação da Lista de Verificação de Pontos de Verificação

☐ Qual é o meu processo para garantir que o conteúdo de IA cumpra esses padrões?

☐ Quem é responsável por revisar os prompts de IA e a microcópia antes de publicar?

☐ Qual é o meu processo para auditar conteúdo de IA após o go-live? Com que frequência?

Lista de verificação de administração

☐ Como esses procedimentos são documentados para priorizar a escala e reduzir o tempo administrativo?

☐ Com que frequência eles são revisados e quem é responsável por aplicá-los?

☐ Se houver alterações propostas, quem as aprova e como elas são comunicadas?

☐ Como saberemos se a implementação dessas normas foi bem-sucedida?

 

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×
×