连接到 Dropbox

在线编辑

Dropbox 这是一个基于云的文件存储和协作平台，允许用户在不同设备间安全地存储、共享和访问文件。 将 Dropbox 与 IBM watsonx Orchestrate 集成，可实现自动化的文件管理、同步以及工作流集成。

要将 Dropbox 与 IBM watsonx Orchestrate 集成，您需要建立一条安全的连接，以确保两个系统能够无缝通信。 有关管理集成的通用指南，请参阅 “连接预构建代理的应用程序 ”。

重要说明：

默认情况下，您的应用已禁用单点登录（SSO）。 要启用此功能，请参阅 《配置应用程序的单点登录 》。

连接步骤

请按照以下步骤将 Dropbox 连接到 watsonx Orchestrate ：

  1. 前往 “管理” > “连接 ”，然后搜索对应的 Dropbox 连接ID。

  2. 点击匹配连接ID旁边的编辑按钮。

  3. 选择贵组织使用的认证方法（ OAuth、 2.0 或键值对 ）。

  4. 根据所选的身份验证方法，填写 Dropbox 专用的字段。 有关常规连接工作流，请参阅 “连接应用程序以获取预构建代理 ”页面。

  5. 完成草稿和实时设置步骤。

  6. 保存并测试连接以确认连接成功。

支持的身份验证方法

Dropbox watsonx Orchestrate 支持以下身份验证类型：

  1. OAuth 2.0 (授权码) ：推荐用于生产环境连接

  2. 键值对（KVP） ：支持基于API密钥和传统场景

注：

对于 2025 年 9 月之后创建的代理， OAuth 2.0 是 Dropbox 支持的唯一身份验证方式。

连接标识

在“连接”设置页面中查找您的 Dropbox 连接时，请使用以下连接ID： 要了解如何搜索连接 ID 并打开连接进行编辑，请参阅《 连接应用程序以使用预构建代理》。

认证类型

连接标识

OAuth2 授权码

dropbox_ibm_184bdbd3

键值对

dropbox_key_value_ibm_184bdbd3（不推荐）

OAuth 2.0 连接详情

如果您的组织使用基于 OAuth 的身份验证，请将身份验证类型设置为 OAuth2 授权码 ，并填写以下字段：

字段

描述

Server URL

Dropbox 服务器的基本 URL

Token URL

将授权码换成访问令牌的端点

Scope

定义请求访问的内容

Authorization URL

URL 用户将被转到该处登录并授权访问

Client ID

应用程序的唯一 ID

Client Secret

用于验证应用程序身份的密匙。 Dropbox

您可以从 Dropbox App Console 获取这些值。 详情请参考 Dropbox API 文档。

键值对连接详情

如果您的组织使用 API 密钥或传统配置，请将身份验证类型设置为键值对 ，并通过添加新字段功能添加以下每个字段：

键

描述

base_url

Dropbox API 的基本 URL （例如 https://api.dropboxapi.com)

token_url

用于获取 OAuth 令牌的 URL （例如： https://api.dropbox.com/oauth2/token）

client_id

Dropbox 应用程序的客户端 ID

client_secret

Dropbox 应用程序的客户秘密

bearer_token

用于验证 API 请求的访问令牌

refresh_token

当承载令牌过期时，用于刷新承载令牌的令牌

注意 ：使用键值对时，仅支持团队凭据。

您可以从 Dropbox App Console 获取这些值。 详情请参考 Dropbox API 文档。

下一步操作

现在您的应用连接已生效，您可以在 watsonx Orchestrate 中开始使用它。

  • 在 Orchestrate Chat 中运行一个代理，以便使用自然语言完成任务。

  • 使用相关工具执行应用程序特有的操作。