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