Associe o Microsoft OneDrive com a federação de dados

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

Use o procedimento seguinte para pesquisar na sua conta do Microsoft OneDrive 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 iniciar a configuração federada do Microsoft OneDrive

Execute os seguintes passos antes de estabelecer ligação ao seu repositório de dados do Microsoft OneDrive através da pesquisa federada.

  1. Registe o Gemini Enterprise como uma aplicação OAuth 2.0 no Microsoft Entra ID e recolha as seguintes informações:

    • ID do cliente
    • Segredo do cliente
    • URL da instância: o URL do OneDrive da sua organização. Por exemplo, https://example-my.sharepoint.com.
    • ID do inquilino

  2. Configure as seguintes autorizações da aplicação Microsoft Graph com o consentimento de um administrador do Microsoft OneDrive:

    Autorização

    Tipo

    Descrição

    Files.Read.All

    Delegada

    Ler todos os ficheiros aos quais o utilizador pode aceder

    Sites.Read.All

    Delegada

    Ler itens em todas as coleções de sites

  3. Adicione os seguintes URLs como URLs de retorno Web:

    • https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html
    • https://vertexaisearch.cloud.google.com/oauth-redirect

Crie um conector de pesquisa federada com o OneDrive

Use os seguintes passos para que a Google Cloud consola execute uma pesquisa federada através do Microsoft OneDrive a partir do Gemini Enterprise.

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

    Gemini Enterprise

  2. No menu de navegação, clique em Armazenamentos de dados.

  3. Clique em Criar arquivo de dados.

  4. Na página Selecione uma origem de dados, selecione Pesquisa federada do OneDrive para associar a sua origem de dados de terceiros.

  5. Em Definições de autenticação, selecione o método de autenticação a usar.

    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.

  6. Selecione uma região para a sua origem de dados.

  7. Introduza um nome para a origem de dados.

  8. Clique em Criar. O Gemini Enterprise cria o seu repositório de dados e apresenta-o na página Repositórios 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. Quando o Estado do conector muda de A criar para Ativo, o conector de pesquisa federada está pronto a ser usado.

Autorização do utilizador

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

Para iniciar o fluxo de autorização:

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

  2. Inicie sessão na sua conta.

  3. Clique em Conceder acesso. Depois de conceder acesso, é feito o redirecionamento novamente para o Gemini Enterprise para concluir o fluxo de autorização. O Gemini Enterprise obtém o token de acesso e usa-o para aceder à pesquisa do Microsoft OneDrive.

Execução de consultas

Depois de autorizar o Microsoft OneDrive, quando introduz uma consulta de pesquisa:

  1. O Gemini Enterprise envia a sua consulta de pesquisa para a API Microsoft Graph.

  2. O Gemini Enterprise mistura os resultados com os de outras fontes e apresenta-os.

Tratamento de dados

Quando utiliza 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 termos de utilização e pelas políticas de privacidade desse sistema.

Códigos de erro

A tabela seguinte lista os códigos de erro e as descrições do OneDrive.

Código de erro Descrição
ONEDRIVE_MISSING_PERMISSION_1 A aplicação não tem a função necessária Files.Read.All para a API Graph.
ONEDRIVE_MISSING_PERMISSION_2 A aplicação não tem a função necessária Group.Read.All para a API Graph.
ONEDRIVE_MISSING_PERMISSION_3 A aplicação não tem as funções necessárias User.Read.All ou User.ReadBasic.All para a API Graph.
ONEDRIVE_INVALID_SITE_URI O URL da instância é inválido.
ONEDRIVE_INVALID_AUTH Ocorreu um erro ao obter o token de acesso da API Graph. Isto pode dever-se a um ID do cliente inválido, a um valor secreto inválido ou a credenciais federadas em falta.
ONEDRIVE_UNCATEGORIZED_ERROR Não existe ou existe uma ACL inválida no ficheiro.
ONEDRIVE_TOO_MANY_REQUESTS O OneDrive recebeu demasiados pedidos HTTP e devolveu uma resposta HTTP 429.

Passos seguintes