# 将外部应用连接到您的代理

Source: https://support.kapsulehost.com/zh-cn/agents-connections

## 什么是连接

连接是您的一位专家与一个外部应用之间的签名链接。连接后，该专家可以在对话中使用该应用的工具：阅读文档、起草消息、查看记录。如果没有连接，专家将无法访问。

需要明确两点：

- 连接授予对**该应用**的访问权限，而不是对您的 KapsuleHost 账户的访问权限。这两个权限集从不混合。
- 任何**更改**连接应用中的内容的操作仍然会经过与在您的 KapsuleHost 账户上更改相同的确认卡。读取是即时的；写入需要先询问。

> **Note:** 连接位于**代理**，然后**管理连接**，或直接转到 `/agents/connections`。代理主页还显示一张连接卡，其中包含一些示例应用。

## 哪些专家可以使用哪些应用

名单刻意保守，每位专家只能看到其工作所需的应用。某些应用仅限于只读工具，即使该应用本身可以做更多：

| 专家 | 可以访问的外部应用 |
|---|---|
| Mara，业务顾问 | Stripe（仅读取） |
| Thea，创意写手 | Notion |
| Sef，SEO 顾问 | GitHub（仅读取） |
| Mila，市场营销规划师 | Gmail、Slack、Notion、Google Calendar |
| Iris，客户沟通 | Gmail、Slack |
| Ash，销售和拓展 | Gmail、Slack、Stripe（仅读取） |
| Pip，政策和文档 | 无 |

连接应用不会将其交给整个团队。它仅对上表中的专家可用。

![Kapsule Agents 中的连接目录](https://support.kapsulehost.com/help/screenshots/agents-connections.26935fcd.webp)

## 连接应用

1. 打开**代理**，然后打开**管理连接**。
2. 浏览**热门**标签页，切换到**全部应用**，或在搜索框中输入。每张卡显示应用名称和它公开的工具数量。
3. 点击您想要的应用上的**连接**。准备登录窗口时，按钮会更改为**正在打开...**。
4. 登录到应用本身并批准它要求的访问权限。
5. 您会返回到连接页面，显示**[应用] 已连接**确认。

连接后，卡显示**已连接** pill、您登录的账户标签，以及上次使用连接的时间或**尚未使用**。

## 连接状态

| 状态 | 含义 | 应该怎么做 |
|---|---|---|
| 已连接 | 正在工作。您的专家可以使用它。 | 无需操作 |
| 待处理 | 已开始登录但从未完成。 | 点击**完成连接** |
| 需要重新连接 | 访问权限已过期或已在应用端被撤回。 | 点击**重新连接** |

**需要重新连接**状态是正常的，会随时间推移而出现：大多数应用会按计划使所授予的访问权限过期。重新连接会恢复它，不会丢失任何内容。

## 这如何保持安全

连接页面在三行中说明了安全模型，值得理解而不是浏览：

- **由认证合作伙伴处理。** 登录到应用由我们的认证集成合作伙伴处理，它持有该授权。您的应用密码永远不会接触 KapsuleHost。
- **行动前确认。** 代理在行动前征求意见。任何更改内容的操作都需要您的批准。
- **即时撤销。** 断开连接会立即切断访问，这里和应用端都会切断。

> **Warning:** 将连接视为您为某人剪裁的钥匙。连接您希望专家在其中工作的账户，而不是您拥有的每个账户。如果您不确定专家是否需要应用来完成您想象的工作，请不要连接：先询问，然后连接。

## 断开应用连接

1. 打开**代理**，然后打开**管理连接**。
2. 在连接的应用上点击**断开连接**。
3. 出现确认：*您的团队立即失去对 [应用] 的访问权限。它已经使用的任何内容仍保留在您的过去聊天中。*
4. 点击**断开连接**以确认。

访问立即结束。这**不会**做的是从您已有的对话中清除应用的内容：如果专家上周在聊天中引用了一份文档，该文本仍在聊天记录中。断开连接是关于未来的访问权限，而不是追溯性清除。

## 当连接在您的账户上不可用时

如果连接页面显示单个平静的卡，显示**连接功能尚未可用**，则尚未为您的账户启用连接外部应用。该卡明确说明没有连接任何内容，也没有任何内容有访问权限，这在该状态下完全属实。您的专家仍然可以工作；他们只是无法到达 KapsuleHost 之外。

代理的其余部分不受影响。聊天、[技能](https://support.kapsulehost.com/zh-cn/agents-skills)和账户读取都正常工作。

## 如果失败怎么办

**"未授予权限，因此未连接任何内容。"** 您在应用自己的批准屏幕上取消或拒绝了。没有创建任何内容。再次点击**连接**并批准访问。

**"连接现在不可用。请稍后重试。"** 集成服务无法到达。这是故意的故障关闭：与其显示一个半构建的列表，页面显示空白。等待一分钟并重新加载。

**"无法加载连接。"** 您的设置很安全。刷新页面。如果问题仍然存在，请[打开支持工单](https://support.kapsulehost.com/zh-cn/opening-a-support-ticket)。

**专家说它无法到达连接的应用。** 查看上面的表。不是每位专家都允许使用每个应用，为 Iris 连接的应用不会自动对 Mara 可用。

**连接停留在待处理状态。** 登录窗口在完成前被关闭。点击**完成连接**并完成它。

## 连接成本是多少

在对话中使用连接应用的计量方式与任何其他工作相同。专家对外部应用进行的每次调用都按连接调用权重收费，这是长篇文章成本的一小部分。对您的 KapsuleHost 账户的读取仍然是免费的。完整的权重设置在[代理积分如何运作](https://support.kapsulehost.com/zh-cn/agents-credits)中。

## 相关

- [Kapsule Agents概览](https://support.kapsulehost.com/zh-cn/agents-overview)
- [开始使用 Kapsule Agents](https://support.kapsulehost.com/zh-cn/agents-getting-started)
- [使用Agent Skills](https://support.kapsulehost.com/zh-cn/agents-skills)