智能体与技能

连接外部应用与管理授权

让助手在你拥有的权限内读取或处理外部应用里的资料。

功能概述

连接器把外部应用的能力带进任务,账号授权和助手配置都要正确。

01开始之前#

操作入口

技能和连接器 → 连接器 → 添加 / 配置

适用人员

所有成员

02跟着步骤操作#

  1. 确认需要连接哪个应用

    先明确工作目标和所需数据,向管理员确认组织已支持的连接方式。

  2. 添加对应连接器

    在连接器页选择可用应用或配置入口,填写页面要求的非敏感说明;服务地址使用管理员提供的地址。

    先进入连接器,再选择对应来源
    1. 先进入连接器,再选择对应来源
  3. 由本人完成授权

    按页面引导登录外部账号或填写所需凭据。密钥只在专用配置字段中填写,不放进任务、技能或群消息。

  4. 检查连接状态

    如果提供测试连接,先测试并等待结果;失败时核对账号权限、地址与网络后再保存。

  5. 绑定到所需助手

    为目标助手启用连接器,先做一项小范围读取,确认使用的是正确账号和组织,再安排写入类任务。

指南与技巧

添加连接后,先验证最小范围

  1. 1. 确认要连哪个账号

    在连接器页选择相应工具,先核对组织、账号和用途。同一个工具的个人账号与组织账号可能能看到不同资料。

  2. 2. 按入口完成认证

    由账号本人完成登录或授权,阅读权限范围。不要把密钥或验证码粘贴到任务正文,使用专门的配置入口。

  3. 3. 检查可用状态

    保存后看连接状态,再确认执行助手已经允许使用该工具。工具存在于列表,不等于认证有效或已配给当前助手。

  4. 4. 先做小范围读取

    选择一条允许访问的记录或测试文件,检查返回对象是不是目标账号里的内容。成功后才安排更大的工作。

  5. 5. 处理授权失效

    记录工具名称与错误,重新走该工具的授权入口。不要反复新建同名连接器,避免任务使用了旧连接。

03怎样确认做对了#

连接器已授权且可被指定助手使用,任务访问范围与外部账号权限一致。

04常见情况与解决方法#

连接成功但任务读不到数据

连接测试通过不代表外部账号拥有目标资源权限;检查资源授权、助手绑定和数据所属账号。

授权过期或外部系统要求重新登录

返回连接器重新认证。不要把验证码或登录截图发送给他人处理。

升级后旧连接器没有显示

先核对账号、组织和设备;如出现“恢复旧版连接器”入口,按引导确认归属并恢复,检查配置后再启用。保留旧数据,不要手动删目录。

功能入口可能因客户端版本、组织配置和个人权限而有所不同,请以当前界面为准。

界面位置