A busca no site da base de conhecimento Document360 ajuda os leitores a encontrar artigos, categorias e anexos rapidamente usando uma barra de busca acima da lista de artigos. Os resultados são classificados por relevância e mostrados com o nome do conteúdo, uma prévia do texto correspondente e o caminho do breadcrumb. A busca avançada permite que os leitores filtrem resultados e busquem em múltiplos espaços de trabalho e idiomas ao mesmo tempo, e anexos de busca estendem a busca para texto dentro de arquivos PDF.
Quando usar busca avançada e filtros
Use buscas avançadas e filtros quando os leitores precisarem restringir os resultados além de uma simples correspondência de palavras-chave.
- Um leitor pesquisa um termo comum como "login" e precisa direcionar os resultados para um workspace ou idioma.
- Sua base de conhecimento abrange múltiplos espaços de trabalho, incluindo documentação de API, e os leitores precisam de uma única busca que cubra todos eles.
- Os leitores precisam encontrar conteúdo dentro dos anexos do PDF, não apenas textos de artigos.
Como a busca classifica resultados
Os resultados da busca são baseados nos seguintes atributos: títulos de artigos e categorias, tags, slugs, breadcrumbs e conteúdo textual dentro de artigos e categorias.
Sequência de prioridade de busca: Os resultados são classificados por relevância nesta ordem: Título > Tags > Slug > Breadcrumbs > Conteúdo/Descrição. Quando vários tipos de conteúdo (Artigos, Árvores de Decisão, documentação da API) correspondem a uma consulta, o resultado mais relevante aparece mais alto independentemente do tipo de conteúdo. Se a pontuação de relevância de uma árvore de decisão for maior ou igual à de um artigo, a árvore de decisão aparece mais alta nos resultados.
Como configurar as configurações de busca
As configurações a seguir estão configuradas em Configurações > Site da base de conhecimento > Configurações de artigo e SEO > Configurações do artigo , na seção de configurações de busca .
Habilitar busca avançada
- Navegue até Configurações > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.
- Navegue até Configurações de artigo e SEO.
- No acordeão de configurações de busca , ative a opção Ativar busca avançada .
- Selecione a caixa de seleção Incluir todos os espaços de trabalho nas buscas do site para definir o filtro de busca como Todos os espaços de trabalho (incluindo Documentação da API) por padrão, em vez de Espaço de Trabalho Atual.
Se ativar a busca avançada estiver desativada, as opções de filtro não aparecem no site da Base de Conhecimento.
Ative a aba de anexos na busca
- Navegue até Configurações > Site da base de conhecimento na barra de navegação esquerda do portal da base de conhecimento.
- Navegue até Configurações de artigo e SEO.
- Selecione a Configurações do artigo .
- Expanda o acordeão de configurações de busca e ative a aba Mostrar anexos na opção de busca.
Se a opção Mostrar arquivos de artigos estiver desativada, a aba Mostrar anexos na busca fica inacessível. Ligue primeiro no acordeão direito do artigo . Quando a aba Mostrar anexos na busca está desativada, a busca cobre apenas elementos de artigos e categorias, como título, slug, tags e conteúdo.
Não ative feedback de resultados de busca
- Navegue até Configurações > Site da base de conhecimento na barra de navegação à esquerda do portal da Base de Conhecimento.
- Navegue até Configurações de artigo e SEO.
- Selecione a Configurações do artigo .
- Expanda o acordeão de configurações de busca e ative a opção de não ter feedback de resultados de busca .
Quando essa opção está ativada e uma busca não retorna artigos, os leitores veem um formulário de feedback em vez de uma página de resultados em branco. O feedback enviado aparece no módulo de análise de busca . Quando a opção está desativada, buscas sem resultado mostram uma página de resultados em branco.
As configurações de busca agora estão configuradas para busca avançada, busca por anexos e feedback sem resultado.
Como os leitores usam a busca
Acessando buscas avançadas
- Clique na barra de busca e selecione Ir para a busca avançada.
- Use os filtros disponíveis para refinar os resultados.
| Filtro | Descrição |
|---|---|
| Espaço de trabalho | Workspace atual: resultados apenas do workspace ativo. Todos os espaços de trabalho: resultados em todos os espaços de trabalho, incluindo documentação da API. Específico: resultados de um ou mais espaços de trabalho selecionados. |
| Idioma | Idioma atual: resulta apenas na língua ativa. Todos os idiomas: resultados em todos os idiomas suportados. Específico: resultados de uma ou mais línguas selecionadas. |
| Tags | Reduz os resultados a artigos contendo as tags selecionadas. |
| Colaborador | Reduz os resultados ao conteúdo de colaboradores selecionados. |
| Data | Filtra por faixa de datas: Últimos 7 dias, Últimos 30 dias, Últimos 90 dias, ou um intervalo personalizado. |
| Categorias | Reduz os resultados a artigos ou páginas dentro de categorias selecionadas. |
Quando o Espaço de Trabalho Atual é selecionado, os resultados aparecem em abas individuais (Artigos, Categorias, Documentos da API) e em uma aba Tudo unificada, ordenadas por relevância. Todos os espaços de trabalho escaneiam todos os espaços de trabalho, incluindo documentação da API, e a aba Todos classifica os resultados por relevância entre eles.
Filtragem por tipo de conteúdo
A opção Filtrar à esquerda da barra de busca reduz os resultados por tipo de conteúdo:
- Títulos de categorias de pesquisa: Títulos de categorias e artigos contendo a palavra-chave de busca.
- Anexos de busca: Anexos de arquivo contendo a palavra-chave de pesquisa.
Anexos de busca
Quando um leitor pesquisa uma palavra-chave, os resultados aparecem em abas de filtro:
- Artigos (): Resultados dentro dos artigos.
- Árvores de decisão (): Resultados dentro dos guias da árvore de decisão.
- API Docs (): Resultados dentro da documentação da API.
- Categorias (): Resultados dentro das categorias.
- Arquivos (): Resultados dentro dos anexos PDF.
Se uma palavra-chave não devolver resultados de artigo, os leitores podem acessar a aba Arquivos para encontrar anexos PDF correspondentes e visualizá-los junto com o artigo. No portal da Knowledge Base, as contas da equipe podem usar isso para escanear arquivos PDF no Drive em busca de uma palavra-chave, mesmo que o nome do arquivo não coincida. Os resultados da busca por anexos mostram o caminho completo do breadcrumb, incluindo o nome do artigo, para que os leitores saibam a qual artigo pertence um anexo sem abrir o arquivo.
Sem comportamento de resultados de busca
Quando o feedback sem resultados de busca é ativado, o comportamento depende de como o leitor pesquisa:
- Após inserir um termo de busca, o leitor pressiona Enter ou clica no banner Enter para Perguntar à IA do Eddy .
- Se o leitor apertar Enter: Eddy AI tenta obter resultados relevantes. Se a entrada for uma palavra-chave, a Eddy AI faz uma pergunta de acompanhamento para confirmar a intenção. Se a entrada for uma consulta completa, a Eddy AI busca a resposta diretamente.
- Se o leitor clicar no banner Enter para Perguntar Eddy IA : o sistema trata a entrada como uma consulta completa. Se não houver resultados, o formulário de feedback sem resultados de busca aparece imediatamente, sem um prompt de acompanhamento.
Suporte ao operador de busca
Use operadores de busca para construir consultas mais precisas.
- Aspas duplas (
""): Procure por uma frase exata. Palavras dentro das aspas duplas devem coincidir exatamente nessa ordem. - Sinal menos (
-): Exclua uma palavra dos resultados. Coloque o sinal menos diretamente antes de uma palavra, sem espaço, para excluí-la.
| Consulta | Resultado |
|---|---|
search -recipe |
Registros contendo search, mas não recipe. |
search-recipe |
Registros contendo tanto search e recipe — sem exclusão, já que o sinal menos é no meio da palavra. |
-recipe |
Todos os registros, exceto aqueles que contêm recipe. |
-recipe pasta |
Registros contendo pasta, mas não recipe. |
"-recipe" |
Registros contendo a frase -recipe literal — nenhuma exclusão é realizada. |
Limites
| Limite | Valor | Notas |
|---|---|---|
| Tamanho do anexo PDF para indexação de busca | Até 10 MB | Arquivos maiores não são escaneados para correspondências de palavras-chave. |
A busca Document360 é alimentada pelo Algolia, que equilibra velocidade e relevância. O Algolia pode retornar uma contagem aproximada de resultados em vez de exaustiva para manter os tempos de resposta rápidos, então a contagem para a mesma consulta pode variar ocasionalmente. Esse é um comportamento esperado e não pode ser configurado pelo Document360.
Melhores práticas
- Ative Incluir todos os espaços de trabalho nas buscas do site se sua base de conhecimento abranger múltiplos espaços de trabalho, incluindo documentação da API, para que os leitores não precisem mudar manualmente o filtro.
- Ative a aba Mostrar anexos na busca se sua base de conhecimento depender de anexos PDF para referência que os leitores procuram diretamente.
- Use o formulário de feedback sem resultados de busca para capturar o que os leitores estavam procurando e, em seguida, revise as submissões em Analytics de Busca para fechar lacunas de conteúdo.
- Sintaxe do operador de busca de documentos (
""e-) para usuários avançados que precisam de consultas precisas e repetíveis.
FAQ
O que é busca avançada?
A busca avançada permite uma busca combinada em todos os espaços de trabalho e idiomas simultaneamente, ajudando os leitores a localizar resultados usando filtros disponíveis.
Como funciona a busca por Algolia na busca de respostas?
O Algolia primeiro procura artigos que contenham todas as palavras da consulta. Se não houver correspondências exatas encontradas, a busca se amplia para incluir artigos contendo qualquer um dos termos, classificando os resultados pelo número de correspondências de termos. Isso garante que os leitores ainda vejam conteúdo relevante mesmo quando nenhum artigo corresponde exatamente a todos os termos.
Como faço para esconder a barra de busca na página inicial?
A barra de busca da página inicial é visível por padrão e pode ser ocultada sem afetar a busca no restante do site da base de conhecimento. Navegue até {{variable. Configurações}} > {{variável. Base de conhecimento site}}, depois vá para Personalização do Site > Personalizar site. Selecione o menu suspenso Cabeçalho e Rodapé, escolha Casa, clique na seção Herói, selecione Pesquisar e depois clique no ícone Ocultar.
Como faço para excluir um artigo da busca?
Você pode excluir um artigo de buscas dentro da sua base de conhecimento ou em mecanismos de busca externos — veja Excluindo artigos de mecanismos de busca. Artigos ocultos não aparecem no site da Base de Conhecimento e não são pesquisáveis pelos leitores, embora os membros da equipe ainda possam encontrá-los no portal da Base de Conhecimento. Categorias e categorias de página podem ser ocultadas da mesma forma.
Minha busca incluirá resultados da documentação da API?
O filtro Workspace atual é selecionado por padrão. Para pesquisar entre sua documentação regular e a documentação da API juntos, selecione Todos os Espaços de Trabalho na opção Filtro na barra de busca.
Como a barra de busca se comporta com línguas RTL, como hebraico e árabe?
Selecionar uma linguagem RTL ajusta a barra de busca para alinhar o texto à direita e aceitar entrada da direita para a esquerda. Se vários idiomas forem selecionados e todos estiverem RTL, a barra de busca mantém a entrada e o alinhamento da direita para a esquerda. Se a seleção misturar linguagens RTL e LTR, o comportamento segue a linguagem padrão: a entrada começa pela direita se o padrão for RTL, ou pela esquerda se for LTR.
Posso localizar ou personalizar o texto da interface na busca avançada?
Sim, usando variáveis de localização. Navegue até {{variable. Configurações}} > {{variável. Portal da base de conhecimento}}, então {{variable. Localização n Espaços de Trabalho}}. Na aba Variáveis de Localização, expanda o acordeão de busca avançada para atualizar elementos como Vá para Busca Avançada, Espaço de Trabalho e Idioma, então clique em Salvar.
Por que a contagem de resultados de busca às vezes varia para a mesma consulta?
A busca Document360 é alimentada pelo Algolia, que pode retornar uma contagem aproximada de resultados em vez de exaustiva para manter os tempos de resposta rápidos. Esse é um comportamento esperado e não pode ser configurado pelo Document360.