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:- No console Google Cloud , acesse a página IAM.
- Localize a conta de usuário e clique em editar Editar.
- Conceda a função
Discovery Engine Editorao 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:
No console Google Cloud , acesse a página Gemini Enterprise.
Selecionar ou criar um projeto Google Cloud
No menu de navegação, selecione Repositório de dados.
Pesquise seu repositório de dados e clique no nome dele.
Clique em Ver/editar parâmetros.
Selecione a opção Provedor de configuração do seletor.
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:
No console Google Cloud , acesse a página Gemini Enterprise.
Selecionar o projeto Google Cloud .
No menu de navegação, selecione Repositório de dados.
Clique no nome do seu repositório de dados.
Clique em Ver/editar parâmetros.
Limpe o campo Provedor de configuração do seletor.
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
- Configure o conector do Microsoft OneDrive.
- Configure o conector do Google Drive.
- Saiba mais sobre a experiência do usuário final em Fazer upload e conversar sobre arquivos.