管理第三方账户连接与访问密钥

应用和自动化要调用外部服务时，用的是你的凭据。凭据属于个人，不属于某个应用或自动化，分两种：

• 连接：授权给 Teable 的第三方账号，比如 Slack、Airtable、Google Sheets。
• Secret：你自己保存的 API Key、访问令牌等字符串。

凭据统一在 设置 → 集成 中管理，再按需授权给某个应用或自动化。授权之后，凡是运行这个应用或自动化的人，用的都是授权者的那份凭据；凭据的值不会展示给任何人，自动化测试结果里也会被遮蔽。

​

管理你的连接和 Secret

点击左下角头像，打开 设置 → 集成，这里分三块：我的连接、我的 Secret、已授权的第三方应用。 添加 Secret 时填写： 连接通过 连接新账户 添加。在搜索框中输入服务名称，列表上方是 Teable 自己对接的服务，下方 由 Composio 托管 分组里是数百个通过 Composio 授权的服务。两类连接都按同样的方式授权给应用或自动化，凭据的值也都不会展示；区别只在应用代码中的读取方式，见下文「在代码中读取」。 多数服务走一次 OAuth 即可完成连接；标有钥匙图标（通过 API Key 连接）的服务会弹出连接对话框，需要填写该服务发给你的密钥。这个值由 Composio 保管并用于签名每次请求，Teable 不会存储它。 Stripe 同时支持两种方式。它的 OAuth 只能连接正式模式（live mode）的账号，需要用测试模式验证应用时，在 连接新账户 列表中选择 Stripe 使用 API Key，或在已有的 Stripe 服务组中点击 添加 API Key，填写 sk_test_ 开头的密钥。把应用的授权换成这个账号后，应用代码不需要修改。 同一个服务可以连接多个账号，例如工作和个人两个 Gmail 邮箱。我的连接 按服务分组，组名旁显示账号数量；已连接过的服务不再出现在 连接新账户 列表中，要再连一个账号，点击该服务组的 添加账号。每个账号以它在该服务中的邮箱或用户名显示，授权给应用或自动化时也按这个名称选择。再次授权同一个账号会更新原有连接，不会多出一行。服务没有返回可识别的名称时，可以在账号的菜单中点击 重命名，起一个便于区分的名字。 授权失效时，对应账号下会显示 需要重新连接，在账号的菜单中点击 重新连接。 每条凭据下方会显示 N 个资源正在使用，后面列出最多三个应用或自动化的标签，点击名称会在新页面中打开该资源。其余的收在 +N 里，点击后弹出 正在被哪里使用 列表，每项都标着授权时间。不想再让某个资源使用这份凭据时，点击标签或列表项上的 ×（移除授权）并确认，该资源中会留下一个 尚未授权 的占位项。

​

授权给应用或自动化

打开资源的凭据面板：

• 应用：在应用构建器的对话面板中打开 + → 更多 → 凭据与配置。
• 自动化：打开工作流，在 编辑工作流 标签页点击 凭据与配置。

点击 授权，有三种方式：授权已有凭据 从你已有的 Secret 和连接中挑一个；添加 Secret 当场新建一个并直接授权；也可以从 服务 列表里选一个第三方服务，没连过的会走一次 OAuth，标着 已连接 的直接授权。 授权时需要填 变量名称，也就是这份凭据在这个应用或自动化里的别名，命名规则和 Secret 的 Key 一致，代码里读取的就是这个别名。 面板里可能出现 尚未授权 的占位项：复制应用、复制工作流、导入或复制项目时，凭据不会跟着复制过来，只保留了代码需要的别名。在占位项的 ⋯ 菜单中点击 绑定我的，补上你自己的凭据，这个应用或自动化才能正常运行。 某个别名当前绑定的是别人的凭据时，在这一行的 ⋯ 菜单中点击 换成我的，改用你自己的凭据。要解除一条绑定，在 ⋯ 菜单中点击 移除，确认对话框中有 仅移除授权 复选框：勾选时只解除绑定、保留占位项，代码不用改；不勾选则连同别名一起移除。移除别人的绑定时默认勾选，移除自己的绑定时默认不勾选。 项目里还有没连上的集成时，页面顶部会出现 有 N 个集成未连接 的提示，点击 去连接 打开集成面板，在面板中逐行连接账号或填写密钥。关掉提示只对当前这批未连接的集成生效，之后再出现新的空缺时会重新提示。这个面板只负责连接和授权，某个自动化是否运行仍由工作流自己的开关决定。

​

在代码中读取

在自动化输入框里粘贴一段疑似密钥的内容时，Teable 会自动把它存成你的 Secret，原处留下引用，明文不会留在工作流配置里。不需要这样处理时，点击提示里的 撤销。

​

第三方应用调用的算力

通过连接调用第三方应用会消耗空间算力，AI 对话、应用和自动化中的调用都计入，在计费页的 算力用量统计 中按类型 第三方应用 列出。 多数应用每次调用消耗很少；X 这类按返回条数或请求次数向 Teable 计费的应用，单次消耗会明显更高。调用失败不计费，查找可用工具也不计费。空间算力用尽后，这类调用会被拒绝。

​

AI 对话中的授权卡片

AI 需要用到某个外部账号时，会在对话中固定一张标题为 此任务需要授权 的卡片，等你处理后再继续这一轮。按谁要用这份凭据分两种。 连接卡片：Cuppy 自己要读写某个服务才能完成这次任务时出现，例如从 Gmail 取邮件、写入 Notion。卡片上是这个服务的名称，点击 连接 走一次 OAuth 或填写该服务的密钥，连接完成后当前这一轮继续，连接也会保存在 设置 → 集成 的 我的连接 中。Teable 自己对接的服务和由 Composio 托管的服务都从这张卡片连接，不需要先去设置页。点击 跳过 则不连接，Cuppy 会继续处理不依赖它的部分。连接失败时卡片会给出错误信息，点击 重试 再连一次，或点击 放弃 结束这次请求。 凭据请求卡片：你正在构建的应用或自动化运行时需要这份凭据时出现，说明它要的是哪个服务的连接，还是哪个别名的 Secret。卡片上的按钮取决于你已有的凭据：

• 连接 xxx：你还没有这个服务的账号时出现，走一次 OAuth，连接完成后自动授权给当前资源。需要用密钥连接的服务显示为 填写 xxx 密钥。
• 输入框和 保存并授权：你还没有这个别名的 Secret 时出现，填写的值会保存为你的 Secret 并授权给当前资源。
• 授权我的：直接把你已有的连接或 Secret 授权给当前资源。这个别名已被其他凭据占用时，按钮显示为 添加我的，以新的变量名称添加；你明确要求改用自己的凭据时，显示为 换成我的。
• 用 xxx 的：这个别名已绑定其他成员的凭据时出现，继续沿用对方的凭据。
• 跳过：不提供这份凭据，AI 会继续处理不依赖它的部分。

卡片等待期间直接在输入框发消息，也会关掉卡片并记为 已跳过，你这条消息成为这一轮接下来的指令；之后仍需要这份凭据时，再让 Cuppy 提出请求即可。 这项功能的使用示例可参考跨应用 AI 工作流示例。

​

更换值、删除和退出空间

更换 Secret 的值、删除 Secret 或断开连接前，Teable 会列出仍在使用它的应用和自动化。删除和断开之后这些资源会立刻失效，要让它们继续运行，得先在资源里换成别的凭据。旧的 Secret 值不可恢复。 更换值后，自动化在下次运行时使用新值；应用的预览环境需要重启，已发布的应用需要重新发布。 退出某个空间后，那里的应用或自动化还在用你的凭据时，集成 页中该资源的标签会带一个警示图标，鼠标悬停可以看到说明。不想继续提供，点击标签上的 ×（移除授权）。