Esta página foi traduzida pela API Cloud Translation.

Associe o Microsoft SharePoint Online com a federação de dados

Esta página descreve como associar o Microsoft SharePoint Online ao Gemini Enterprise através da federação de dados.

Use o procedimento seguinte para pesquisar na sua conta do SharePoint através da pesquisa federada.

Acerca da federação de dados

Com a federação de dados, o Gemini Enterprise obtém diretamente informações das origens de dados de terceiros através de APIs, em vez de copiar os dados para o Gemini Enterprise. Com esta abordagem, pode aceder imediatamente a origens de dados externas, sem esperar pela ingestão.

Antes de começar

Antes de poder criar o conector no Gemini Enterprise, tem de configurar um registo de aplicação do Entra para ativar o acesso seguro ao SharePoint.

Para registar o Gemini Enterprise como uma aplicação OAuth 2.0 no Entra, faça o seguinte:
1. Navegue para o centro de administração do Microsoft Entra.
2. No menu, expanda a secção Aplicações e selecione Registos de apps.
3. Na página Registos de apps, selecione Novo registo.
  
  Registe uma nova app no centro de administração do Microsoft Entra
4. Crie um registo de app na página Registar uma aplicação:
  
  Selecione o tipo de conta e introduza o URI de redirecionamento
5. Na secção Tipos de contas suportados, selecione Contas apenas no diretório organizacional.
6. Na secção URI de redirecionamento, selecione Web e introduza os seguintes URLs como URLs de callback da Web (ou URLs de redirecionamento):
  - https://vertexaisearch.cloud.google.com/console/oauth/sharepoint_oauth.html
  - https://vertexaisearch.cloud.google.com/oauth-redirect
7. Clique em Registar. A sua app vai ser criada.
Para obter o ID de cliente e o segredo da app, faça o seguinte:
1. Na página da app, selecione Certificados e segredos.
2. Clique em Novo segredo do cliente.
3. Introduza uma descrição para o segredo.
4. Selecione uma duração de validade. Recomendamos que selecione o valor predefinido.
5. Clique em Adicionar.
6. Copie o segredo apresentado na coluna Valor (Client Secret) e o identificador na coluna ID do segredo (Client ID) e armazene-os em segurança para utilização posterior.
Para configurar as autorizações da API necessárias para a app, faça o seguinte:
1. Na página da app, selecione Autorizações da API.
2. Clique em Adicionar autorizações.
3. Na página Pedir autorizações da API, selecione SharePoint.
4. Selecione Autorizações delegadas.
5. Pesquise e selecione as seguintes autorizações:
  - Sites.Search.All
  Para o acesso ao site, escolha qualquer uma das seguintes autorizações:
  - AllSites.Read: permite-lhe pesquisar todos os documentos aos quais tem acesso em qualquer site.
  - Sites.Selected: oferece-lhe mais controlo administrativo. Os administradores podem restringir os sites que o utilizador pode consultar, mas têm de conceder acesso a cada site individual que querem ativar. Para mais informações, consulte o artigo Conceder autorizações a uma coleção de sites específica.
6. Clique em Adicionar autorizações.

Crie um conector de pesquisa federada com o SharePoint

Consola

Siga os passos seguintes para usar a Google Cloud consola para realizar uma pesquisa federada através do SharePoint a partir do Gemini Enterprise.

Na Google Cloud consola, aceda à página Gemini Enterprise.

Gemini Enterprise
No menu de navegação, clique em Armazenamentos de dados.
Clique em Criar arquivo de dados.
Na página Selecionar uma origem de dados, desloque a página ou pesquise SharePoint Federated para associar a sua origem de terceiros.

Pesquise SharePoint federado
Em Definições de autenticação:
1. Introduza o ID de cliente, o segredo do cliente, o URL da instância e o ID do inquilino.
2. Clique em Autenticar.
3. Clique em Continuar.
  
  Introduza as informações de autenticação
Selecione os tipos de entidades que quer pesquisar.

Selecione os tipos de entidades
Selecione uma região para a sua origem de dados.
Introduza um nome para a origem de dados.

Configure o conetor de dados
Clique em Criar. O Gemini Enterprise cria o seu arquivo de dados e apresenta os seus arquivos de dados na página Arquivos de dados.

Depois de criar o arquivo de dados, aceda à página Arquivos de dados e clique no nome do arquivo de dados para ver o estado. Se o Estado do conetor mudar de A criar para Ativo, o conetor de pesquisa federada está pronto a ser usado.

Autorização do utilizador

Depois de criar um repositório de dados de pesquisa federada, pode vê-lo listado como uma das origens de dados no painel de gestão de origens. Se não autorizou anteriormente o Gemini Enterprise, não pode selecionar a origem de dados. Em alternativa, é apresentado um botão Autorizar junto ao mesmo.

Para iniciar o fluxo de autorização:

Clique em Autorizar. É feito o redirecionamento para o servidor de autorização do SharePoint.

Clique em Autorizar
Inicie sessão na sua conta.
Clique em Conceder acesso. Depois de conceder acesso, é feito o redirecionamento de volta para o Gemini Enterprise para concluir o fluxo de autorização. O Gemini Enterprise obtém o access_token e usa-o para aceder à pesquisa de terceiros.

Execução de consultas

Quando introduz uma consulta de pesquisa:

Se o SharePoint estiver autorizado, o Gemini Enterprise envia a consulta para a API SharePoint.
O Gemini Enterprise mistura os resultados com os de outras fontes e apresenta-os.

Tratamento de dados

Quando usa a pesquisa federada de terceiros, a sua string de consulta é enviada para o backend de pesquisa de terceiros. Estes terceiros podem associar consultas à sua identidade. Se estiverem ativadas várias origens de dados de pesquisa federada, a consulta pode ser enviada para todas elas.

Assim que os dados chegam ao sistema de terceiros, são regidos pelos respetivos termos de utilização e políticas de privacidade (e não pelos termos da Google Cloud).