连接到 Google Drive
Google Drive 这是一个基于云的文件存储和协作平台,用户可以通过任何设备实时存储、分享和共同编辑文档。 将 Google Drive 与 IBM watsonx Orchestrate 集成,可实现对文件和文件夹的无缝访问,从而支持自动化、数据交换和工作流编排。
要将 Google Drive 与 IBM watsonx Orchestrate 集成,您需要建立一条安全连接,以便两个系统能够无缝通信。
“单点登录(SSO)”开关仅对受支持的 OAuth 2.0 身份验证类型和应用程序启用。 如果应用程序不支持启用了单点登录(SSO)的身份验证类型,则该开关将保持禁用状态。 有关受支持的配置,请参阅 《为应用程序配置单点登录》。
连接步骤
请按照以下步骤将 Google Drive 连接到 watsonx Orchestrate :
在主菜单中,依次选择 “管理” > “安全”。
重要说明:在本地环境中,请通过“管理 > 连接 ”导航路径访问连接。
点击 “连接 ”选项卡,搜索相应的应用名称或 Google Drive 连接ID。
点击匹配连接ID旁边的编辑按钮。
选择贵组织使用的认证方法( OAuth、 2.0 或 Key Value Pair )。
请根据所选的身份验证方法,按照以下说明填写 Google Drive 专用的字段。
完成草稿和实时设置步骤。
保存并测试连接以确认连接成功。
认证方法
Google Drive watsonx Orchestrate 支持以下身份验证类型:
OAuth 2.0 (授权码) :推荐用于生产环境连接
键值对(KVP) :支持基于API密钥和传统场景
对于 2025 年 9 月之后创建的代理, OAuth 2.0 是 Google Drive 支持的唯一身份验证方式。
连接标识
在“连接”设置页面中查找您的 Google Drive 连接时,请使用以下连接ID。
认证类型 |
连接标识 |
|---|---|
OAuth2 授权码 |
|
键值对 |
|
OAuth 2.0 连接详情
如果您的组织使用基于 OAuth 的身份验证,请将身份验证类型设置为 OAuth2 授权码 ,并填写以下字段:
字段 |
描述 |
|---|---|
服务器 URL |
Google Drive 服务器的基域 URL (例如, https://www.googleapis.com ) |
标记URL |
用于将授权码兑换为访问令牌的接口(例如, https://oauth2.googleapis.com/token ) |
作用域 |
定义请求访问的内容 |
授权URL |
URL 用户将被重定向至该页面进行登录并授权访问(例如, https://accounts.google.com/o/oauth2/v2/auth ) |
客户端 ID |
应用程序的唯一 ID |
客户端秘密凭证 |
用于验证应用程序身份的密匙。 Google Drive |
在创建 Google 客户端ID和密钥之前,请确保您已具备以下条件:
- 已创建或选定一个 Google Cloud 项目。
- 为“ Google ”项目启用对您所用工具连接的特定 Google 服务的访问权限(例如, Google Drive )。 在您的项目中,打开 “API 和服务 ”,然后单击 “启用 API 和服务 ”以选择所需的 API。
配置 OAuth 凭据时,请务必添加正确的授权重定向 URI。 更多详细信息,请参阅回调 URL。
您可通过 Google Cloud 控制台获取这些值。 更多详情请参阅 Google 身份验证 API 文档。
键值对连接详情
如果您的组织使用 API 密钥或传统配置,请将身份验证类型设置为键值对 ,并通过添加新字段功能添加以下每个字段:
键 |
描述 |
|---|---|
|
Google Drive API 的基本 URL (例如 |
|
用于获取 OAuth 令牌的 URL (例如: |
|
Google Cloud 项目的客户 ID |
|
Google Cloud 项目的客户秘密 |
|
用于 API 请求的访问令牌 |
|
当承载令牌过期时,用于刷新承载令牌的令牌 |
注意 :使用键值对时,仅支持团队凭据。
您可通过 Google Cloud 控制台获取这些值。 更多详情请参阅 Google 身份验证 API 文档。
下一步操作
现在您的应用连接已生效,您可以在 watsonx Orchestrate 上开始使用它。
在 Orchestrate Chat 中运行一个代理,以便使用自然语言完成任务。 更多详情请参阅《 使用 Orchestrate Chat》。