Isenção de responsabilidade: Este artigo foi gerado usando tradução automática.

Mapeamento de URL

Atualização
  • Atualizado em Feb 4, 2026
  • Publicado em Nov 25, 2024
  • 11 minuto(s) lido(s)
Prev Next

O recurso de Mapeamento de URL dentro do widget da base de conhecimento permite personalizar a exibição de artigos e categorias específicas com base nas páginas que seus usuários finais visitam. Essa funcionalidade não apenas melhora a experiência do usuário ao direcionar para conteúdos relevantes, mas também permite que você oculte o widget da base de conhecimento em determinadas URLs ou forneça uma barra de busca com marcadores personalizados, orientando os usuários sobre o que pesquisar.

Uso do mapeamento de URL

Para configurar o mapeamento de URLs, você executa ações específicas dentro do widget da base de conhecimento para URLs designadas.

Ações

Existem quatro ações que você pode executar com mapeamento de URL:

  1. Artigo do programa: Exibe um único artigo na URL especificada.

  2. Mostrar lista de artigos: Lista artigos selecionados na seção Recomendados dentro do widget da Base de Conhecimento na URL especificada.

  3. Mostrar resultados da busca: Permite definir um termo de busca específico para consultar sua base de conhecimento, retornando resultados relevantes na URL especificada.

  4. Ocultar widget: Impede que o ícone do widget da Base de Conhecimento apareça na URL especificada.

Você pode encontrar essas ações na aba de mapeamento de URL ou ao editar um mapeamento existente.

NOTA

Para que o mapeamento de URL funcione, o widget da Base de Conhecimento deve estar instalado dentro do seu site ou aplicativo. Para mais informações, leia o artigo sobre Instalação do widget da Base de Conhecimento.

Parâmetros de URL

Ao configurar a URL do widget da Base de Conhecimento, você pode incluir três tipos de parâmetros:

  1. Inclua o Caminho: /thisis/a/path

  2. Inclua Consulta: ?animal=bear

  3. Inclua Hash: #inbox

Você também pode ativar o botão Is Regex para incorporar expressões regulares nas configurações de URL.

Adicionando mapeamento de URL ao seu Widget

Para integrar o widget desejado ao seu site de base de conhecimento, siga estes passos:

  1. Navegue até Conexões () > widget da Base de Conhecimento na barra de navegação esquerda do Knowledge base portal.

  2. Vá até o widget desejado e clique na aba de mapeamento de URL .

  3. Você pode escolher Ask Eddy AI para fazer quaisquer dúvidas, buscar um artigo ou escolher Mapeamento de Novas URLs.

  4. Clique em novo mapeamento de URL e especifique o seguinte:

    • Nome - O nome do mapeamento de URL só será exibido no registro de mapeamento de URL dentro do Document360

    • Estrutura de URL  - Selecione o tipo de parâmetro de URL desejado (Incluir caminho/Incluir consulta/Incluir hash). Você deve ativar pelo menos um parâmetro de URL

    • Digite a URL onde você quer que o artigo/categoria apareça ou que a ação ocorra.

      NOTA

      Seu nome de domínio não está incluído no caminho da URL. Por exemplo, https://document360.com/ebook/rapid-guide-to-launch-your-knowledge-base/, seu Caminho de URL seria /ebook/rapid-guide-to-launch-your-knowledge-base/

    • Ação - Selecione a ação desejada.

    • Selecione o espaço de trabalho - Selecione a versão desejada (se você tiver várias versões).

    • Idioma para - Selecione o idioma desejado (se você tiver vários idiomas).

    • Artigo para mostrar - Na barra de busca, selecione os artigos/categorias que você deseja mostrar na documentação da sua base de conhecimento.

    NOTA

    Categorias de pastas não estão disponíveis para seleção. Apenas tipos de páginas e categorias de índice estão disponíveis para seleção.

  5. Clique em Criar.

Uma vez que um usuário final acesse o caminho da URL especificada e abra o widget da Base de Conhecimento, ele verá o artigo/categoria mapeada. Essas informações permanecem consistentes enquanto eles navegam entre as abas do widget da Base de Conhecimento dentro da mesma versão e idioma.

Configuração da assistência de IA Contextual

A opção de assistência de IA Contextual permite exibir prompts alimentados por IA no widget da Base de Conhecimento. De acordo com sua configuração, esses prompts podem aparecer tanto quando os usuários clicam em um botão quanto automaticamente ao abrirem uma página específica junto com a resposta aos prompts.

Widget configuration interface showing URL mapping and contextual AI assistance options.

NOTA

Para configurar a assistência de IA Contextual, certifique-se de que a busca assistida por IA esteja habilitada para o widget.

Entendendo os tipos de prompts

Você pode configurar a assistência de IA Contextual de duas maneiras.

  1. Prompting baseado em botões

  2. Prompts em nível de página

Prompting baseado em botões

Use essa opção para exibir ajuda contextual quando os leitores clicarem em botões específicos do seu site ou aplicativo.

  • Cada prompt que você adiciona gera uma chave de gatilho única.

  • O prompt é validado automaticamente ao pressionar Enter para confirmar se uma resposta foi encontrada nas suas fontes conectadas.

  • Você pode atualizar um botão existente adicionando o atributo d360AIHelp personalizado com a chave Trigger como valor, ou criar um novo botão copiando o trecho do código de instalação e colando-o no seu HTML.

  • Quando o botão é clicado, o widget se abre automaticamente e exibe o prompt de IA configurado com sua resposta correspondente.

  • Você pode configurar até 5 mapeamentos de botão e prompt por URL.

  • Se vários botões estiverem configurados na mesma página:

    • O prompt para o botão clicado é exibido primeiro.

    • Prompts de outros botões aparecem no widget como consultas relacionadas ou sugeridas.

Prompts em nível de página

Use essa opção para fornecer ajuda impulsionada por IA automaticamente quando os usuários abrirem uma página específica, sem exigir qualquer interação com botões.

  • Para escolher essa opção, selecione Ativar o prompting em nível de página durante a configuração de assistência de IA Contextual.

  • Adicione um ou mais prompts que serão acionados quando os usuários acessarem a URL configurada. O prompt é validado automaticamente ao pressionar Enter para confirmar se uma resposta foi encontrada nas suas fontes conectadas.

  • Você pode adicionar até 5 prompts por página.

    • O primeiro prompt é mostrado como a pergunta principal.

    • Os prompts restantes aparecem como consultas sugeridas.

Adicionar, validar e remover prompts

Para prompts baseados em botões

  1. Na seção Configurar assistência de IA contextual , deixe o aviso Ativar o nível de página desmarcado.

Configuration options for a contextual AI assistance widget with various actions listed.

  1. Em seguida, insira o prompt de busca.

  2. Pressione Enter para validar o prompt.

    • Se o sistema encontrar uma resposta, ele exibe a Resposta encontrada ao lado do prompt como um rótulo verde.

    • Se nenhum resultado correspondente for encontrado, o sistema exibe Resposta não encontrada como um rótulo vermelho.

  3. Se você estiver atualizando um botão existente, copie a chave Trigger e adicione-a ao código do botão existente usando o d360AIHelp atributo.

    Por exemplo,

    <button d360AIHelp="no6gNpyDqtyBhCVFMhYDXhugZ">Need help?</button>

Instructions for adding URL mapping and contextual AI assistance in a widget interface.

  1. Se você estiver criando um novo botão, clique em Copiar código ao lado de Código de Instalação para criar o novo botão, depois cole o trecho no HTML da sua página.

Instructions for configuring contextual AI assistance with a widget installation code.

  1. Para adicionar outro prompt baseado em botões, clique em Adicionar mais e repita o processo.

  2. Para remover um prompt, clique em Remover ao lado da entrada correspondente.

Para prompts em nível de página

Configuration options for a widget including URL mapping and contextual AI assistance settings.

  1. Selecione a caixa de seleção Ativar prompts em nível de página .

  2. No campo de prompt de busca, insira sua consulta.

  3. Pressione Enter para validar o prompt.

    • Se o sistema encontrar uma resposta, ele exibe a Resposta encontrada ao lado do prompt como um rótulo verde.

    • Se nenhum resultado correspondente for encontrado, o sistema exibe Resposta não encontrada como um rótulo vermelho.

  4. Para adicionar outro prompt, clique em Adicionar mais e insira uma nova consulta. Repita até adicionar até quatro prompts para essa URL.

  5. Para excluir um prompt, clique em Remover ao lado do campo de prompt.

Depois de configurar prompts baseados em botões ou em nível de página, clique em Criar.

Você pode combinar ações padrão de mapeamento de URLs (como Mostrar artigo) com assistência de IA Contextual entre diferentes URLs para oferecer uma experiência de usuário personalizada e inteligente.

Editando o mapeamento de URL

Para modificar um mapeamento de URL existente:

  1. Passe o mouse no widget desejado da Base de Conhecimento e clique no ícone Editar ().

    Na aba de mapeamento de URLs , você pode encontrar a lista de mapeamentos de URL disponíveis.

  2. Passe o mouse sobre o mapeamento de URL desejado e clique no ícone Editar ().

    O painel de mapeamento Atualizar URL vai aparecer.

  3. Atualize as informações desejadas e clique em Atualizar.

Deletando mapeamento de URL

Você pode deletar um mapeamento de URL definido.

  1. Passe o mouse no widget desejado da Base de Conhecimento e clique no ícone Editar ().

  2. Na aba de mapeamento de URLs , você pode encontrar a lista de mapeamentos de URL disponíveis.

  3. Passe o mouse sobre o mapeamento de URL desejado e clique no ícone Excluir ().

  4. Clique em sim no prompt de confirmação de Exclusão .

Configurações de mapeamento de URL

Você pode definir o comportamento do widget da Knowledge Base para URLs que não possuem um mapeamento configurado. Definir esse comportamento pode melhorar a experiência do usuário e o acesso à documentação.

Settings for configuring a knowledge base widget, highlighting URL mapping options.

  1. Vá até o widget desejado e clique em Editar.

  2. Clique na aba Configurar & conectar .

  3. Na seção Definir controles , expanda a seção de configurações de mapeamento de URL .

  4. Selecione a opção desejada:

    • Navegue até a página de ajuda/base de conhecimento: Selecione esta opção para exibir o artigo/categoria na aba Ajuda de Página ou na aba Knowledge Base no Widget.

    • Não faça nenhuma alteração na configuração existente: Selecione esta opção para exibir o último artigo/categoria aberto no Widget.

  5. Clique em Salvar.

Correspondência básica de URL

Compreender a correspondência de URLs é crucial para um mapeamento eficaz de URLs. Um regex de uso geral para corresponder a URLs típicas é o seguinte:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Explicação dos componentes

  • ^https?://?: Corresponde ao protocolo (por exemplo, http:// ou https://). Isso ? torna o protocolo opcional.

    NOTA

    Certifique-se de adicionar uma barra para trás (\) antes de cada barra para frente (/) ao testar sua URL no https://regex101.com.

  • [a-zA-Z0-9.-]+: Corresponde ao nome de domínio, incluindo letras, números, pontos (.) e hífens (-).

  • /[a-zA-Z0-9/._-]*?: Corresponde ao caminho após o domínio, permitindo barras, caracteres alfanuméricos, pontos, sublinhados e hífens.

  • ?[a-zA-Z0-9=&._-]*?: Corresponde aos parâmetros opcionais da consulta (por exemplo, ?key=value), tornando essa parte opcional.

  • #[a-zA-Z0-9_-]*?: Corresponde ao fragmento (por exemplo, #section), que também é opcional.

Exemplos de mapeamento de URL usando Regex

Mapeamento de estruturas específicas de URL

A tabela a seguir mostra como configurar mapeamentos de URL para certos padrões de URL. Essas configurações ajudam a garantir correspondências precisas com base no caminho da URL ou na estrutura de consulta.

Estrutura da URL

Configuração de mapeamento de URL

/buckets

/buckets$
(Configure se a URL terminar com buckets)

/buckets?isCreatingBucket

/buckets\?[a-z]*
(Configure se a URL tiver textos aleatórios após o parâmetro de consulta)

Exemplos de partidas

  • /buckets

  • /buckets?isCreatingBucket

  • /buckets?isCreatingBucket=true

Para mapear um padrão de URL como /users/{id}, use:

^/users/[0-9]+$

Isso captura um ID de usuário dinamicamente.

Exemplos de Partidas

  • /users/123

  • /users/456

Mapeamento de URLs com parâmetros de consulta

Para URLs como /search?q={query}, o regex seria:

^/search?q=[a-zA-Z0-9]+$

Exemplos de Partidas

  • /search?q=apple

  • /search?q=123abc

Mapeamento de URLs com parâmetros opcionais

Para um padrão de URL como /products/{category}/{id}, onde a categoria é opcional:

^/products/[a-zA-Z]+?/[0-9]+$

Exemplos de Partidas

  • /products/123

  • /products/electronics/123

Mapeando URLs com um coringa ou múltiplos caminhos

Para /blog/*:

^/blog/.*?$

Exemplos de Partidas

  • /blog

  • /blog/how-to-code

  • /blog/2021/10

Mapeamento de URLs com subdomínios
Para URLs de subdomínio:

^https?://?[a-zA-Z0-9-]+.example.com$

Exemplos de Partidas

  • http://blog.example.com

  • https://shop.example.com

Combinação de múltiplos componentes

Para lidar com mapeamentos de URL mais complexos, você pode combinar os vários componentes conforme necessário. O regex abrangente que corresponde a uma URL com um protocolo opcional, domínio, caminho, parâmetros de consulta e fragmento é o seguinte:

^https?://?[a-zA-Z0-9.-]+/[a-zA-Z0-9/._-]*??[a-zA-Z0-9=&._-]*?#[a-zA-Z0-9_-]*?$

Perguntas Freqüentes

Como posso remover a barra de ajuda de página e de busca do widget quando o mapeamento de URL para um único artigo está configurado?

Para remover a barra de ajuda de página e de busca do widget quando o mapeamento de URL para um único artigo for configurado:

  1. Navegue até o Widget () no portal da base de conhecimento.

  2. Passe o mouse sobre o widget desejado e clique no ícone Editar ().

  3. Cole o código fornecido na aba CSS Personalizada :

    li#page-help-tab {
    display: none;
}

.article-header .article-back-icon {
    display: none;
}

.search-container {
    display: none !Important;
}

  4. Cole o código fornecido na aba JavaScript Personalizada :

    setTimeout(function() { $('.search-container').hide();}, 2000);
setTimeout(function() { $("#knowledge-base-tab").click();}, 2000);

  5. Clique em Salvar.

Isso vai ocultar a aba de ajuda da página e a barra de busca no widget do site da Base de Conhecimento quando o mapeamento de URL para um único artigo estiver configurado.

Como posso ver as atualizações imediatamente no Widget da Base de Dados após adicionar ou atualizar um Mapa de URL?

As atualizações são armazenadas em cache no servidor por razões de desempenho e são atualizadas automaticamente a cada 15 minutos. No entanto, se precisar ver as mudanças imediatamente, pode limpar o cache da aplicação.

Por que um mapeamento de URL configurado parece quebrado?

O mapeamento de URL seria quebrado devido a quaisquer alterações na configuração de 'Filtrar conteúdo do widget' na aba 'Instalação & configuração'. Verifique o mapeamento de URL e atualize a configuração.

O que é mapeamento de URLs?

Com o mapeamento de URLs, você pode fazer com que artigos e categorias específicas apareçam no widget da base de conhecimento, dependendo da página em que o usuário final está. Você também pode usar o mapeamento de URL para esconder o widget da Knowledge Base em uma URL específica ou fornecer uma barra de busca com um marcador personalizado para indicar aos usuários finais a direção certa sobre o que pesquisar.

Posso adicionar expressões regulares (regex) no mapeamento de URLs?

Você pode incluir expressões regulares na sua URL ativando o botão Is Regex.

O que é regex?

Regex, abreviação de "expressão regular", é uma sequência de caracteres que define um padrão de busca usado para corresponder e manipular strings de texto.

Por exemplo, você pode usar regex para configurar um único mapeamento de URL para múltiplos artigos com URLs semelhantes. Considere um cenário em que você deseja configurar o mapeamento de URL para os seguintes artigos com a URL base 'https://example.com/docs/drive':

  • https://example.com/drive-General

  • https://example.com/drive-settings

  • https://example.com/drive-functionA

  • https://example.com/drive-functionB

  • https://example.com/drive-functionC

  • https://example.com/drive-functionD

  • https://example.com/drive-functionE

Sem regex, você precisaria adicionar mapeamentos individuais de URL para cada URL. No entanto, ao ativar a regex, você pode adicionar com um único mapeamento de URL: selecione a opção "Incluir caminho" e adicione docs/drive no campo URL. Você pode usar regex para ter um processo de mapeamento mais eficiente e eficiente.

Posso adicionar mapeamento de URL para categorias?

Sim, você pode adicionar mapeamento de URL para categorias. Ele se aplica apenas às categorias de páginas e índices.

Artigos relacionados