Este artigo aborda a gestão de guias passo a passo: traduzi-los para outros idiomas, cloná-los entre espaços de trabalho, despublicar quando necessário e exportar 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 |
| GEO/SEO | Você quer que o guia seja encontrado pelos mecanismos de busca e citado por assistentes de IA, e precisa definir seu título, slug, e IA e descrição de busca |
| 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.
Você pode iniciar uma tradução de várias maneiras:
Traduzindo da página de Todos os artigos no idioma padrão
Use isso quando quiser traduzir um ou mais guias para vários idiomas em uma única ação.
-
Navegue até Documentação () no portal da Base de Conhecimento.
-
Certifique-se de estar na linguagem padrão do workspace.
-
No painel de navegação à esquerda, vá para Todos os Artigos ().
-
Selecione as caixas de seleção ao lado dos guias que você quer traduzir.
-
Clique em Traduzir com Eddy AI ().
-
Selecione os idiomas secundários exigidos no painel de tradução.
-
Digite sim e clique em Confirmar para continuar o processo de tradução.
Traduzindo da página Todos os artigos em língua secundária
Use isso quando um guia traduzido estiver marcado como Precisa de tradução (🌐), significando que a fonte foi atualizada e a tradução está desatualizada.
- Navegue até Documentação () no portal da Base de Conhecimento.
- Mude para o espaço de trabalho do segundo idioma obrigatório.
- Em Todos os Artigos, selecione os guias marcados Precisa de tradução (🌐).
- Clique em Mais () > Traduza com Eddy AI ().
Traduzindo a partir do guia passo a passo no idioma secundário
Use isso quando quiser traduzir um guia específico sem ter que se afastar do editor.
- Abra o guia passo a passo que você quer traduzir.
- Clique no ícone Traduzir com Eddy AI () no topo. Os créditos aproximados de tradução (caracteres) que a tradução usará são exibidos.
- Clique em Traduzir com Eddy AI para iniciar o processo de tradução.
Traduzindo do Document360 Engage
Use isso quando quiser traduzir guias junto com seus vídeos gravados e demonstrações interativas, ou encontrar os guias que ainda não foram traduzidos.
- Clique em Document360 Engajar () na barra de navegação da esquerda.
- Para encontrar guias que ainda precisam ser traduzidos, clique no ícone Filtro (), defina Tipo como Guia passo a passo e status de tradução como Preciso tradução, e clique em Aplicar.
- Selecione as caixas de seleção ao lado dos guias que você quer traduzir.
- Clique em Traduzir com Eddy AI. Os créditos aproximados de tradução (caracteres) que a tradução usará são exibidos.
- Digite sim na janela de confirmação e clique em Confirmar.
Para traduzir um único guia, passe o mouse sobre ele, clique no ícone Mais () e selecione Traduzir com Eddy AI. Para mais informações, veja Document360 Engage.
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.
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 site da Base de Conhecimento 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.
- 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.
Configuração de descrições GEO/SEO
Guias passo a passo são estruturados para agentes de IA e LLMs lerem. Um guia publicado é servido como uma página Markdown (.md) e listado no arquivo llms.txt da sua base de conhecimento, de modo que seu título e descrição de IA e busca determinam como um assistente de IA o representa.
Para definir esses valores, clique no ícone Mais (•••) no guia e selecione GEO/SEO. Para o procedimento completo, leia o artigo sobre Edição de um Guia Passo a Passo.
Guias passo a passo de clonagem
Clonar um guia passo a 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 em diferentes ambientes de trabalho.
Existem três maneiras de clonar um guia passo a passo no portal da base de conhecimento:
Clonagem a partir do painel Categorias & artigos
- Navegue até Documentação () na barra de navegação à esquerda do portal da Base de Conhecimento.
- Passe o mouse sobre o guia desejado no painel de navegação esquerdo, clique no ícone Mais () e selecione o ícone Clone ().
- No diálogo do guia passo a passo Clone , configure os campos conforme descrito nos campos de diálogo Clone abaixo.
- Clique em Clonar.
Clonagem a partir de uma categoria específica de Pasta ou Í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 ícone Clone ().
- No diálogo do guia passo a passo Clone, configure os campos conforme descrito nos campos de diálogo Clone abaixo.
- Clique em Clonar.
Clonagem do Document360 Engage
- Clique em Document360 Engajar () na barra de navegação da esquerda.
- Passe o mouse sobre o guia passo a passo desejado, clique no ícone Mais () e selecione Clonar.
- No diálogo do guia passo a passo Clone , configure os campos conforme descrito nos campos de diálogo Clone abaixo.
- Clique em Clonar.
O clone é criado como um novo artigo na Documentação, baseado na versão mais recente publicada ou rascunha do guia, o que for mais recente.
Campos de diálogo clone
| Campo | Descrição |
|---|---|
| Título | Insira um nome para o guia clonado. |
| Espaço de trabalho | Selecione o espaço de trabalho de destino. Clique em Reset para atribuí-lo ao workspace principal. |
| Categoria | Selecione uma categoria existente no espaço de trabalho de destino. |
| Referências cruzadas | Selecione Atualizar para clonado para apontar links no clone para a cópia clonada, ou Manter o original para mantê-los apontando para o original. |
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.
Somente usuários com permissão de Publicação podem cancelar artigos.
Você pode despublicar um guia passo a passo usando qualquer um dos seguintes métodos:
| Método | Etapas |
|---|---|
| Despublicar da seção Categorias & artigos | Navegue até Documentação () > Categorias e artigos > Clique em Mais () > selecione Despublicar (). |
| Despublicar da categoria Pasta/Índice | Navegue até Documentação () > passe o mouse sobre o guia passo a passo publicado > Clique em Mais () > selecione Despublicar (). Para despublicar vários guias, selecione-os e clique em Despublicar () no topo. |
| Despublicar da seção Todos os artigos () | Navegue até Documentação () > Todos os Artigos () > selecione um ou mais guias publicados > clique em Despublicar (). |
| Despublicar do editor de artigos | Navegue até Documentação () > abra o guia passo a passo > Clique em Mais () > selecione Despublicar (). |
Os passos a seguir são os mesmos independentemente do método utilizado.
O painel Confirmar despublicação aparece.
- Entra o Motivo para despublicar. Este é um campo opcional.
- Clique em Despublicar.
- Para editar ou republicar:
- Clique em Editar para fazer alterações.
- Clique em Publicar para republicar sem editar.
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 ().
Despublicar um guia também o remove de sitemap.xml e llms.txt.
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.
Exportação 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.
Exportação 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
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.
Você também pode gerenciar guias em massa pelo Document360 Engage, onde pode traduzir ou excluir vários guias ao mesmo tempo e filtrá-los por idioma, contribuidor ou status de tradução.