连接器
连接外部应用账号,在 EasyXAI 中使用应用能力和资源库数据源。
连接器让你在 EasyXAI 中授权外部应用账号,并将这条连接用于应用能力或资源库数据源。例如,连接飞书后,可以选择知识库中的文档,在资源库中浏览目录、预览正文或打开飞书原文。
先了解三个概念
| 名称 | 用途 | 飞书示例 |
|---|---|---|
| 应用 | 定义可以连接的平台及其能力,由工作空间管理员安装和启用 | 应用中心里的「飞书」 |
| 连接 | 你授权给 EasyXAI 使用的外部账号 | 你本人的飞书工作账号 |
| 数据源 | 将指定外部内容组织到某个资源库中,使用已有连接访问 | 资源库里的「飞书产品资料」 |
应用能力包括 MCP 工具和技能,实际可用项以应用详情为准。数据源有独立的创建和同步入口;只连接账号不会自动将飞书内容加入资源库。
接入流程
| 步骤 | 操作人 | 完成后 |
|---|---|---|
| 1. 安装应用 | 工作空间管理员 | 应用可在当前工作空间使用 |
| 2. 配置授权应用(提供方需要时) | 工作空间管理员与外部应用管理员 | 成员可以发起账号授权 |
| 3. 连接账号 | 使用者本人 | 「我的连接」中出现已授权账号 |
| 4. 使用连接 | 使用者或管理员 | 为应用能力选择账号,或创建资源库数据源 |
请先切换到要使用的工作空间,再点击左侧资源库,在侧栏下方的扩展 → 应用中心进入。应用安装、授权应用配置和账号连接都与工作空间相关;切换后需要在目标工作空间确认配置。
管理自己的连接
在应用中心 → 我的连接中,可以查看已授权账号、修改名称、验证状态或重新连接。同一条连接可以供多个数据源使用。
应用能力可能采用「每人用自己的账号」或「团队共用」方式,具体由该能力的配置决定。每人使用自己的账号时,需要各自授权;团队共用时,相关调用使用配置的共享账号权限。
从应用详情连接账号后,还要返回「应用能力」,在需要使用的每项 MCP 或技能旁选择账号,完成绑定。 即使只有一条有效连接,也不能省略这一步。资源库数据源有自己的账号绑定,不能代替应用能力的绑定。
连接成功提示只说明凭据已保存;能力账号选择出现「绑定成功」后,再通过实际调用确认。当前部分能力页面未完整回显已绑定的个人账号,下拉框为空时,不要仅凭这一项判断凭据已丢失或重复创建连接。
更新凭据时注意
| 情况 | 处理方式 |
|---|---|
| 更换 PAT / 静态访问令牌 | 在原连接上重新连接会更新该连接使用的令牌,所有依赖它的能力和数据源会随之使用新凭据;提交前核对令牌所属账号 |
| OAuth 重新授权 | 为修复原连接,请使用原来的外部账号;授权了另一个账号时,可能形成另一条连接,需要重新选择并绑定 |
| OAuth 客户端停用 | 管理员重新启用原客户端后,再从原连接授权 |
| OAuth 客户端已删除或归档 | 使用其他有效客户端重新发起连接,并检查依赖能力和数据源的绑定;原连接不会自动切换客户端 |
数据源成员权限
飞书和 Notion 的独立账号数据源中,成员首次绑定或更换自己的连接也需要数据源的编辑权限。仅有查看权限时,可以查看已同步目录,但未绑定账号就无法直接完成正文访问;请管理员按实际职责调整数据源权限,或由管理员配置适合共享的访问方式。
共享数据源中的正文预览使用共享凭据;点击「打开原文」后,则由浏览器里登录的飞书或 Notion 账号决定能否打开。共享预览不会自动授予成员第三方原文权限。
删除连接会销毁 EasyXAI 保存的凭据,依赖它的应用能力和数据源会受到影响。若只是停止使用一个数据源,可以删除该数据源,保留账号连接供其他用途使用。
外部应用
| 应用 | 接入方式 | 使用指南 |
|---|---|---|
| 飞书 | 企业自建应用 + 成员 OAuth 授权 | 配置自建应用 · 资源库同步 · 常见问题 |
| Notion | OAuth 授权,或使用访问令牌 | 配置 OAuth 应用 · 使用访问令牌 · 资源库同步 |
| CNB | 个人访问令牌(Token) | 创建并连接 Token · 在 EasyXAI 中使用 · 常见问题 |
| GitHub | OAuth 授权,或个人访问令牌(PAT) | 配置 GitHub App · 使用 PAT · 在 EasyXAI 中使用 |