快速入门
将外部应用连接到您的 Kapsule Agents
Connections let a Kapsule Agents expert work inside apps you already use, with your permission, and they are entirely separate from what an expert can do on your Kapsule account.
将外部应用连接到您的代理
连接允许 Kapsule Agents 专家在您已经使用的应用内工作，获得您的许可，它们与专家对您的 Kapsule 账户所做操作完全分离。
连接是什么
连接是您的一位专家与一个外部应用之间的已登录链接。连接后，该专家可以在对话中使用该应用的工具：阅读文档、起草消息、检查记录。没有连接的情况下，专家无法访问。
有两点值得精确说明：
- 连接授予对该应用的访问权限，而不是对您的 Kapsule 账户的访问权限。这两个权限集从不混合。
- 任何更改已连接应用中内容的操作仍会经过与对您的 Kapsule 账户进行更改相同的确认卡。读取是立即进行的；写入首先要求确认。
连接位于Agents，然后管理连接，或直接转到 /agents/connections。Agents 主页也显示一张连接卡，其中有一些示例应用。
哪些专家可以使用哪些应用
名单是故意保守的，每位专家只能看到其工作需要的应用。某些应用即使在应用本身可以做更多事情时也被限制为仅读取工具：
| 专家 | 可以访问的外部应用 |
|---|---|
| Mara，业务顾问 | Stripe（仅读取） |
| Thea，创意写手 | Notion |
| Sef，SEO 顾问 | GitHub（仅读取） |
| Mila，营销规划师 | Gmail、Slack、Notion、Google Calendar |
| Cora，客户通讯 | Gmail、Slack |
| Ash，销售和推广 | Gmail、Slack、Stripe（仅读取） |
| Pip，政策和文档 | 无 |
连接应用不会将其交给整个团队。它仅对上面行中的专家可用。
连接应用
- 打开Agents，然后管理连接。
- 浏览热门选项卡，切换到所有应用，或在搜索框中输入。每张卡显示应用名称和它公开的工具数量。
- 单击您想要的应用上的连接。在准备登录窗口时，按钮变为打开中...。
- 登录应用本身并批准其请求的访问。
- 您返回连接页面，显示**[应用]已连接**确认。
连接后，该卡显示已连接标签、您登录时使用的账户标签，以及上次使用连接的时间或尚未使用。
连接状态
| 状态 | 含义 | 操作 |
|---|---|---|
| 已连接 | 工作正常。您的专家可以使用它。 | 无 |
| 待处理 | 登录已开始但从未完成。 | 单击完成连接 |
| 需要重新连接 | 访问已过期或在应用端被撤回。 | 单击重新连接 |
需要重新连接状态随着时间推移是正常的：大多数应用会按计划让它们授予的访问过期。重新连接会恢复它而不会丢失任何内容。
这如何保持安全
连接页面用三行陈述安全模型，值得理解而不是仓促浏览：
- **由认证伙伴处理。**登录应用由我们的认证集成伙伴处理，该伙伴持有授权。您的应用密码永远不会接触 Kapsule。
- **行动前确认。**代理在行动前请求确认。任何更改某些内容的操作都需要您的同意。
- **即时撤销。**断开连接会立即切断访问权限，包括此处和应用端。
将连接视为您为某人切割的钥匙。连接您希望专家在其中工作的账户，而不是您拥有的每个账户。如果您不确定专家是否需要应用来完成您心目中的工作，请不要连接它：先问，然后连接。
断开应用连接
- 打开Agents，然后管理连接。
- 单击已连接应用上的断开。
- 出现确认：您的团队立即失去对 [应用] 的访问权限。它已经使用的任何内容都保留在您之前的聊天中。
- 单击断开以确认。
访问权限立即结束。这不会做的是从您已进行的对话中清除应用内容：如果专家在上周向聊天引用了文档，该文本仍在聊天记录中。断开连接是关于未来访问，而不是追溯性删除。
当您的账户上无法使用连接时
如果连接页面显示单张卡片，内容为连接尚不可用，则为您的账户连接外部应用尚未启用。该卡明确说明没有任何内容已连接且没有任何内容有访问权限，这正是该状态下的真实情况。您的专家仍然工作；他们只是无法到达 Kapsule 外部。
Agents 的其余部分不受影响。聊天、Skills和账户读取都正常工作。
如果失败会发生什么
"未授予权限，因此未连接任何内容。" 您在应用自身的批准屏幕处取消或拒绝。未创建任何内容。再次单击连接并批准访问。
"连接暂时不可用。请稍后再试。" 集成服务无法访问。这是故意的故障关闭：不显示半构建的列表，该页面显示任何内容。等待一分钟并重新加载。
"无法加载连接。" 您的设置是安全的。刷新页面。如果问题持续，提交支持工单。
专家说无法到达已连接的应用。 检查上表。并非每位专家都被允许每个应用，为 Cora 连接的应用不会自动对 Mara 可用。
连接处于待处理状态。 登录窗口在完成前被关闭。单击完成连接并完成它。
连接的成本
在对话中使用已连接的应用的费用与任何其他工作一样计量。专家对外部应用进行的每次调用都以连接调用权重计费，这是长篇写作成本的一小部分。对您 Kapsule 账户的读取保持免费。完整的加权在 代理额度如何工作中。