本页面介绍了如何创建数据存储区并将 GitHub 关联到 Gemini Enterprise。
准备工作
在设置 GitHub 连接之前,请确保您已做好以下准备工作:
授予 Discovery Engine Editor 角色 (
roles/discoveryengine.editor)。用户必须拥有此角色才能创建数据存储区。如需授予此角色,请执行以下操作:登录您的 GitHub 账号并获取身份验证凭据。
创建一个 GitHub 应用以使用此连接器。如需了解详情,请参阅创建 GitHub 应用。
创建 GitHub 数据存储区
如需创建 GitHub 数据存储区,请执行以下步骤:
在 Google Cloud 控制台中,前往 Gemini Enterprise 页面。
选择或创建 Google Cloud 项目。
在导航菜单中,点击数据存储区。
点击加号图标 ,然后点击创建数据存储区 。
在来源 部分中,搜索 GitHub ,然后点击选择 。
在数据 部分中:
在身份验证设置 部分中,输入以下详细信息:
- 客户端 ID:应用的 OAuth 客户端 ID。
- 客户端密钥:应用的 OAuth 客户端密钥。
如需详细了解凭据,请参阅 GitHub 配置。
点击登录 ,然后完成 GitHub 登录和授权。
在高级选项 部分中,在所有者登录名 字段中输入组织名称。
点击继续 。
在要搜索的实体 部分中,选择所有必需的实体。
点击继续 。
在操作 部分中,对于选择要启用的 GitHub 操作 ,请从类别中选择操作以针对数据存储区启用这些操作。
如需管理操作列表,请参阅管理操作。
点击继续。
在配置部分中:
- 从多区域列表中,选择数据连接器的位置。
- 在数据连接器名称或 ID 字段中,为连接器输入名称。
- 如果您选择
us或eu作为位置,请配置加密设置:- 可选:如果您尚未配置单区域密钥,请点击前往设置页面进行配置。如需了解详情,请参阅为第三方连接器注册单区域密钥。
- 选择 Google管理的加密密钥或 Cloud KMS 密钥。
- 如果您选择的是 Cloud KMS 密钥:
- 在密钥管理类型列表中,选择适当的类型。
- 在 Cloud KMS 密钥列表中,选择相应密钥。
点击继续。
点击创建。Gemini Enterprise 会为您创建数据存储区,并在数据存储区页面上显示您的数据存储区。
在数据存储区 页面上,点击数据存储区名称以查看状态。在数据存储区状态从正在创建更改为活跃后,GitHub 连接器即可供使用。
数据处理和查询执行
本部分介绍了 Gemini Enterprise 如何管理您的查询,以及使用联合数据存储区所涉及的隐私权问题。
查询执行
在您授权 GitHub 并向 Gemini Enterprise 发送搜索查询后:
- Gemini Enterprise 会将您的搜索查询直接发送给 GitHub API。
- Gemini Enterprise 会将获得的结果与其他关联数据源的结果融合,然后显示全面的搜索结果。
数据处理
使用第三方联合搜索时,遵循以下数据处理规则:
- 查询字符串会发送到第三方搜索后端 (GitHub API)。
- 这些第三方可能会将查询与您的身份关联。
- 如果启用了多个联合搜索数据源,查询可能会发送到所有这些数据源。
- 数据到达第三方系统后,将受该系统的服务条款和隐私权政策的约束。
后续步骤
- 如需在设置应用后预览搜索结果以了解其显示方式,请参阅获取搜索结果。
- 如需为数据存储区启用提醒,请参阅为第三方数据存储区配置提醒。