Usar o Microsoft Graph para ampliar a Pesquisa da Microsoft com dados personalizados

Este artigo descreve um padrão de integração comum do Microsoft Graph para um cenário de negócios que requer a adição de dados corporativos personalizados às experiências do Microsoft Search e do Microsoft 365 Copilot. Os dados personalizados são ingeridos no armazenamento não estruturado do Microsoft 365 e adicionados a vários índices de pesquisa.

Este cenário não interativo tem os seguintes requisitos:

• Um tipo de integração de dados, pois ele fornece apenas dados personalizados e não usa a funcionalidade do Microsoft 365 nos aplicativos do cliente.
• Um fluxo de dados de entrada entre o aplicativo e o Microsoft 365.
• Um alto volume de dados para indexação.
• Envio em lote e agendamento de dados para upload e ingestão, o que resulta em maior latência de dados.

A melhor opção para esse cenário é usar conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph). O diagrama a seguir mostra a arquitetura dessa solução.

Componentes da solução

A arquitetura dessa solução inclui os seguintes componentes:

• Serviço de Aplicativo do Azure, que permite criar e hospedar aplicativos Web, trabalhos agendados e APIs RESTful em sua linguagem de programação preferencial, sem precisar gerenciar a infraestrutura. Ele oferece dimensionamento automático e alta disponibilidade, dá suporte a Windows e Linux e permite implantações automatizadas do GitHub, Azure DevOps ou qualquer repositório Git.
• O Microsoft Entra ID, que é necessário para gerenciar a autenticação do Microsoft Graph e dá suporte a permissões delegadas e de aplicativo para habilitar o fluxo OAuth.
• APIs RESTful do Microsoft Graph, incluindo conectores, acessadas por meio de um único ponto de extremidade: https://graph.microsoft.com.
• Um aplicativo personalizado que implementa lógica personalizada.

Considerações

As considerações a seguir dão suporte ao uso desse padrão de integração:

• Disponibilidade: o aplicativo cliente envia dados periodicamente por meio de APIs do Microsoft Graph. O aplicativo cliente não interativo faz solicitações e carrega os dados em uma frequência controlada pelo ambiente do cliente e limitada pela limitação dos conectores do Copilot.

• Latência: o aplicativo cliente usa as APIs de conectores síncronos do Copilot e espera uma resposta, mas alguma latência pode ocorrer dependendo das condições da rede e da carga no serviço Microsoft Graph.

• Escalabilidade: o aplicativo cliente é limitado a 30 conexões com não mais de 50.000.000 de itens por locatário, portanto, a escalabilidade é limitada. Se o volume de dados for grande, o processamento síncrono poderá se tornar um desafio e um obstáculo.

• Complexidade da solução: essa solução pode usar conectores criados por ISVs (fornecedores independentes de software), mas se acessar SDKs do Microsoft Graph ou APIs do Microsoft Graph, precisará serializar dados personalizados no formato necessário para conectores. Isso proporciona flexibilidade, mas também aumenta a complexidade. Esta solução pode, portanto, variar de baixa a média complexidade.

Conteúdo relacionado

• Visão geral dos conectores do Copilot
• Treinamento: Crie seu primeiro aplicativo Microsoft Graph Data Connect