Este artigo aborda a gestão de Step by step guidepasso – traduzindo-os para outros idiomas, clonando-os em ambientes de trabalho, despublicando quando necessário e exportando para uso offline.
Quando usar cada ação
Ação | Use quando... |
|---|---|
Traduzir | Sua base de conhecimento atende leitores em vários idiomas, e você quer que o guia esteja disponível no idioma do workspace deles |
Clone | Você precisa de um guia quase idêntico para um nível de produto, região ou espaço de trabalho diferente mais rápido do que regravar do zero |
Despublicar | Um guia cobre uma funcionalidade que mudou significativamente, está temporariamente indisponível ou foi publicada antes de estar pronta |
Exportar para PDF | Um leitor ou equipe interna precisa de uma versão offline ou imprimível do guia |
Guias de tradução passo a passo
Após a criação de um guia passo a passo no idioma padrão do workspace, ele pode ser traduzido para qualquer idioma secundário habilitado. Manter as traduções atualizadas garante que todos os usuários, independentemente do idioma, tenham acesso a documentação precisa e consistente.
Existem três métodos para iniciar a tradução:
Método 1: Da página Todos os artigos no idioma padrão
Método 2: Da página Todos Todos os artigos em língua secundária
Método 3: De dentro do guia individual passo a passo no idioma secundário
Traduza da página Todos os artigos no idioma padrão.
Use esse método quando quiser traduzir um ou mais guias passo a passo para um ou mais idiomas secundários em uma única ação. É a abordagem mais eficiente para lançamentos iniciais ou quando vários guias precisam ser localizados ao mesmo tempo, já que você pode selecionar e traduzir vários guias simultaneamente sem abrir cada um individualmente.
Navegue até Documentação () na barra de navegação à esquerda do Portal da base de conhecimento.
Certifique-se de estar na linguagem padrão do workspace.
No painel de navegação esquerdo, navegue para Todos os artigos ().
Na lista de artigos, selecione as caixas de seleção ao lado dos guias passo a passo que deseja traduzir.
Clique Translate with Eddy AI ().
Selecione os idiomas secundários necessários no painel de tradução que aparece.
Marque a caixa para confirmar e continuar com o processo de tradução
Clique em Traduzir.
Os guias passo a passo selecionados agora serão traduzidos para os idiomas escolhidos.
Traduza da página Todos os artigos em um idioma secundário
Use esse método quando um guia traduzido já estiver disponível em um idioma secundário e estiver marcado como Precisa de tradução (🌐). Esse status indica que o guia fonte original foi atualizado desde a última geração da tradução, o que significa que a versão do segundo idioma pode estar desatualizada. Esse método é ideal para revisões periódicas de localização ou para gerenciar um acúmulo de guias que precisam ser atualizados em um espaço de trabalho específico de idioma.
Navegue até Documentação () na barra de navegação à esquerda do Portal da base de conhecimento.
Mude para o espaço de trabalho do segundo idioma obrigatório.
Na lista de artigos, selecione as caixas de seleção ao lado dos guias passo a passo que deseja traduzir. Filtre guias que mostrem Precisa de tradução (🌐), se necessário.
Clique Translate with Eddy AI ().
Um indicador de progresso aparecerá até que a tradução seja concluída. Uma vez concluído, o conteúdo será traduzido; a formatação permanecerá consistente em todos os idiomas.
Traduza a partir do editor de guias passo a passo
Use esse método quando quiser traduzir um guia específico enquanto o revisa ou edita no editor. Ele é ideal para colaboradores que estão trabalhando em um guia e querem acionar a tradução sem se afastar, mantendo o fluxo de trabalho focado em um único conteúdo.
Navegue até o guia passo a passo que você quer traduzir.
Certifique-se de que o conteúdo apropriado esteja disponível no editor.
Clique no Translate with Eddy AI ().
Clique Translate with Eddy AI para iniciar o processo de tradução.
Um indicador de progresso aparecerá até que a tradução seja concluída. Uma vez concluído, o conteúdo será traduzido; a formatação permanecerá consistente em todos os idiomas.
As versões traduzidas exibem um status de Traduzido ou Precisa de tradução , ajudando os colaboradores a identificar rapidamente guias que exigem atualizações de localização.
NOTA
Quando etapas são adicionadas ou removidas no guia padrão do idioma, essas mudanças são refletidas nas versões secundárias dentro do editor em estado de rascunho. Essas atualizações não são visíveis no Knowledge base site até que o guia seja retraduzido e publicado no idioma correspondente. O número total de etapas em um guia permanece consistente em todos os idiomas, garantindo alinhamento estrutural entre as versões fonte e traduzidas.
Status da tradução
Guias traduzidos exibem um status de Traduzido ou Precisa de tradução para que os colaboradores possam ver rapidamente o que precisa de atenção.
Um guia é marcado como Precisa de tradução (🌐) quando:
Um novo guia é criado
O guia de fontes é atualizado
Passos são adicionados, removidos ou reorganizados no idioma de origem
As sobreposições de texto dentro das imagens são alteradas
Uma nova linguagem de workspace é adicionada
Quando o guia de origem é atualizado, as versões traduzidas são automaticamente marcadas como Precisa de tradução. Os colaboradores escolhem quando retraduzir.
NOTA
Durante a retradução, os créditos de tradução são calculados para todo o guia passo a passo, não apenas para as etapas modificadas.
Créditos de tradução são calculados com base em títulos de passos, descrições e sobreposições de texto nas imagens de passos. Elementos visuais como destaques, regiões de destaque e áreas de desfoque não consomem créditos a menos que incluam texto editável.
Solução de problemas de tradução
Um guia traduzido mostra o conteúdo do idioma fonte em vez da tradução - navegue até o guia no workspace do segundo idioma e verifique seu status. Tente publicar a partir do segundo idioma. Se o guia estiver marcado como Traduzido, clique em Marcar como Precisa de tradução, depois selecione Translate with Eddy AI e retraduzir o guia novamente.
O botão Traduzir com Eddy AI está desativado - Confirme que a tradução Eddy AI está ativada para seu projeto em Configurações > Configurações de IA > configurações de Eddy AI. Também verifique se seu plano de projeto inclui a suíte de tradução de IA, entre em contato com o suporte caso não tenha certeza.
Créditos de tradução foram consumidos mais do que o esperado - Créditos são cobrados por títulos de passos, descrições e sobreposições de texto. Se seu guia usar muitas sobreposições de anotação de texto (adicionadas via elemento Texto no editor), todas contam para o total de créditos. Elementos apenas visuais, como destaques e desfoque, não consomem créditos.
Guias passo a passo de clonagem
Clonagem, um Step by step guide passo cria uma cópia exata do conteúdo original como um novo guia. Você pode clonar guias passo a passo dentro do mesmo espaço de trabalho ou entre diferentes ambientes de trabalho.
Existem dois métodos para clonar um guia passo a passo no portal da base de conhecimento:
Método 1: Do painel .
Método 2: Dentro de uma categoria específica de Pasta ou Índice .
No , você pode clonar um guia passo a passo dentro ou entre os espaços de trabalho:
Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
Passe o mouse sobre o guia passo a passo desejado no painel de navegação esquerdo.
O ícone Mais () vai aparecer.
Clique no Mais () e selecione o Clone Clone ().
No diálogo do guia passo a passo do Clone , execute o seguinte:
Título: Insira o nome do guia passo a passo de clonagem.
Espaço de Trabalho: Selecione o espaço de trabalho desejado no menu suspenso. Clique em Resetar para atribuí-lo ao espaço de trabalho principal.
Categoria: Selecione uma categoria existente do espaço de trabalho selecionado.
Atualização automática dos links referenciados: Selecione esta caixa para garantir que os links no conteúdo do guia passo a passo sejam atualizados com base no espaço de trabalho/categoria de destino.
Referências cruzadas: Selecione Atualizar para clonado para atualizar automaticamente os links de referência cruzada para corresponder ao novo espaço de trabalho ou categoria, ou selecione Manter o original para manter os links apontando para o artigo original.
Clique Clone.
Para mover um guia passo a passo específico dentro de uma categoria específica de Pastas/Índice :
Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
Vá para a categoria de Pasta/Índice desejada.
Passe o mouse sobre o guia passo a passo desejado.
Clique no ícone Mais () e selecione o Clone ().
No diálogo do guia passo a passo do Clone , execute o seguinte:
Nome: Insira o nome do guia passo a passo de clonagem.
Espaço de Trabalho: Selecione o espaço de trabalho desejado no menu suspenso. Clique em Resetar para atribuí-lo ao espaço de trabalho principal.
Categoria: Selecione uma categoria existente do espaço de trabalho selecionado.
Atualização automática dos links referenciados: Selecione esta caixa para garantir que os links no conteúdo do guia passo a passo sejam atualizados com base no espaço de trabalho/categoria de destino.
Clique Clone.
Guia passo a passo para despublicar
Assim como ao despublicar um artigo comum, você também pode despublicar um guia passo a passo se ele não for mais necessário ou exigir atualizações.
Por exemplo, se um guia foi criado para uma funcionalidade que ainda está em desenvolvimento, mas foi publicada por engano, você pode despublicá-lo até que a funcionalidade esteja pronta. Isso garante que apenas informações precisas e finalizadas apareçam na sua base de conhecimento.
NOTA
Apenas contas de equipe com permissões de publicação podem despublicar artigos.
Você pode despublicar um guia passo a passo usando qualquer um dos seguintes métodos:
Método 1: Da seção
Método 2: Da categoria Pasta/Índice
Método 3: Da seção Todos os artigos ( )
Método 4: Do editor do artigo
Método 1
Para despublicar um guia passo a passo da seção :
Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
No , passe o mouse sobre o guia passo a passo publicado publicado.
Clique no ícone Mais () e selecione Cancelar publicação ().
O painel de Confirmar a despublicação será exibido.
Entra o Motivo para despublicar. Este é um campo opcional.
Clique Cancelar publicação.
Para editar ou republicar:
Clique em Editar para fazer alterações.
Clique em Publicar para republicar sem editar.
Método 2:
Para despublicar um guia passo a passo da categoria Pasta/Índice :
Navegue até a categoria desejada na Documentação ().
Passe o mouse sobre o guia passo a passo publicado no painel de navegação da esquerda e clique no Mais ().
Selecione Cancelar publicação ().
Alternativamente, para despublicar vários guias, selecione os guias publicados desejados e clique Cancelar publicação ( ) no topo.
O painel de Confirmar a despublicação será exibido.
Entra o Motivo para despublicar. Este é um campo opcional.
Clique Cancelar publicação.
Para editar ou republicar:
Clique em Editar para fazer alterações.
Clique em Publicar para republicar sem editar.
Método 3:
Para despublicar vários guias passo a passo da seção Todos os artigos :
Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
No painel de navegação esquerdo, navegue para Todos os artigos ().
Selecione um ou mais guias publicados.
Clique Cancelar publicação ( ) no topo.
O painel de Confirmar a despublicação será exibido.
Entra o Motivo para despublicar. Este é um campo opcional.
Clique Cancelar publicação.
Para republicar ou editar:
Clique em Editar para fazer alterações.
Clique em Publicar para republicar sem editar.
Método 4:
Para despublicar um guia passo a passo do editor do artigo:
Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
Abra o guia passo a passo publicado desejado e clique no ícone Mais() no canto superior direito.
Selecione Cancelar publicação ().
O painel de Confirmar a despublicação será exibido.
Entra o Motivo para despublicar. Este é um campo opcional.
Clique Cancelar publicação.
Para republicar ou editar:
Clique em Editar para fazer alterações.
Clique em Publicar para republicar sem editar.
NOTA
Uma vez que um guia passo a passo não seja publicado:
Despublicar um guia passo a passo muda seu status de Publicado para Rascunho.
Todos os links associados vão quebrar.
O guia ficará oculto do site da base de conhecimento.
No portal da Base de Conhecimento, o status aparecerá como Não Publicado e o ícone de status do guia passo a passo aparecerá em cinza ().
Exportando um guia passo a passo para PDF
Você pode exportar qualquer guia passo a passo em PDF, útil para compartilhamento offline, anexação a tickets de suporte ou impressão para treinamento presencial.
Do site da base de conhecimento
Navegue até o guia passo a passo publicado no site da Base de Conhecimento.
No cabeçalho do artigo, clique no ícone Mais ().
Selecione Exportar para PDF.
O PDF baixa automaticamente. Escolha um local de salvamento no explorador de arquivos e clique em Salvar.
Do portal da Base de Conhecimento
Navegue até o guia (rascunho ou publicado) no portal da Base de Conhecimento.
Clique no ícone de Mais () próximo à opção Compartilhar .
Selecione Exportar para PDF.
Uma versão PDF bem formatada do guia é baixada para o seu computador.
FAQ
Posso criar guias em todos os idiomas?
Guias passo a passo só podem ser criados no idioma padrão do workspace. Posteriormente, podem ser traduzidos para os idiomas secundários habilitados. Até que exista uma tradução, os leitores veem a versão padrão do idioma.
A Eddy AI usa conteúdo dos guias Step by step?
Sim. A Eddy AI busca o título, a descrição e o texto principal dos guias publicados ao responder às buscas. As respostas incluem uma citação que linka diretamente para o guia original.
Como posso visualizar os colaboradores?
Clique no ícone de Informações próximo ao selo de status. Um painel mostra a lista de colaboradores, contagem de passos, data de última atualização e detalhes de criação.
Como faço operações em massa para guias passo a passo?
Guias passo a passo funcionam de forma semelhante aos artigos e são exibidos na seção Todos os Artigos . Aqui, você pode gerenciá-los, pesquisá-los e organizá-los junto com outros artigos do seu projeto. Na seção Todos os Artigos , você pode usar filtros para ordenar guias por status (por exemplo, Rascunho, Publicado, Novo), categoria, tags ou data de modificação.
Como configuro o título e a descrição do SEO para um guia passo a passo?
Para configurar SEO para um guia passo a passo:
Navegue até o guia desejado no portal da Base de Conhecimento.
Clique no ícone Mais () e selecione SEO.
No diálogo Configurações do artigo , atualize o metatítulo, o slug e a descrição.
Clique em Salvar para aplicar as alterações.
Para mais informações, leia o artigo sobre Article SEO.
Como faço para acompanhar os eventos das atividades para guias passo a passo?
Para monitorar os eventos de atividade no guia passo a passo:
Navegue até Configurações () > Portal da base de conhecimento > auditoria da equipe no portal da base de conhecimento.
Na aba de auditoria de equipe , você encontrará atualizações sobre mudanças de visibilidade, atualizações de títulos e modificações de colaboradores para cada guia.
Para mais informações, leia o artigo sobre auditoria em equipe.
Como posso ativar o Índice do meu guia passo a passo?
Cada etapa de um guia pode aparecer como parte de um Índice no site da Base de Conhecimento. Para ativar o Sumário:
Navegue até Configurações () > Portal da base de conhecimento > Configurações de artigo e SEO no portal da base de conhecimento.
Na aba de configurações do Artigo , expanda o acordeão direito do Artigo .
Ative a opção Mostrar sumário .