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

# 集成

> 通过 OAuth 或 API 密钥将第三方服务连接到你的 Fetch Hive 工作区

# 集成

当你希望 Fetch Hive 代表你的工作区连接到外部服务时,使用 **Integrations**。根据提供商的不同,连接流程会通过 OAuth 重定向你、要求你粘贴 API 密钥,或者打开一个托管服务的连接流程。

## 概述

集成页面为每个可用提供商显示一张卡片。每张卡片提供 **Connect** 操作,以及在集成完成后可切换的启用或禁用状态。

当你选择 **Personal** 计费类型并需要连接提供商凭据时,也会使用 **Integrations**。

## 如何连接一个集成? <a href="#connect-integration" id="connect-integration" />

在侧边栏打开 **Tools**,然后点击 **Integrations**。

找到你想连接的提供商。

点击 **Connect**。

如果该提供商使用 OAuth,Fetch Hive 会将你重定向到该提供商的登录和授权流程。

如果该提供商使用直接密钥,Fetch Hive 会打开一个对话框,要求输入你的 API 密钥。

如果该提供商使用托管流程,请按照该提供商的具体提示进行操作。对于 Telegram,Fetch Hive 会打开 Fetch Hive Bot,你可以按 **Start** 并连接你的私人 Telegram 聊天。

完成 OAuth 流程、保存 API 密钥,或完成托管连接提示,以完成连接。

{/* Add screenshot: Connect integration modal for an API-key-based provider */}

## 如何更新已保存的集成密钥? <a href="#update-integration-key" id="update-integration-key" />

再次打开集成卡片并选择 **Connect**。

对于基于 API 密钥的集成,会再次打开同一对话框,你可以用新密钥替换已保存的密钥。

保存更新后的密钥,以便集成使用新凭据保持连接。

## 如何启用或禁用集成? <a href="#toggle-integration" id="toggle-integration" />

当你想控制已连接的集成是否为该工作区启用时,使用集成卡片上的开关。

打开开关以启用集成。

关闭开关以禁用集成,但不会移除卡片本身。

## 何时应使用集成? <a href="#when-to-use-integrations" id="when-to-use-integrations" />

每当 Fetch Hive 需要在工作区级别访问外部提供商时,都可以使用 **Integrations**。

这包括常规的工具连接,以及在[使用你自己的 API 密钥](./llm-providers)中描述的 **Personal** 计费类型流程所使用的提供商凭据。

## 连接外部应用(Airtable、Linear 及更多)

集成页面以统一的网格列出所有提供商 — 包括 AI 模型提供商(OpenAI、Anthropic 等),以及工作流和智能体工具(Slack、Airtable、Linear 等)。没有单独的分区。

### 连接一个应用

在任意应用卡片上点击 **Connect**。根据提供商的不同,Fetch Hive 会:

* 直接在卡片上显示 API 密钥输入字段。
* 将你重定向到该提供商的 OAuth 流程。完成流程后,浏览器会返回到集成页面,卡片会更新为 **Connected** 并显示你的账户标识。
* 打开一个托管连接流程,例如 Telegram 的 Fetch Hive Bot 流程。

### 重新连接已过期的连接

如果连接已过期(以琥珀色的 **Expired — Reconnect** 标记显示),点击 **Reconnect** 以刷新令牌。

### 断开一个应用

点击 **Disconnect** 以移除连接。任何依赖此连接的工作流步骤或智能体在建立新连接前都将失败。

另请参阅:[使用你自己的 API 密钥](./llm-providers)和 [API 密钥](./api-keys)