Partilhar via


Gerir o esquema de pesquisa (pré-visualização)

O esquema de pesquisa determina a forma como os seus conteúdos ingeridos através de um conector do Microsoft Graph são utilizados em várias experiências do Microsoft Graph. O esquema define a estrutura de como os conteúdos são recolhidos a partir de origens de dados, indexados, consultados e obtidos a partir do índice de pesquisa. Ao alterar o esquema de pesquisa, pode controlar o que os utilizadores podem procurar, como os utilizadores podem procurá-lo e como pode apresentar os resultados nos pontos finais da Microsoft Search.

O esquema de pesquisa contém propriedades pesquisadas, atributos de pesquisa, etiquetas semânticas e aliases. As secções seguintes definirão os vários constituintes das capacidades de gestão e esquema fornecidas.

Observação

Leia o artigo Configurar o conector do Microsoft Graph para compreender as instruções gerais de configuração dos conectores do Microsoft Graph. Os passos 6 e 7 definem o esquema ao configurar uma nova ligação.

Observação

Se quiser modificar o esquema de pesquisa do SharePoint Online, leia Gerir o esquema de pesquisa no SharePoint.

Propriedades rastreadas

Para construir o índice de pesquisa, você deve rastrear o conteúdo primeiro. Pode pesquisar várias origens de conteúdo, conforme listado na galeria de conectores. Os conteúdos e metadados dos itens que pesquisa são representados como propriedades pesquisadas (ou propriedades de origem).

Por exemplo, a tabela seguinte apresenta propriedades pesquisadas de exemplo para um conector de sistema de pedidos de trabalho.

Propriedade Tipo
ticketId Cadeia de caracteres
title Cadeia de caracteres
createdBy Cadeia de caracteres
assignedTo Cadeia de caracteres
lastEditedDate DateTime
lastEditedBy Cadeia de caracteres
workItemType Cadeia de caracteres
prioridade Int64
categorias StringCollection
status Cadeia de caracteres
url Cadeia de caracteres
resolvido Booliano

Observação

Procurar atributos

Propriedade content

Esta propriedade é utilizada para indexação de texto completo de conteúdo, geração de fragmentos de página de resultados de pesquisa, participação do cluster de resultados , deteção de idioma, suporte html/texto, classificação e relevância e formulação de consultas.

Se selecionar uma propriedade de conteúdo, terá a opção de utilizar a propriedade gerada pelo sistema ResultSnippet quando criar o tipo de resultado. Esta propriedade serve como um marcador de posição para os fragmentos dinâmicos que são gerados a partir da propriedade content no momento da consulta. Se utilizar esta propriedade no tipo de resultado, os fragmentos são gerados nos resultados da pesquisa.

Pesquisável

Se uma propriedade for pesquisável, o respetivo valor é adicionado ao índice de texto completo. Quando um usuário realiza uma pesquisa, retornamos resultados se houver uma ocorrência de pesquisa em um dos campos pesquisáveis ou seu conteúdo.

Diagrama que mostra uma pesquisa de

Uma pesquisa por "design" exibindo resultados de ocorrências contra a propriedade (title) e conteúdo.

Consultável

Se uma propriedade é consultável, você pode consultá-la usando a linguagem de consulta de conhecimento (KQL). KQL consiste em uma ou mais palavras-chave de texto livre (palavras ou frases) ou restrições de propriedade. O nome da propriedade deve ser incluído na consulta, sendo especificado diretamente na consulta ou incluído de maneira programática. Você pode usar a correspondência de prefixo com o operador de caractere curinga(*).

Observação

Não há suporte para correspondência de sufixo.

Diagrama que mostra uma pesquisa de

Uma pesquisa por "search ba*" exibindo resultados que correspondem a esse prefixo.

Diagrama que mostra uma pesquisa de

Uma pesquisa de "tags:design" a analisar os resultados em itens com "design" na tags propriedade.

Recuperável

Se uma propriedade for recuperável, seu valor poderá ser retornado nos resultados da pesquisa. Qualquer propriedade que pretenda adicionar ao modelo de apresentação ou ser devolvida da consulta e ser relevante nos resultados da pesquisa tem de ser recuperável. Marcar propriedades grandes ou demais como recuperáveis aumenta a latência da pesquisa. Tenha cuidado ao escolher as propriedades certas.

Diagrama que mostra um conjunto de propriedades recuperáveis compostas como resultado.

Como resultado, é composto um conjunto de propriedades recuperáveis (title e lastEditedBy).

Refinável

Observação

As propriedades do tipo de dados "int" não podem ser refinadas, mesmo que sejam marcadas como refináveis.

Se uma propriedade for refinável, um administrador pode configurá-la como um filtro personalizado na página de resultados do Microsoft Search. Uma refinable propriedade não pode ser searchable.

Diagrama que mostra os resultados refinados por etiquetas, uma propriedade refinável.

Refinar resultados por tags, uma propriedade refináveis.

Observação

Rótulos semânticos

Um rótulo semântico é uma marca conhecida publicada pela Microsoft que você pode adicionar em relação a uma propriedade em seu esquema. Adicionar um rótulo semântico ajuda vários produtos da Microsoft a entender a propriedade e fornecer uma experiência melhor.

Os rótulos semânticos fornecem uma abordagem independente de domínio para atribuir propriedades de diferentes domínios de conteúdo a um conjunto de classes conhecidas. Encontram aplicações em muitas experiências de conteúdo diferentes e fornecem suporte automatizado para tarefas como:

  • Integração de dados em experiências heterogêneas
  • Criar gráficos de conhecimentos comuns (por exemplo, Topics)
  • Modelos padrão para experiências do usuário

Os rótulos fornecem significado semântico e permitem que você integre seus dados de conector às experiências do Microsoft 365.

Rótulo Descrição
title O título do item que pretende que seja apresentado na pesquisa e noutras experiências.
url A URL de destino do item na fonte de dados.
createdBy O nome da pessoa que criou o item na fonte de dados.
lastModifiedBy O nome da pessoa que editou mais recentemente o item na fonte de dados.
autores Os nomes de todas as pessoas que participaram/colaboraram no item na fonte de dados.
createdDateTime A data e hora em que o item foi criado na fonte de dados.
lastModifiedDateTime A data e hora em que o item foi modificado pela última vez na fonte de dados.
fileName No caso de um ficheiro, o nome do ficheiro na origem de dados.
FileExtension No caso de um ficheiro, a extensão do ficheiro encontra-se na origem de dados.
iconUrl A URL de um ícone.

Por exemplo, a propriedade pesquisada lastEditedBy tem o mesmo significado que a etiqueta da Microsoft lastModifiedBy.

Importante

Todas as propriedades que você mapeia para rótulos devem ser recuperáveis.

O rótulo título é o rótulo mais importante. Certifique-se de atribuir uma propriedade a esse rótulo para permitir que sua conexão participe da experiência do cluster de resultados. O mapeamento incorreto de rótulos prejudica a experiência de pesquisa. Não há problema em alguns rótulos não terem uma propriedade atribuída a eles.

Observação

Aliases

Os aliases são nomes amigáveis para as propriedades que você atribuir. Eles são usados em consultas e seleções em filtros de propriedades refináveis.

Observação

Recursos de atualização de esquema

Esta secção inclui informações sobre as capacidades de atualização para o esquema de pesquisa dos conectores criados pela Microsoft.

Observação

Recomendamos que execute uma pesquisa completa após uma atualização para colocá-las no esquema mais recente. Sem uma pesquisa completa, o comportamento dos itens será inconsistente.

Gerenciar esquema

  1. Na Centro de administração do Microsoft 365, aceda à página Esquema na secção Personalização.
  2. Clique em Ver detalhes em Esquema de conectores do Microsoft Graph.
  3. Selecione a ligação para a qual pretende atualizar o esquema e clique em Personalizar esquema.
  4. Depois de fazer as alterações de esquema necessárias, clique em Publicar alterações de esquema para publicar o novo esquema.

Adicionar uma propriedade pesquisada

Pode adicionar uma propriedade ao esquema. Ao adicionar uma propriedade, você pode incluir todos os atributos de pesquisa necessários.

Captura de ecrã da opção para adicionar uma nova propriedade de origem

Adicione uma nova propriedade de origem a partir da lista de propriedades suportadas por conector.

Importante

Não é possível eliminar uma propriedade existente para uma ligação publicada. Para remover uma propriedade, tem de eliminar e recriar uma ligação.

Adicionar/remover um recurso de pesquisa

Pode adicionar ou remover atributos de pesquisa específicos a uma propriedade. Adicionar uma capacidade de pesquisa requer uma pesquisa completa.

Captura de ecrã da opção para atualizar as anotações de pesquisa

Atualizar as anotações de pesquisa para propriedades pesquisadas

Importante

  • Não é possível remover um atributo de pesquisa recuperável de uma propriedade.
  • Não pode adicionar ou remover um atributo de pesquisa refinável a uma propriedade.

Adicionar/remover um rótulo semântico

Pode adicionar ou atualizar o mapeamento de etiquetas semânticas das propriedades pesquisadas.

Captura de ecrã da opção para atualizar etiquetas semânticas

Atualizar etiquetas semânticas para propriedades pesquisadas

Adicionar/remover um alias

Você pode adicionar ou remover aliases e usá-los para suas consultas de pesquisa.

Captura de ecrã da opção para adicionar ou remover um alias

Adicionar ou remover um alias para propriedades pesquisadas