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.