Skip to main content
云端版本所有方案可用;私有部署版本需要商业版及以上方案。
应用和自动化要调用外部服务时,用的是你的凭据。凭据属于个人,不属于某个应用或自动化,分两种:
  • 连接:授权给 Teable 的第三方账号,比如 Slack、Airtable、Google Sheets。
  • Secret:你自己保存的 API Key、访问令牌等字符串。
凭据统一在 设置 → 集成 中管理,再按需授权给某个应用或自动化。授权之后,凡是运行这个应用或自动化的人,用的都是授权者的那份凭据;凭据的值不会展示给任何人,自动化测试结果里也会被遮蔽。

管理你的连接和 Secret

点击左下角头像,打开 设置 → 集成,这里分三块:我的连接、我的 Secret、已授权的第三方应用。 添加 Secret 时填写: 连接通过 连接新账户 添加。在搜索框中输入服务名称,列表上方是 Teable 自己对接的服务,下方 由 Composio 托管 分组里是数百个通过 Composio 授权的服务。两类连接都按同样的方式授权给应用或自动化,凭据的值也都不会展示;区别只在应用代码中的读取方式,见下文「在代码中读取」。 多数服务走一次 OAuth 即可完成连接;标着 通过 API Key 连接 的服务会弹出连接对话框,需要填写该服务发给你的密钥。这个值由 Composio 保管并用于签名每次请求,Teable 不会存储它。 授权失效时,对应连接上会出现 重新连接。 每条凭据下方会显示它正在被多少个资源使用。点击 查看 可以看到具体的应用和自动化清单,每项都标着授权时间,也可以对其中某一项 移除授权。

授权给应用或自动化

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

在代码中读取

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

第三方应用调用的算力

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

AI 对话中的授权卡片

AI 需要用到某个外部账号时,会在对话中固定一张标题为 此任务需要授权 的卡片,等你处理后再继续这一轮。按谁要用这份凭据分两种。 连接卡片:Cuppy 自己要读写某个服务才能完成这次任务时出现,例如从 Gmail 取邮件、写入 Notion。卡片上是这个服务的名称,点击 连接 走一次 OAuth 或填写该服务的密钥,连接完成后当前这一轮继续,连接也会保存在 设置 → 集成 的 我的连接 中。Teable 自己对接的服务和由 Composio 托管的服务都从这张卡片连接,不需要先去设置页。点击 跳过 则不连接,Cuppy 会继续处理不依赖它的部分。连接失败时卡片会给出错误信息,点击 重试 再连一次,或点击 放弃 结束这次请求。 凭据请求卡片:你正在构建的应用或自动化运行时需要这份凭据时出现,说明它要的是哪个服务的连接,还是哪个别名的 Secret。可以选择:
  • 连接我的账号:走一次 OAuth,连接完成后自动授权给当前资源。
  • 授权我的 xxx:直接使用你已有的连接或 Secret。
  • 跳过:不提供这份凭据,AI 会继续处理不依赖它的部分。
卡片等待期间直接在输入框发消息,也会关掉卡片并记为 已跳过,你这条消息成为这一轮接下来的指令;之后仍需要这份凭据时,再让 Cuppy 提出请求即可。

更换值、删除和退出空间

更换 Secret 的值、删除 Secret 或断开连接前,Teable 会列出仍在使用它的应用和自动化。删除和断开之后这些资源会立刻失效,要让它们继续运行,得先在资源里换成别的凭据。旧的 Secret 值不可恢复。 更换值后,自动化在下次运行时使用新值;应用的预览环境需要重启,已发布的应用需要重新发布。 退出某个空间后,那里的应用或自动化还在用你的凭据时,集成 页会提示 你已退出该空间。不想继续提供,点击 移除授权。
最后修改于 2026年9月21日