EasyXAI 文档
连接器

连接器

连接外部应用账号,在 EasyXAI 中使用应用能力和资源库数据源。

连接器让你在 EasyXAI 中授权外部应用账号,并将这条连接用于应用能力或资源库数据源。例如,连接飞书后,可以选择知识库中的文档,在资源库中浏览目录、预览正文或打开飞书原文。

先了解三个概念

名称用途飞书示例
应用定义可以连接的平台及其能力,由工作空间管理员安装和启用应用中心里的「飞书」
连接你授权给 EasyXAI 使用的外部账号你本人的飞书工作账号
数据源将指定外部内容组织到某个资源库中,使用已有连接访问资源库里的「飞书产品资料」

应用能力包括 MCP 工具和技能,实际可用项以应用详情为准。数据源有独立的创建和同步入口;只连接账号不会自动将飞书内容加入资源库。

接入流程

步骤操作人完成后
1. 安装应用工作空间管理员应用可在当前工作空间使用
2. 配置授权应用(提供方需要时)工作空间管理员与外部应用管理员成员可以发起账号授权
3. 连接账号使用者本人「我的连接」中出现已授权账号
4. 使用连接使用者或管理员为应用能力选择账号,或创建资源库数据源

请先切换到要使用的工作空间,再点击左侧资源库,在侧栏下方的扩展 → 应用中心进入。应用安装、授权应用配置和账号连接都与工作空间相关;切换后需要在目标工作空间确认配置。

管理自己的连接

应用中心 → 我的连接中,可以查看已授权账号、修改名称、验证状态或重新连接。同一条连接可以供多个数据源使用。

应用能力可能采用「每人用自己的账号」或「团队共用」方式,具体由该能力的配置决定。每人使用自己的账号时,需要各自授权;团队共用时,相关调用使用配置的共享账号权限。

从应用详情连接账号后,还要返回「应用能力」,在需要使用的每项 MCP 或技能旁选择账号,完成绑定。 即使只有一条有效连接,也不能省略这一步。资源库数据源有自己的账号绑定,不能代替应用能力的绑定。

连接成功提示只说明凭据已保存;能力账号选择出现「绑定成功」后,再通过实际调用确认。当前部分能力页面未完整回显已绑定的个人账号,下拉框为空时,不要仅凭这一项判断凭据已丢失或重复创建连接。

更新凭据时注意

情况处理方式
更换 PAT / 静态访问令牌在原连接上重新连接会更新该连接使用的令牌,所有依赖它的能力和数据源会随之使用新凭据;提交前核对令牌所属账号
OAuth 重新授权为修复原连接,请使用原来的外部账号;授权了另一个账号时,可能形成另一条连接,需要重新选择并绑定
OAuth 客户端停用管理员重新启用原客户端后,再从原连接授权
OAuth 客户端已删除或归档使用其他有效客户端重新发起连接,并检查依赖能力和数据源的绑定;原连接不会自动切换客户端

数据源成员权限

飞书和 Notion 的独立账号数据源中,成员首次绑定或更换自己的连接也需要数据源的编辑权限。仅有查看权限时,可以查看已同步目录,但未绑定账号就无法直接完成正文访问;请管理员按实际职责调整数据源权限,或由管理员配置适合共享的访问方式。

共享数据源中的正文预览使用共享凭据;点击「打开原文」后,则由浏览器里登录的飞书或 Notion 账号决定能否打开。共享预览不会自动授予成员第三方原文权限。

删除连接会销毁 EasyXAI 保存的凭据,依赖它的应用能力和数据源会受到影响。若只是停止使用一个数据源,可以删除该数据源,保留账号连接供其他用途使用。

外部应用

应用接入方式使用指南
飞书企业自建应用 + 成员 OAuth 授权配置自建应用 · 资源库同步 · 常见问题
NotionOAuth 授权,或使用访问令牌配置 OAuth 应用 · 使用访问令牌 · 资源库同步
CNB个人访问令牌(Token)创建并连接 Token · 在 EasyXAI 中使用 · 常见问题
GitHubOAuth 授权,或个人访问令牌(PAT)配置 GitHub App · 使用 PAT · 在 EasyXAI 中使用