Configurar conectores do Microsoft Graph no Centro de administração do Microsoft 365
Este artigo mostra o processo básico necessário para configurar conectores do Microsoft Graph no Centro de administração do Microsoft 365. O processo básico inclui as seguintes etapas:
- Adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365
- Dar um nome à conexão
- Definir as configurações de conexão
- Selecionar propriedades
- Gerenciar as permissões de pesquisa
- Atribuir os rótulos de propriedade
- Gerenciar esquema
- Atualizar as configurações
- Analisar a conexão
- Gerenciar resultados de conexão
- Personalizar a página de resultados da pesquisa
Este artigo também inclui as seguintes informações:
Observação
O processo de instalação é semelhante para todos os conectores do Microsoft Graph, mas não é exatamente o mesmo. Além de ler este artigo, leia as informações específicas do conector para sua fonte de dados.
Etapa 1: adicionar um conector do Microsoft Graph no Centro de administração do Microsoft 365
Conclua as etapas a seguir para configurar qualquer um dos conectores do Microsoft Graph (ou clique aqui para acessar diretamente o Catálogo do Conector):
Entre em sua conta de administrador no Centro de administração do Microsoft 365.
No painel de navegação, selecione Configurações e selecione Pesquisa & inteligência. Selecione a guia Fontes de dados.
Selecione +Adicionar e selecione a fonte de dados de sua escolha no menu de opções disponíveis.
Observação
Você pode adicionar no máximo 30(30) conexões do Microsoft Graph a cada locatário.
Etapa 2: nomear a conexão
Especifique estes atributos:
- Nome (necessário)
- ID de conexão (necessária)
- Descrição (opcional)
- Selecione marcar caixa (necessário)
A ID de conexão cria propriedades implícitas para o conector. Ele deve conter apenas caracteres alfanuméricos e ter no máximo 32 caracteres.
Para ajudar melhor a administração da conexão e ajudar o Copilot a aprimorar os resultados da conexão para o usuário, a descrição deve responder brevemente às seguintes perguntas:
- Que tipo de conteúdo essa conexão tem?
- Como os usuários se referem a essa fonte de conteúdo em suas respectivas organizações?
- Qual parte do fluxo de trabalho os usuários se referem a esse conteúdo no seu trabalho diário?
- Quais são algumas características do conteúdo?
Etapa 3: configurar as configurações de conexão
O processo para configurar as configurações de conexão varia de acordo com o tipo de fonte de dados. Para que o tipo de fonte de dados a ser adicionado ao locatário conclua esta etapa no processo de instalação, consulte as informações específicas do Conector.
Para saber mais sobre como se conectar a uma fonte de dados local, consulte Configurar o Microsoft Graph Connector Agent.
Etapa 4: selecionar propriedades
Você pode escolher as propriedades indexadas pelo Microsoft Pesquisa.
Observação
Para atualizar as propriedades rastreadas após a criação de uma conexão, consulte Gerenciar artigo de esquema de pesquisa .
Etapa 5: Gerenciar permissões de pesquisa
As ACLs (listas de controle de acesso) determinam quais usuários em sua organização podem acessar cada item.
Alguns conectores como Microsoft SQL e Azure Data Lake Storage Gen2 dão suporte nativo a ACLs Microsoft Entra ID.
Outros conectores como ServiceNow Knowledge, ServiceNow Catalog, Azure DevOps Work Items e Salesforce dão suporte à sincronização de usuários e grupos não Azure AD.
Selecionar todos permite que todos em sua organização vejam os resultados da pesquisa desta fonte de dados.
Etapa 6: Atribuir rótulos de propriedade
Você pode atribuir rótulos semânticos às suas propriedades de origem na página "Atribuir rótulos de propriedade". Os rótulos são marcas bem conhecidas fornecidas pela Microsoft que fornecem significado semântico. Eles permitem que a Microsoft integre seus dados do conector a experiências do Microsoft 365, como pesquisa aprimorada, cartões de pessoas, descoberta inteligente e muito mais.
A tabela a seguir lista os rótulos com suporte no momento e suas descrições.
| Rótulo | Descrição |
|---|---|
| title | O título do item que você deseja mostrar em pesquisa e outras experiências |
| url | A URL de destino do item no sistema de origem |
| Criado por | Nome da pessoa que criou o item |
| Última modificação por | Nome da pessoa que editou o item mais recentemente |
| Authors | Nome das pessoas que participaram/colaboraram no item |
| Hora da data criada | Hora em que o item foi criado |
| Última data modificada | Hora em que o item foi editado mais recentemente |
| Nome do arquivo | Nome do item de arquivo |
| Extensão do arquivo | Tipo de item de arquivo, como .pdf ou .word |
As propriedades nesta página são pré-selecionadas com base na fonte de dados, mas você pode alterar essa seleção se houver uma propriedade diferente que seja mais adequada para um rótulo específico.
O rótulo título é o rótulo mais importante. Recomendamos fortemente que você tenha uma propriedade atribuída a esse rótulo para que sua conexão participe da experiência do cluster de resultados.
Mapear incorretamente rótulos causa uma experiência de pesquisa deteriorada. Tudo bem que alguns rótulos não tenham uma propriedade atribuída a ela.
Etapa 7: Gerenciar esquema
Propriedade Content
Recomendamos que você selecione uma Propriedade de Conteúdo no menu suspenso de opções ou mantenha o padrão se um estiver presente. Essa propriedade é usada para indexação de texto completo de conteúdo, geração de snippet de página de resultados de pesquisa, participação do cluster de resultados , detecção de idioma, suporte a HTML/texto, classificação e relevância e formulação de consulta.
Se você selecionar uma propriedade de conteúdo, terá a opção de usar a propriedade gerada pelo sistema ResultSnippet ao criar seu tipo de resultado. Essa propriedade serve como um espaço reservado para os snippets dinâmicos gerados da propriedade de conteúdo no momento da consulta. Se você usar essa propriedade no tipo de resultado, os snippets serão gerados nos resultados da pesquisa.
Aliases para propriedades de origem
Você pode adicionar aliases às suas propriedades na coluna "Alias" na página "Gerenciar esquema". Os aliases são nomes amigáveis para suas propriedades. Elas são usadas em consultas e na criação de filtros. Eles também são usados para normalizar propriedades de origem de várias conexões, de modo que tenham o mesmo nome. Dessa forma, você pode criar um único filtro para uma vertical com várias conexões. Para obter mais informações, consulte Personalizar a página de resultados da pesquisa.
Pesquisa atributos de esquema
Você pode definir os atributos de esquema de pesquisa para controlar a funcionalidade de pesquisa de cada propriedade de origem. Um esquema de pesquisa ajuda a determinar quais resultados são exibidos na página de resultados da pesquisa e quais informações os usuários finais podem exibir e acessar.
Pesquisa atributos de esquema incluem opções para Consulta, Pesquisa, Recuperar e Refinar. A tabela a seguir lista cada um dos atributos que os conectores do Microsoft Graph dão suporte e explica suas funções.
| atributo de esquema Pesquisa | Função | Exemplo |
|---|---|---|
| BUSCA | Torna o conteúdo de texto de uma propriedade pesquisável. O conteúdo da propriedade está incluído no índice de texto completo. | Se a propriedade for título, uma consulta para Enterprise retornará respostas que contêm a palavra Enterprise em qualquer texto ou título. |
| CONSULTA | Pesquisa por consulta para obter uma correspondência para uma determinada propriedade. Em seguida, o nome da propriedade pode ser especificado na consulta de forma programática ou verbatim. | Se a propriedade Title puder ser consultada, a consulta Título: Empresa terá suporte. |
| RECUPERAR | Somente propriedades recuperáveis podem ser usadas no tipo de resultado e exibidas no resultado da pesquisa. | |
| REFINAR | A opção de refinamento pode ser usada como na página de resultados do Microsoft Pesquisa. | Os usuários da sua organização podem filtrar por URL na página de resultados da pesquisa se a propriedade de refinamento for marcada durante a instalação da conexão. |
Para todos os conectores, exceto o conector de compartilhamento de arquivos, os tipos personalizados devem ser definidos manualmente. Para ativar os recursos de pesquisa para cada campo, você precisa de um esquema de pesquisa mapeado para uma lista de propriedades. A configuração de conexão assistente seleciona automaticamente um esquema de pesquisa com base no conjunto de propriedades de origem escolhidas. Você pode modificar esse esquema selecionando as caixas de marcar para cada propriedade e atributo na página de esquema de pesquisa.
Restrições e recomendações para configurações de esquema de pesquisa
A propriedade de conteúdo é somente pesquisável. Depois de selecioná-la na lista suspensa, essa propriedade não poderá ser usada com as opções de recuperação ou consulta.
Problemas de desempenho significativos ocorrem quando os resultados da pesquisa são renderizados com a propriedade de conteúdo . Um exemplo é o campo Conteúdo de texto para um artigo da base de dados de conhecimento do ServiceNow .
Somente propriedades marcadas como renderização recuperável nos resultados da pesquisa e podem ser usadas para criar MRTs (tipos de resultado modernos).
Somente as propriedades da cadeia de caracteres podem ser marcadas como pesquisáveis.
Observação
Para atualizar o esquema após a criação de uma conexão, consulte Gerenciar artigo de esquema de pesquisa .
Etapa 8: Configurações de atualização
O intervalo de atualização determina com que frequência os dados são sincronizados entre a fonte de dados e a Microsoft Pesquisa. Cada tipo de fonte de dados tem um conjunto diferente de agendamentos de atualização ideais com base na frequência com que os dados são modificados e no tipo de modificações.
Há dois tipos de intervalos de atualização, atualização completa e atualização incremental, mas as atualizações incrementais não estão disponíveis para algumas fontes de dados.
Com uma atualização completa, o mecanismo de pesquisa processa e indexa os itens que foram alterados na fonte de conteúdo, independentemente dos rastreamentos anteriores. Uma atualização completa funciona melhor para essas situações:
- Detectando exclusões de dados.
- A atualização incremental encontrou erros e falhou.
- As ACLs foram modificadas.
- As regras de rastreamento foram modificadas.
- O esquema da conexão foi atualizado.
Com uma atualização incremental, o mecanismo de pesquisa pode processar e indexar apenas os itens que foram criados ou modificados desde o último rastreamento bem-sucedido. Como resultado, nem todos os dados na fonte de conteúdo são reindexados. As atualizações incrementais funcionam melhor para detectar conteúdo, metadados e outras atualizações.
Observação
Atualmente, os rastreamentos incrementais não dão suporte ao processamento de atualizações para permissões.
As atualizações incrementais são muito mais rápidas do que as atualizações completas porque itens inalterados não são processados. No entanto, se você optar por executar atualizações incrementais, ainda precisará executar atualizações completas periodicamente para manter a sincronização de dados correta entre a fonte de conteúdo e o índice de pesquisa.
Agendamento de rastreamento
Você pode configurar rastreamentos completos e incrementais com base nas opções de agendamento avançadas presentes na página Configurações de Atualização. Alguns conectores não dão suporte a rastreamentos incrementais e a opção de configurar rastreamentos incrementais não estará disponível para esses conectores. Para outros, o rastreamento incremental é um rastreamento opcional e habilitado por padrão. Um agendamento de rastreamento é selecionado por padrão para você com base no tipo de conector. Essa configuração padrão pode ser alterada durante a criação ou edição da conexão após a publicação de uma conexão do fluxo "Editar" de uma conexão. Você pode escolher entre esses campos:
- Recorrência: você pode optar por executar os rastreamentos todos os dias, semana, 2ª semana ou 4ª semana.
- Dia(s): essa opção é habilitada quando você escolhe executar rastreamentos somente em dias específicos da semana.
- Executar uma vez por dia marcar caixa permite que você escolha a hora de início do rastreamento em um dia. Se não estiver selecionado, os rastreamentos serão repetidos em um dia por padrão. Você pode escolher o intervalo de repetição na lista suspensa.
- Frequência: selecione essa opção se você quiser repetir rastreamentos em um dia após determinados intervalos de tempo. A menor frequência de repetição é de 15 minutos e a maior é de 12 horas.
- Hora de Início: selecione a hora em que você deseja que o rastreamento comece.
- Redefinição: isso redefinirá a agenda para o agendamento padrão do conector.
Aqui estão certos pontos a serem observados ao configurar o agendamento de rastreamento:
- Se você deixar qualquer um dos campos vazio ou não selecionado, os conectores do Graph escolherão a melhor hora para iniciar um rastreamento. Por exemplo, se você escolher uma Recorrência de rastreamento como "Dia" e não selecionar a hora de início, os conectores do Graph escolherão a hora com base no último rastreamento para iniciar o novo rastreamento. Se você não quiser especificar uma hora de início do rastreamento, é uma boa prática permitir que o conector decida quando iniciar o rastreamento.
- Mesmo que a hora de início seja mencionada, o início do rastreamento pode atrasar em uma hora. Isso pode ser devido a razões como o carregamento de rede etc.
- Se o rastreamento anterior ultrapassar a hora do próximo rastreamento, não interromperemos o rastreamento em andamento e enfileiraremos o próximo rastreamento. Depois que o rastreamento contínuo for concluído, executaremos o rastreamento na fila somente se ele for de um tipo diferente (completo/incremental) do que o rastreamento anterior. Por exemplo, se um rastreamento incremental ultrapassar o próximo rastreamento completo, não suspenderemos o rastreamento incremental e enfileiraremos o rastreamento completo. Após a conclusão do rastreamento incremental, uma vez que o rastreamento na fila é de tipo diferente (completo), iniciaremos o rastreamento completo imediatamente.
Estes são alguns dos cenários:
- Executar rastreamento incremental diariamente após cada 15 minutos
Aqui, a seleção da caixa de seleção "Executar uma vez por dia" permitirá que você escolha a "hora de início" para executar o rastreamento incremental apenas uma vez por dia, começando na hora especificada. No entanto, desmarcar ele permitirá que você escolha a frequência de repetições de rastreamento em um dia. Se quiser que seus dados sejam atualizados continuamente, você pode optar por executar rastreamentos incrementais com frequência em um dia. Mas se o número de itens na fonte de dados for grande e os rastreamentos tendem a ser mais longos ou se não forem necessárias atualizações frequentes para o conteúdo, você poderá escolher o rastreamento incremental a ser executado uma vez por dia.
- Executar rastreamento incremental toda semana na quarta- feira, sábado e domingo repetindo a cada 15 minutos e começando à 1:00 am
- Executar rastreamento completo todos os dias à 1:00 AM
- Executar rastreamento completo toda semana na sexta-feira às 20:00
Etapa 9: Revisar conexão
Você pode examinar toda a configuração e as configurações de edição conforme necessário antes de concluir a conexão. Certifique-se de ler as informações específicas do conector para sua fonte de dados se você ainda não tiver feito isso. Quando estiver pronto para concluir a conexão, selecione Publicar.
Distribuição em etapas
A distribuição em etapas é um recurso que permite que você introduza gradualmente conectores do Microsoft Graph a um grupo seleto de usuários em seu ambiente de produção. Selecione Publicar para usuários limitados para implantar o conector em um público-alvo limitado. Para obter mais informações, confira Distribuição em etapas para conectores do Microsoft Graph.
Etapa 10: Gerenciar resultados de conexão
Os resultados da conexão serão incluídos na vertical Todos por padrão após a publicação. Se você não quiser que os resultados da conexão estejam imediatamente disponíveis em Tudo depois que ele tiver sido publicado, você poderá optá-lo nesta etapa.
Etapa 11: Personalizar a página de resultados da pesquisa
Depois de publicar a conexão, talvez você queira personalizar a página de resultados da pesquisa com verticais e tipos de resultado. Para saber mais sobre como personalizar os resultados da pesquisa, examine como gerenciar verticais e tipos de resultado.
Etapa 12: confirmar se a configuração da conexão funcionou
Vá para a lista de suas conexões publicadas na guia Conectores no centro de administração. Para saber como fazer atualizações e exclusões, consulte Monitorar suas conexões.
Solução de problemas
Leia as informações específicas do conector para sua fonte de dados.
Observação
Atualmente, nem todos os artigos específicos do conector incluem recomendações de solução de problemas.
Limitações
Para saber mais sobre limitações que se aplicam a todas as fontes de dados, confira o artigo Visão geral dos conectores do Microsoft Graph .
Consulte as informações específicas do conector para sua fonte de dados para descobrir se outras limitações se aplicam a esse conector específico do Microsoft Graph.