Conectar o Microsoft OneDrive à federação de dados

Nesta página, descrevemos como conectar o Microsoft OneDrive ao Gemini Enterprise usando a federação de dados.

Use o procedimento a seguir para pesquisar sua conta do Microsoft OneDrive usando a pesquisa federada.

Sobre a federação de dados

Com a federação de dados, o Gemini Enterprise recupera informações diretamente das fontes de dados de terceiros usando APIs, em vez de copiar os dados para o Gemini Enterprise. Com essa abordagem, é possível acessar fontes de dados externas imediatamente, sem esperar pela ingestão.

Antes de iniciar a configuração federada do Microsoft OneDrive

Siga estas etapas antes de se conectar ao seu repositório de dados do Microsoft OneDrive usando a pesquisa federada.

  1. Registre o Gemini Enterprise como um aplicativo OAuth 2.0 no Microsoft Entra ID e colete as seguintes informações:

    • ID do cliente
    • Chave secreta do cliente
    • URL da instância: o URL do OneDrive da sua organização. Por exemplo, https://example-my.sharepoint.com.
    • Código do locatário

  2. Configure as seguintes permissões de aplicativo do Microsoft Graph com o consentimento de um administrador do Microsoft OneDrive:

    Permissão

    Tipo

    Descrição

    Files.Read.All

    Delegado

    Ler todos os arquivos que o usuário pode acessar

    Sites.Read.All

    Delegado

    Ler itens em todas as coleções de sites

  3. Adicione os seguintes URLs como URLs de callback da Web:

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

Criar um conector de pesquisa federada com o OneDrive

Siga estas etapas para usar o Google Cloud console e fazer uma pesquisa federada no Microsoft OneDrive pelo Gemini Enterprise.

  1. No console Google Cloud , acesse a página Gemini Enterprise.

    Gemini Enterprise

  2. No menu de navegação, selecione Repositório de dados.

  3. Clique em Criar armazenamento de dados.

  4. Na página Selecionar uma fonte de dados, escolha Pesquisa federada do OneDrive para conectar sua fonte de dados de terceiros.

  5. Em Configurações de autenticação, selecione o método de autenticação que será usado.

    1. Insira o ID do cliente, a chave secreta do cliente, o URL da instância e o ID do locatário.

    2. Clique em Autenticar.

    3. Clique em Continuar.

  6. Selecione uma região para sua fonte de dados.

  7. Em seguida, insira um nome.

  8. Clique em Criar. O Gemini Enterprise cria e exibe o repositório de dados na página Repositórios de dados.

Depois que o repositório de dados for criado, acesse a página Repositórios de dados e clique no nome dele para conferir o status. Quando o estado do conector mudar de Criação para Ativo, o conector de pesquisa federada estará pronto para uso.

Autorização do usuário

Depois de criar um repositório de dados de pesquisa federada, ele vai aparecer como uma das origens de dados no painel de gerenciamento de fontes. Se você não tiver autorizado o Gemini Enterprise antes, não será possível selecionar a fonte de dados. Em vez disso, um botão Autorizar aparece.

Para iniciar o fluxo de autorização:

  1. Clique em Autorizar. Você será redirecionado para o servidor de autorização do OneDrive.

  2. Faça login em sua conta.

  3. Clique em Conceder acesso. Depois de conceder acesso, o sistema redirecionará você de volta ao Gemini Enterprise para concluir o fluxo de autorização. O Gemini Enterprise recebe o token de acesso e o usa para acessar a pesquisa do Microsoft OneDrive.

Execução da consulta

Depois de autorizar o Microsoft OneDrive, quando você inserir uma consulta de pesquisa:

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

  2. O Gemini Enterprise combina os resultados com os de outras fontes e os mostra.

Processamento de dados

Ao usar a pesquisa federada de terceiros, sua string de consulta é enviada para o back-end de pesquisa de terceiros. Esses terceiros podem associar consultas à sua identidade. Se várias fontes de dados de pesquisa federada estiverem ativadas, a consulta poderá ser enviada a todas elas.

Depois que os dados chegam ao sistema de terceiros, eles são regidos pelos Termos de Serviço e pelas Políticas de Privacidade desse sistema.

Códigos de erro

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

Código do erro Descrição
ONEDRIVE_MISSING_PERMISSION_1 O aplicativo não tem a função Files.Read.All necessária para a API Graph.
ONEDRIVE_MISSING_PERMISSION_2 O aplicativo não tem a função Group.Read.All necessária para a API Graph.
ONEDRIVE_MISSING_PERMISSION_3 O aplicativo 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 recuperar o token de acesso da API Graph. Isso pode acontecer devido a um ID do cliente ou valor secreto inválido ou à falta de credenciais federadas.
ONEDRIVE_UNCATEGORIZED_ERROR ACL inválida ou ausente no arquivo.
ONEDRIVE_TOO_MANY_REQUESTS O OneDrive recebeu muitas solicitações HTTP e retornou uma resposta HTTP 429.

Próximas etapas