Gerenciar verticais de pesquisa

As verticais de pesquisa são guias na página de resultados de pesquisa que mostram resultados de um tipo específico ou de fontes selecionadas. Por exemplo, a vertical Files mostra resultados classificados como arquivos e facilita para os usuários que desejam localizar documentos. Você pode personalizar verticais na Pesquisa da Microsoft para atender às necessidades de sua organização ou departamentos individuais. A Pesquisa da Microsoft tem dois tipos de verticais: prontas para uso ou verticais padrão e personalizadas. As verticais padrão, como All, Files e People, criam acesso fácil aos resultados de pesquisa mais usados.

Você pode gerenciar verticais em dois níveis:

Nível da organização – uma vertical no nível da organização aparece na página de resultados da pesquisa quando os usuários pesquisam na página inicial do SharePoint e no Microsoft Office.
Nível do site – uma vertical no nível do site aparece na página de resultados da pesquisa quando os usuários pesquisam em um site do SharePoint. Por exemplo, talvez você queira permitir que seus funcionários de atendimento ao cliente pesquisem incidentes de Gravidade 1 diretamente no site do SharePoint do departamento.

Observação

Os usuários convidados para o SharePoint veem as mesmas modificações verticais e verticais personalizadas que os usuários nativos do locatário.

Verticais padrão

As verticais padrão estão presentes no nível da organização em experiências como SharePoint, Microsoft Office ou no nível do site do SharePoint na página de resultados de pesquisa de cada site.

Aqui está um resumo dos recursos de personalização em verticais prontas para uso.

Tipo de personalização	Nível da organização	Nível do site
Renomear verticalmente	Sim	Sim
Desabilitar vertical	Parcial	Sim
Adicionar uma consulta	Parcial	Sim

Verticais personalizados

Você pode adicionar verticais de pesquisa na experiência de pesquisa em uma organização ou nível de site e pesquisar conteúdo dos conectores do Microsoft 365 Copilot ou do SharePoint. As verticais personalizadas para conteúdo do SharePoint mostram resultados do respectivo escopo, semelhantes às outras verticais nesse escopo. Por exemplo, uma vertical personalizada no escopo da organização mostra todos os resultados, enquanto uma vertical personalizada com conteúdo do SharePoint no site de Marketing mostra dados desse site. O mesmo ocorre para sites de hub em que o mesmo escopo de hub é aplicado.

Criar ou modificar verticais de pesquisa

A experiência de gerenciamento vertical é orientada por assistente, você é guiado por etapas para definir o nome da vertical, a fonte de conteúdo e o escopo do conteúdo a ser pesquisado. Você pode usar um conjunto limitado de linguagem QL por palavra-chave (KQL) para definir o escopo da pesquisa vertical para uma determinada fonte de conteúdo. Os filtros também podem ser adicionados a verticais prontas para uso e personalizadas no nível da organização e do site. Para obter mais informações sobre filtros, consulte Gerenciar filtros.

Gerenciar verticais em nível de organização

No Centro de administração do Microsoft 365, acesse a página Verticais na seção Personalização.
Selecione uma vertical existente e clique em editar ou clique em adicionar para criar uma nova vertical.
Depois de concluir as etapas de configuração, você pode revisar e salvar a vertical.

Gerenciar verticais no nível do site

No site do SharePoint em que você deseja gerenciar verticais, abra o painel de configurações clicando na engrenagem.
Selecione Informações do site e, em seguida, selecione Exibir todas as configurações do site. 
Procure a seção Pesquisa da Microsoft e selecione Definir configurações de pesquisa.
No painel de navegação, acesse Experiência personalizada e selecione Verticais.
Selecione uma vertical existente e clique em editar ou clique em adicionar para criar uma nova vertical.
Após a definição da configuração, você pode revisar e salvar a vertical.

Exibir a vertical na página de resultados da pesquisa

Um layout de resultados de pesquisa é necessário para que os resultados do conector do Microsoft Copilot sejam renderizados na página vertical de pesquisa. Para garantir que o layout de resultados apropriado esteja presente, você pode habilitar a pesquisa vertical. Depois de habilitar ou atualizar uma vertical, há um atraso de algumas horas antes que você possa exibir as alterações na página de pesquisa. Você pode acrescentar cacheClear=true à URL no SharePoint e no Office para exibir as alterações. A alteração pode levar até 30 minutos para ser exibida.

Observação

As verticais adicionadas não são visíveis no SharePoint e no Office quando visualizadas em navegadores da web móveis.

Opções de configuração avançadas

Várias conexões em uma vertical

Uma pesquisa vertical pode trazer resultados de várias fontes de conectores. Essa opção fornece flexibilidade no design da página de resultados da pesquisa. O processo de configuração vertical permite que os administradores selecionem várias conexões na etapa "Fonte de conteúdo".

Se você nomear com precisão o maior número possível de rótulos semânticos , essa experiência será aprimorada. Você adiciona rótulos semânticos no ponto de definição e ingestão do esquema. Veja mais sobre como criar e gerenciar rótulos semânticos. Aqui estão informações adicionais sobre como criar e gerenciar rótulos semânticos.

Observação

Uma conexão pode ser adicionada como uma fonte de conteúdo em uma única vertical. Você não pode usar conexões em várias verticais.

Para configurar uma consulta para uma vertical de pesquisa em que várias origens de conexão foram adicionadas, use propriedades de origem comuns para criar a consulta.

Idioma de consulta de palavra-chave (KQL)

Uma consulta pode ser adicionada a uma vertical para restringir os resultados mostrados na vertical de pesquisa usando a linguagem QL por palavra-chave (KQL) (suporte limitado). Esta página lista as propriedades disponíveis. Recomendamos que você use palavras-chave de texto livre e restrições de propriedade com operadores boolianos para criar o KQL. Operadores de classificação dinâmica como XRANK, operadores de proximidade e palavras não são suportados.

Aqui estão alguns exemplos de consultas.

Cenário	Consulta
Excluindo resultados de sites de arquivamento	NÃO (caminho:http//contoso.sharepoint.com/arquivo OU caminho:http//contoso.sharepoint.com/CompanyArchive)
Excluindo resultados com base na propriedade do tipo de arquivo	NOT(FileType:htm)

Use variáveis na seção de consulta KQL de uma vertical para fornecer dados dinâmicos como entrada para a consulta de uma vertical. "Profile" e "query string" são os tipos de variáveis de consulta que podem ser usadas.

Variáveis de consulta de perfil

Você pode usar variáveis de consulta de perfil para contextualizar os resultados da pesquisa para o usuário conectado. As variáveis de consulta de perfil buscam valores do perfil do usuário conectado. Por exemplo, para criar uma vertical "Tíquetes" para o usuário encontrar tíquetes de suporte atribuídos a ele, você pode especificar a seguinte consulta na seção "Consulta" durante a criação vertical na página de administração.

AssignedTo:{Profile.accounts.userPrincipalName}

Isso cortará os resultados da pesquisa para mostrar apenas os itens atribuídos à pessoa que está fazendo a pesquisa.

O recurso de perfil expõe propriedades como coleções. Por exemplo, as informações relacionadas a endereços de email são expostas por meio da coleta de emails, posições de trabalho como coleta de posições e assim por diante. Todas as propriedades disponíveis no perfil de usuário são expostas como variáveis de consulta.

Considere um usuário que tem três endereços de email disponíveis na coleção de emails, conforme mostrado aqui:

"emails": [{ 

        "address": "Megan.Bowen@contoso.com",
        "id": "xyz", 
        "source": { 
            "CreatedBy": "xyz", 
            "CreatedOn": "2222", 
            "Type": "official" 
        },
        "type": "main" 
    }, { 
        "address": "meganb@hotmail.com",
        "id": "abc", 
        "source": { 
            "CreatedBy": "abc",
            "CreatedOn": "3333", 
            "Type": "non-official",
        },
        "type": "work"
    }, { 
        "address": "meganb@outlook.com",
        "id": "pqr", 
        "source": { 
            "CreatedBy": "pqr", 
            "CreatedOn": "4444", 
            "Type": "personal" 
        },
        "type": "personal" 
    } 
]

A consulta MyProperty: {Profile.emails.address} será resolvida como MyProperty: "Megan.Bowen@contoso.com".
Para resolver todos os valores do atributo de endereço, use a sintaxe de expansão de vários valores. A consulta {|MyProperty:{Profile.emails.address}} será resolvida como ((MyProperty:"Megan.Bowen@contoso.com") OR (MyProperty: "meganb@hotmail.com") OR (MyProperty:"meganb@outlook.com")).

Use o operador "|" para resolver variáveis de vários valores. Consulte a tabela a seguir para obter mais exemplos de expansão de perfil.

#	Sintaxe	Valor retornado
1	MyProperty:{Profile.emails.address}	"Megan.Bowen@contoso.com"
2	MyProperty:{Profile.emails}	{Profile.emails} Isso não será resolvido porque emails é um objeto.
3	{? MyProperty:{Profile.emails}}	Isso não será resolvido porque emails é um objeto. O erro "?" ignora variáveis de consulta que não são resolvidas. Essa variável será removida quando passada mais abaixo na pilha de consulta.
4	{\|MyProperty: {Profile.emails.source.Type}}	((MyProperty:"official") OU (MyProperty:"nonofficial") OR (MyProperty:"personal"))

Variáveis de cadeia de caracteres de consulta

As variáveis de cadeia de caracteres de consulta permitem que você personalize os resultados da pesquisa com base em como os usuários interagem com os sites do SharePoint. Isso é feito adicionando pares de chave-valor à URL de pesquisa. Por exemplo, suponha que você tenha um site do SharePoint que forneça informações sobre um projeto com uma Web Part simples que mostra tarefas em andamento. Clicar na web part "Em andamento" leva os usuários à vertical de pesquisa "Itens de trabalho", onde os resultados são refinados para mostrar apenas itens marcados como InProgress.

Isso pode ser feito especificando a seguinte consulta na seção "Consulta" durante a criação vertical na página de administração.

Status:{QueryString.state}

A URL na Web Part do botão do site do SharePoint precisa ser atualizada para transmitir o seguinte par chave-valor https://{seu-domínio}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress

A consulta status:{QueryString.state} será resolvida como status:InProgress.

Aqui estão mais exemplos de expansão de cadeia de caracteres de consulta.

#	Sintaxe da consulta	Sintaxe da URL	Valor retornado
1	MyProperty:{QueryString.state}	https://{seu-domínio}.sharepoint.com/sites/{site-name}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress	MyProperty:InProgress
2	MyProperty:{QueryString.state} OU MyProperty:{QueryString.priority}	https://{seu-domínio}.sharepoint.com/sites/{nome-do-site}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress&priority=1	MyProperty:InProgress OR MyProperty:1
3	{? MyProperty:{QueryString.state}}	https://{seu-domínio}.sharepoint.com/sites/{nome-do-site}/_layouts/15/search.aspx/{ID-vertical}? Estado=InProgress	O estado aqui não será resolvido porque QueryStrings diferencia maiúsculas de minúsculas. O erro "?" ignora variáveis de consulta que não são resolvidas. Essa variável será removida quando passada mais abaixo na pilha de consulta.
4	{\|MyProperty: {QueryString.state}}	https://{seu-domínio}.sharepoint.com/sites/{nome-do-site}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed	(MyProperty:InProgress) OR (MyProperty:Closed) O \| é usado para resolver variáveis de valor mútuo. Os valores das variáveis devem ser passados usando o separador de vírgula, conforme mostrado na sintaxe da URL.
5	{MyProperty: {QueryString.state}}	https://{seu-domínio}.sharepoint.com/sites/{nome-do-site}/_layouts/15/search.aspx/{vertical-ID}?state=InProgress,Closed	MyProperty:InProgress Aqui, apenas o primeiro valor de state é selecionado da URL, pois a sintaxe da consulta não o define como uma variável de vários valores.

Limitações

A localização de idioma não se aplica a nomes de verticais prontos para uso depois de modificados.
As verticais personalizadas não aparecem na exibição móvel da Pesquisa da Microsoft.
Não há suporte para a adição de consulta na vertical People.
Não há suporte para a reordenação vertical.
As variáveis de cadeia de caracteres de consulta só podem ser usadas em sites do SharePoint.

Solução de problemas

Aqui está uma lista de problemas comuns que você pode encontrar e ações para corrigi-los.

Problema	Ação
Vejo uma mensagem de erro "Algo deu errado" na vertical.	Os tipos vertical e de resultado são necessários para concluir a configuração. Certifique-se de que ambos estejam configurados para a fonte de conteúdo.
Não vejo nenhuma fonte de conteúdo na página vertical.	Verifique se você configurou conectores e indexou os dados.

Last updated on 2026-08-20

Gerenciar verticais de pesquisa

Verticais padrão

Verticais personalizados

Criar ou modificar verticais de pesquisa

Gerenciar verticais em nível de organização

Gerenciar verticais no nível do site

Exibir a vertical na página de resultados da pesquisa

Opções de configuração avançadas

Várias conexões em uma vertical

Idioma de consulta de palavra-chave (KQL)

Variáveis de consulta de perfil

Variáveis de cadeia de caracteres de consulta

Limitações

Solução de problemas

Recursos adicionais