Configurar a autenticação para o seletor de arquivos

Ao conversar com o assistente do Gemini Enterprise, os usuários podem anexar arquivos usando o seletor de arquivos. O assistente aceita três fontes de arquivos: arquivos locais, arquivos do Google Drive e arquivos do Microsoft OneDrive. Nesta página, descrevemos como os administradores configuram esse comportamento.

Se você quiser que os usuários finais selecionem arquivos do Google Drive e do OneDrive, controle como eles fazem login reutilizando a configuração do repositório de dados que você definiu ao configurar o repositório de dados do Google Drive e o repositório de dados do OneDrive. Isso permite que você controle o seguinte:

  • Qual app de login o seletor usa. Um seletor pode reutilizar o aplicativo do Microsoft Entra (antigo Azure AD) ou do Google que você configura no conector, em vez do aplicativo padrão gerenciado pelo Google.
  • Qual locatário do Microsoft Entra o seletor do OneDrive usa. O seletor do OneDrive pode fazer login de usuários no seu locatário específico do Microsoft Entra.

Para saber como os usuários finais podem anexar e conversar sobre arquivos, consulte Fazer upload e conversar sobre arquivos.

Como funcionam os seletores de arquivos

Se você configurou os repositórios de dados do Google Drive e do OneDrive para usar as mesmas configurações de autorização para o seletor de arquivos, ele vai usar as mesmas configurações para autenticar os usuários. A tabela a seguir resume os dois controles e os seletores que eles afetam.

Controle Efeitos Aplicável a
App de login personalizado Para autenticar os usuários quando eles anexarem arquivos ao assistente usando o seletor de arquivos, o Gemini Enterprise pode usar as configurações atuais do Microsoft Entra ID ou do Google Identity do seu repositório de dados em vez do aplicativo padrão gerenciado pelo Google. Google Drive e OneDrive
Aplicação de locatário O seletor do OneDrive exige que os usuários façam login no seu locatário específico do Microsoft Entra (https://login.microsoftonline.com/{your-tenant}/...) em vez do endpoint de login compartilhado (/common/), para que os usuários de outros locatários não possam se autenticar. O locatário é lido no conector do OneDrive anexado. Somente OneDrive

Os administradores anexam conectores a um app para configurar esse comportamento.

Quando você designa um provedor de configuração, as seguintes regras se aplicam:

  • Um provedor por tipo de conector. Só é possível anexar um provedor de configuração do OneDrive e um do Google Drive a um app por vez. A marcação de um segundo conector do mesmo tipo que um provedor é rejeitada com um erro de argumento inválido.
  • O provedor precisa ser um conector com ações ativadas. O provedor de configuração precisa ser um conector do OneDrive ou do Google Drive que ofereça suporte a ações ou acesso federado. Um conector somente de ingestão não pode ser um provedor de configuração. Para mais informações, consulte Gerenciar ações.

Antes de começar

Confirme o seguinte antes de configurar os seletores de arquivos:

  • Acesso de administrador. Conceda o papel de editor do Discovery Engine (roles/discoveryengine.editor). Esse papel é necessário para que o usuário crie o repositório de dados. Para conceder esse papel:
    1. No console Google Cloud , acesse a página IAM.

      Acessar IAM

    2. Localize a conta de usuário e clique em editar Editar.
    3. Conceda a função Discovery Engine Editor ao usuário. Para mais informações, consulte Papéis e permissões do IAM.
  • App de login personalizado do OneDrive: verifique se você tem um aplicativo do Microsoft Entra ID que você controla, incluindo o ID do cliente, a chave secreta do cliente e o ID do locatário, além de uma conta do OneDrive nesse locatário para testes. Para mais informações, consulte Registrar um aplicativo com a plataforma de identidade da Microsoft.
  • Repositório de dados configurado. Configure um repositório de dados do OneDrive ou do Google Drive. Ao configurar o repositório de dados, você define as configurações de autenticação, que incluem o ID do cliente, a chave secreta do cliente e o ID do locatário para o repositório de dados do OneDrive. Para mais informações, consulte:
  • Repositório de dados anexado. Anexe o repositório de dados do OneDrive ou do Google Drive ao app do Gemini Enterprise. Para mais informações, consulte Conectar um repositório de dados a um app.

Usar seu próprio app de login

Por padrão, o seletor usa o aplicativo gerenciado pelo Google para fazer login. É possível fazer com que o seletor use seu próprio Microsoft Entra ID ou Google Identity designando um conector como o provedor de configuração do seletor.

Se você já tiver um repositório de dados do OneDrive ou do Google Drive configurado, siga estas etapas:

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

    Gemini Enterprise

  2. Selecionar ou criar um projeto Google Cloud

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

  4. Pesquise seu repositório de dados e clique no nome dele.

  5. Clique em Ver/editar parâmetros.

  6. Selecione a opção Provedor de configuração do seletor.

  7. Clique em Salvar.

Reverter as mudanças para usar o aplicativo gerenciado pelo Google

Para voltar a usar o aplicativo padrão gerenciado pelo Google para autenticação do seletor de arquivos, siga estas etapas:

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

    Gemini Enterprise

  2. Selecionar o projeto Google Cloud .

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

  4. Clique no nome do seu repositório de dados.

  5. Clique em Ver/editar parâmetros.

  6. Limpe o campo Provedor de configuração do seletor.

  7. Clique em Salvar.

Experiência do usuário final

Depois de configurar os seletores, os usuários finais terão a seguinte experiência:

  • No OneDrive, os usuários precisam fazer login no locatário da Microsoft da sua organização. Contas de outros locatários são recusadas.
  • O login usa o aplicativo que você configurou: o aplicativo gerenciado pelo Google por padrão ou seu próprio aplicativo, se você definir um provedor de configuração.
  • Após o primeiro login, a conexão é lembrada para as próximas seleções de arquivos.

Para mais informações sobre a experiência do usuário final, consulte Fazer upload e conversar sobre arquivos.

Solução de problemas

Sintoma Causa provável Resolução
A marcação de um conector como um **provedor de configuração do seletor** falha com Cannot enable picker_config_provider on data connector '...' because another connector in the same engine is already the picker config provider: '...'. An engine can have at most one picker_config_provider connector; disable it on the other connector first. Outro conector no mesmo mecanismo já é o provedor de configuração do seletor. Um mecanismo pode ter no máximo um. Limpe o parâmetro **Provedor de configuração do seletor** no outro conector e tente novamente.
Falha no login do OneDrive com AADSTS50020: User account 'user@domain.com' from identity provider '...' does not exist in tenant '...' A conta do usuário está em um locatário do Microsoft Entra diferente do locatário configurado no conector. O endpoint de login específico do locatário rejeita a conta. A aplicação de locatário funciona conforme o esperado. Peça para o usuário fazer login com uma conta no locatário configurado ou atualize o ID do locatário do conector.
O OneDrive ainda solicita o endpoint de login compartilhado. O locatário ainda não foi configurado ou a mudança não foi propagada. Confirme o ID do locatário do conector. As mudanças na configuração podem levar até cerca de 3 minutos para entrar em vigor. Aguarde e tente novamente.

A seguir