> ## Documentation Index
> Fetch the complete documentation index at: https://docs.driven.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 连接器

> 把 Driven Agent 连接到外部服务，控制工具权限，并在聊天中使用连接后的工具。

Connectors 让 Agent 可以使用外部服务提供的工具。Connector 可以带来券商功能、研究数据、效率工具，以及服务方提供的其他能力。

每个 Connector 只属于一个 Agent。如果另一个 Agent 也需要使用同一服务，请为它单独连接。

## 从 Explore 连接

1. 打开需要使用该 Connector 的 Agent。
2. 点击 **Connectors**，然后打开 **Explore**。
3. 选择一个 Connector，查看其作者、服务器 URL、说明和可用工具。
4. 点击 **Connect**。
5. 如果系统提示授权，请完成该服务的授权流程。

连接成功后，它会出现在 **My connectors** 中。

## 添加自定义 Connector

如果某个服务提供了兼容的服务器 URL，但它尚未列在 **Explore** 中，可以添加自定义 Connector。

1. 打开 **Connectors**，点击 **Add connector**。
2. 输入名称和 Connector 开发者提供的 **Server URL**。
3. 如果开发者要求使用你自己的 OAuth 应用，请展开 **Advanced settings**，输入 client ID 和可选的 client secret。否则请留空。
4. 点击 **Add**。如果 Driven 打开授权页面，请完成授权。

<Warning>
  只连接你信任的开发者提供的服务器。Connector 开发者可以决定服务器暴露哪些工具，也可能随时改变这些工具。使用前请检查 Connector URL、申请的访问权限和可用工具。
</Warning>

## 选择权限模式

打开已连接 Connector 的详情页，可以修改 **Permissions**。新建 Connector 默认使用 **Allow read-only actions**。

| 模式                          | 行为                                 |
| --------------------------- | ---------------------------------- |
| **Allow read-only actions** | Driven 可以运行被识别为只读的工具；其他操作需要你的批准。   |
| **Allow all actions**       | Driven 可以运行该 Connector 的工具，无需每次询问。 |
| **Ask every time**          | Driven 在每次调用 Connector 工具前都会请求批准。  |

只读分类依赖 Connector 服务器提供的标签和工具名称规则。它是一层保护措施，不是绝对保证。请仔细检查批准请求，尤其是工具可能执行交易、发送消息、修改记录或披露数据时。

## 在聊天中使用 Connector

你可以通过四种方式使用 Connector：

* 直接用自然语言描述需求，Agent 会根据任务自动选择合适的已连接 Connector。
* 点击聊天输入框中的 **Connectors** 图标，选择已连接的服务。
* 输入 `/`，然后从 **Connectors** 分区选择一个 Connector。
* 打开已连接 Connector 的详情页，点击 **Try now**。

选中的 Connector 会以标签形式出现在输入框中。正常输入需求并发送即可。Agent 随后可以为该请求使用这个 Connector 的工具。如果某项操作需要批准，请检查拟执行的操作，再决定批准或拒绝。

## 管理 Connector

打开 **My connectors**，可以管理当前 Agent 的全部 Connector。

* 关闭开关可以暂停 Connector，但不会移除已保存的连接。
* 重新打开开关即可恢复使用。
* 如果授权过期或失败，请点击 **Re-authorize**。
* 打开详情页可以检查当前服务器 URL、工具列表和权限模式。
* 从 `...` 菜单选择 **Disconnect**，会立即移除 Connector 及其保存的凭证。

Connector 配置不支持直接编辑。如果需要修改服务器 URL 或 OAuth client 凭证，请先断开连接，再重新添加。

## 故障排查

* **看不到 Connectors 或功能被禁用：** 你的账户可能尚未开通该功能。
* **授权没有完成：** 打开 **My connectors**，点击 **Authorize** 或 **Re-authorize**。
* **没有显示工具：** 打开 Connector 详情页。服务器当前可能没有暴露工具，或需要重试连接。
* **Connector 停止工作：** 检查服务器 URL 是否仍然有效；如果系统提示，请重新授权；同时确认外部服务是否可用。

## 相关内容

* [Agent](/zh/concepts/agents) —— 每个 Agent 都需要单独配置 Connector
* [Skills](/zh/concepts/skills) —— 可以使用现有工具的可复用工作流
* [数据源](/zh/reference/data-sources) —— 无需 Connector 即可使用的内置金融数据