Poco 使用手册
快速开始

连接器与账户授权

连接个人账户,为专家、专家团和自动化任务准备外部工具授权。

连接器把外部系统的授权、账户选择和工具调用放在同一个入口。管理员维护连接器定义和包版本,用户连接自己的账号;安装专家并不等于已授权外部数据。

连接账户

  1. 打开侧栏的“连接器”。办公模式也可从专家、技能、连接器工作区切换进入。
  2. 选择连接器并查看说明、所需权限及已有账户。
  3. 点击连接,按该连接器要求完成 OAuth 登录、凭证表单或无需凭证的确认。
  4. 完成后返回 POCO,确认账户已显示且已启用。
  5. 在专家使用设置或任务能力选择中,选择本次需要使用的账户。

是否允许连接多个账户由连接器配置决定;支持多账户时,明确选择任务使用的账户。页面可按分类筛选,也可按连接器或外部账户名称搜索;停用的账户不参与正常使用。管理员可以把连接器限定给指定团队和用户;连接器定义被下线或你不在其可见范围内时,已有账户会显示在不可用连接区域,此时需要联系管理员处理。

三个配置层次

配置由谁维护用途
连接器定义管理员声明授权方式、配置字段和运行能力
个人连接账户当前用户保存外部身份、凭据和启用状态
专家或任务绑定当前用户指定实际调用哪个已授权账户

同一个外部系统也可以通过 MCP 接入。需要 POCO 管理个人授权和账户生命周期时使用连接器;已有 MCP 服务及变量配置时,按 能力配置 管理。

专家和专家团

安装专家或团队时,依赖检查会列出所需连接器。已有有效绑定可以复用;缺少授权时直接在依赖面板连接。存在多个可用账户时,确认选用的账户,避免调用错误的数据范围。

分享或导入会携带连接器依赖声明,接收者绑定自己的账户。分享者的登录态、凭据和个人账户不会被复制。

团队成员的技能与工具边界保存在团队快照中,同一连接器的账户在运行前解析。开始执行后固定配置、授权身份和工具集合;凭据可按授权机制刷新。新增连接器能力需重新保存编排;定时任务采用新团队配置需在编辑页明确选择刷新快照。

重新授权、停用与断开

  • 授权过期或权限发生变化:按连接器页面提示重新授权,再检查专家依赖。
  • 暂停使用账户:关闭启用开关;下次运行前检查会发现账户不可用。
  • 删除账户连接:使用断开操作并确认;依赖该账户的专家和自动任务需要重新绑定。

定时任务和 API 调用无法代替用户完成交互式登录,执行前应准备好可用账户。授权失败时检查外部账号权限、回调配置和连接器提示。定义不可用或服务端配置异常时联系管理员。

开发连接器包请阅读 连接器框架设计 和 连接器包开发手册。

On this page