与 Gemini Enterprise 助理对话时,用户可以使用文件选择器附加文件。该助理支持三种文件来源:本地文件、Google 云端硬盘中的文件和 Microsoft OneDrive 中的文件。本页面介绍了管理员如何配置此行为。
如果您希望最终用户从 Google 云端硬盘和 OneDrive 中选择文件,则可以重复使用您在配置 Google 云端硬盘数据存储区和 OneDrive 数据存储区时设置的数据存储区配置,从而控制最终用户的登录方式。 这样,您就可以控制以下内容:
- 选择器使用哪个登录应用。选择器可以重复使用您在连接器上配置的 Microsoft Entra(以前称为 Azure AD)或 Google 应用,而不是默认的 Google 管理的应用。
- OneDrive 选择器使用哪个 Microsoft Entra 租户。OneDrive 选择器可以针对您的特定 Microsoft Entra 租户让用户登录。
如需了解附加文件和针对文件进行对话的最终用户体验,请参阅上传文件并针对文件进行对话。
文件选择器的运作方式
如果您将 Google 云端硬盘和 OneDrive 数据存储区配置为对文件选择器使用相同的授权配置,则文件选择器会使用相同的设置来对用户进行身份验证。下表总结了这两个控件及其影响的选择器。
| 控制 | 作用 | 适用对象 |
|---|---|---|
| 自定义登录应用 | 当用户使用文件选择器将文件附加到助理时,Gemini Enterprise 可以使用数据存储区现有的 Microsoft Entra ID 或 Google Identity 配置(而不是默认的 Google 管理的应用)来对用户进行身份验证。 | Google 云端硬盘和 OneDrive |
| 租户强制执行 | OneDrive 选择器要求用户登录到您的特定 Microsoft Entra 租户 (https://login.microsoftonline.com/{your-tenant}/...),而不是共享登录端点 (/common/),这样其他租户的用户就无法进行身份验证。系统会从附加的 OneDrive 连接器中读取租户。 |
仅限 OneDrive |
管理员可将连接器附加到应用,以配置此行为。
指定配置提供方时,需遵循以下规则:
- 每种连接器类型只能有一个提供方。您一次只能将一个 OneDrive 配置提供程序和一个 Google 云端硬盘配置提供程序附加到应用。如果将同一类型的第二个连接器标记为提供方,则会被拒绝,并显示参数无效错误。
- 提供方必须是支持操作的连接器。配置提供方必须是支持操作或联合访问的 OneDrive 或 Google 云端硬盘连接器。仅提取连接器不能是配置提供方。如需了解详情,请参阅管理操作。
准备工作
在配置文件选择器之前,请确认以下事项:
- 管理员访问权限。
授予 Discovery Engine Editor 角色 (
roles/discoveryengine.editor)。用户必须拥有此角色才能创建数据存储区。如需授予此角色,请执行以下操作: - 自定义 OneDrive 登录应用。确保您拥有一个由您控制的 Microsoft Entra ID 应用(包括其客户端 ID、客户端密钥和租户 ID),以及该租户中的一个 OneDrive 账号,以便进行测试。如需了解详情,请参阅向 Microsoft Identity Platform 注册应用。
- 已配置的数据存储区。配置 OneDrive 数据存储区或 Google 云端硬盘数据存储区。配置数据存储区时,您需要配置身份验证设置,包括 OneDrive 数据存储区的客户端 ID、客户端密钥和租户 ID。如需了解详情,请参阅:
- 附加的数据存储区。将 OneDrive 数据存储区或 Google 云端硬盘数据存储区关联到 Gemini Enterprise 应用。如需了解详情,请参阅将数据存储区关联到应用。
使用您自己的登录应用
默认情况下,选择器会使用 Google 管理的应用进行登录。您可以将一个连接器指定为选择器的配置提供方,从而让选择器改用您自己的 Microsoft Entra ID 或 Google Identity。
如果您已配置 OneDrive 或 Google 云端硬盘数据存储区,请按照以下步骤操作:
在 Google Cloud 控制台中,前往 Gemini Enterprise 页面。
选择或创建 Google Cloud 项目。
在导航菜单中,点击数据存储区。
搜索您的数据存储区,然后点击该数据存储区的名称。
点击查看/修改参数。
选择 Picker Config Provider 选项。
点击保存。
还原更改以使用 Google 管理的应用
如需恢复使用默认的 Google 管理的应用进行文件选择器身份验证,请按以下步骤操作:
在 Google Cloud 控制台中,前往 Gemini Enterprise 页面。
选择您的 Google Cloud 项目。
在导航菜单中,点击数据存储区。
点击您的数据存储区的名称。
点击查看/修改参数。
清除选择器配置提供程序字段。
点击保存。
最终用户体验
配置选择器后,最终用户将获得以下体验:
- 对于 OneDrive,系统会提示用户登录贵组织的 Microsoft 租户。来自其他租户的账号会被拒绝。
- 登录时会使用您配置的应用:默认情况下为 Google 管理的应用,如果您设置了配置提供方,则为您的应用。
- 首次成功登录后,系统会记住该连接,以便后续选择文件。
如需详细了解最终用户体验,请参阅上传文件并针对文件进行对话。
问题排查
| 症状 | 可能的原因 | 解决方法 |
|---|---|---|
将连接器标记为 **Picker Config Provider** 失败,并显示 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. |
同一引擎中的另一个连接器已是选择器配置提供方。一个引擎最多只能有一个。 | 清除另一个连接器上的 **Picker Config Provider** 参数,然后重试。 |
OneDrive 登录失败,错误代码为 AADSTS50020: User account
'user@domain.com' from identity provider '...' does not exist in tenant
'...' |
用户的账号位于与连接器上配置的租户不同的 Microsoft Entra 租户中。租户专用登录端点会拒绝该账号。 | 租户强制执行功能运行正常。让用户使用您配置的租户中的账号登录,或更新连接器的租户 ID。 |
| OneDrive 仍会提示共享登录端点。 | 租户尚未配置,或更改尚未传播。 | 确认连接器的租户 ID。配置更改最多可能需要大约 3 分钟才能生效;请稍等,然后重试。 |
后续步骤
- 设置 Microsoft OneDrive 连接器。
- 设置 Google 云端硬盘连接器。
- 如需了解最终用户体验,请参阅上传文件并针对文件进行对话。