Skip to main content
身份验证配置

连接的账户

在一个 App 下管理多个连接:新增、改名、查看详情、删除。

连接建好之后,都归集在 App 详情页的 已连接的用户 区域。这一页说明怎么管理它们。

找到已有连接

Apps 页面单击一个 App 卡片进入详情页。页面分两块:
区域内容
已连接的用户(N)该 App 下的全部连接,N 是数量
可用的工具该 App 生成的工具及各自的入参出参
每张连接卡片显示名称、状态和创建时间,例如已连接、创建时间:2026-08-25 14:40:32。

同一个 App 连多个账号

一个 App 下可以建多个连接,互不干扰。常见用法:
场景例子
环境隔离一个 MySQL 连接指向测试库,另一个指向生产库
内容分区一个文件连接器放产品文档,另一个放内部制度
账号区分一个语雀连接用团队账号,另一个用个人账号
权限分级一个连接只读,另一个可写
单击 已连接的用户 区域的 连接新用户 卡片即可再建一个。流程和第一次连接完全相同。
需要身份验证配置的 App,多个连接可以共用同一个配置,也可以各用一个。用不同配置的典型场景是两个账号的凭证不同。

改名

连接名称是区分同类连接的主要依据,建好之后随时可以改。 单击连接名称右侧的编辑图标,名称变为可编辑状态,改完确认即可。输入框右下角有字数计数,上限 64 个字符。
名称写得具体一点。产品文档库比连接器1有用得多,尤其是同一个 App 下有好几个连接的时候。

查看详情

把鼠标移到连接卡片上,卡片下方出现 详情删除 两个按钮。单击 详情 查看这个连接的完整信息。
这两个按钮只在鼠标悬停时出现,卡片静止状态下看不到。

删除

1

悬停卡片

把鼠标移到要删除的连接卡片上,等按钮出现。
2

单击删除

单击 删除。控制台弹出确认框,标题是删除已关联的账户,提示为此操作将永久断开该账户的连接。您稍后可以重新连接,但现有的任何配置可能会丢失。
3

确认

确认无误后单击弹窗中的 删除。删除成功后连接从列表中消失。要取消操作,单击 取消
删除不可撤销。连接删除后,依赖它的智能体和客户端会立刻失去对应工具,正在运行的任务可能报错。生产环境操作前先确认没有正在使用这个连接的任务。
删除连接不会删除它使用的身份验证配置,配置仍留在 身份验证配置 列表中,可以给新连接复用。

状态与失效

状态含义处理
已连接凭证有效,工具可用无需处理
已过期凭证失效,工具调用会失败更新身份验证配置中的凭证,然后重建连接
凭证失效的常见原因是对方系统里的 Token 过期、密钥被轮转,或 OAuth 应用被停用。排查思路见OAuth 2.0 配置API Key 配置

不支持的操作

操作说明
修改连接类型创建后不可更改,只能新建
恢复已删除的连接删除不可撤销,需要重新创建