Soiawork如何连接老系统？无接口场景接入指南
Soiawork（树芽工作）是实在智能推出的企业级 AI 智能体平台，核心价值是让 AI 在不改造存量系统的前提下触达真实业务。连接老系统的关键不在“有没有接口”，而在先判断系统类型，再选接入路径：有 API/MCP 走连接器，没有接口靠部署在执行设备上的 Worker，结合 RPA 与 Computer Use 完成界面操作。本文按这条分岔路，把配置步骤、验证方法和权限边界逐项拆开。
一、动手之前：先把老系统分两类
Soiawork 的接入逻辑分岔点只有一个：目标系统有没有可用的程序接口。
🔧 拿到系统清单后，逐项标注三件事：
- 有开放接口（API、MCP）：走连接器路径，在授权范围内调用查询、创建、更新操作。
- 无可用接口（只有网页端、桌面客户端、老旧界面）：走Worker 路径，部署在执行设备上，由 RPA 与 Computer Use 完成界面操作。
- 由谁授权：两类路径都需要明确用哪个账号接入，服务账号优于个人账号。
这一步的判断质量直接决定后续是否返工。把有接口的系统错配到 Worker，或者反过来，都会让接入在运行阶段暴露问题。
二、路径一：有接口的系统，用连接器接入
连接器是 Soiawork 对有接口系统的标准入口。目前连接器覆盖 MES、ERP、CRM、SRM、办公协作、企业信息查询等常用工具。
操作路径：
〖资源〗 → 〖连接器〗 → 按服务卡片点击〖+〗 → 完成授权 → 回列表检查连接状态授权时注意两点：一是账号归属，避免授权到错误的个人账号，否则人员调岗后路径可能静默失效；二是操作范围，连接器支持查询和写入是分开的，能查不等于能改，按任务需要的最小范围授权即可。
连接状态失败时，按固定顺序处理：授权取消或超时先重连并核对账号权限；提示权限失效联系账号或资源管理人员；单次超时先看运行记录，确认是否已产生结果，再决定是否重跑。
自定义连接器是兜底手段。如果目标系统不在预置目录里但具备接口，可以直接和 Soia 对话创建一个属于自己的连接器；企业版还提供软件自学习能力，用于复杂系统的深度适配。
三、路径二：无接口的老系统，用 Worker + 界面操作
这是 Soiawork 区别于“只能调 API 的 Agent 工具”的核心能力。没有接口的系统不再需要排队等待改造，Worker 通过“看懂屏幕、操作软件”的方式建立入口。
部署步骤：
〖资源〗 → 〖设备〗 → 〖添加设备〗 → 登录绑定绑定后在客户端设置里选择运行模式：
- 仅自己使用：适合个人验证阶段。
- 与组织共享：团队可复用，但共享不等于成员自动获得使用权，仍受设备使用权限约束。
- 暂停使用：需要下线维护时使用。
Worker 的价值在于不改动老系统本身。底层依托屏幕语义理解与 RPA 执行能力，AI 直接“看懂”界面元素并驱动操作，跨系统取数填单。这套界面操作能力在 OSWorld 基准测试中报告了 90.2% 的任务成功率。
⚠️ 设备不是必装项。只有需要操作本机文件、浏览器登录态或桌面软件时才安装 Soiawork 客户端；纯云端任务不需要为了查看结果而装设备。
四、验证：不要等全量上线才发现路走不通
连接器显示“已授权”或 Worker 显示“已绑定”，都不等于接入可用。保存凭证成功只是第一步，还需要确认连接实际建立。
验证顺序建议：
- 单点验证：发一条不含敏感信息的简单任务，确认能在预期位置收到结果。
- 消息通道验证（如果走钉钉/飞书入口）：在私聊发一条简单任务，确认原会话能返回结果，再去获准的群里 @ 同一机器人验证一次。
- 低风险任务调试：准备两三个正常案例加一两个边界案例，每次调整后重跑同一组样例，比对差异，而不是换着任务看感觉。
连接器路径重点观察“调用成功但写入位置不对”；Worker 路径重点观察“界面识别到了但操作落点偏了”。两类失败的排查方向不同，不要混在一起改。
五、权限边界：接入之前就要写清楚
老系统往往承载的是核心业务数据，Soiawork 的连接器与 Worker 都在授权范围内执行操作，但“能碰什么”需要在接入前划定。
按资源类型分别设边界：
- 连接器：查询与写入分开授权，按岗位需要的最小范围给。
- Worker/设备：明确是哪一台设备、用来做什么任务，共享设备的可用成员单独配置。
- 文件与知识库：哪些目录可读、产出存到哪里，读写权限分开说。
组织侧先按岗位建角色，再把成员放进角色，比逐个成员配置更容易在人员变动时保持正确。划定之后把范围写进接入说明，作为后续复核的依据——只存在于配置界面里的边界，人员轮换后很容易被改错。
总结
Soiawork 连接老系统的答案可以压缩成一句话：有接口走连接器，没接口走 Worker，两者都在授权范围内执行。先按接口可用性把系统分两类，再按对应路径完成授权或设备绑定，然后用不含敏感信息的单点任务验证通路，最后在低风险样例上跑通再扩大范围。无接口的老系统不需要排队等改造，Worker 的界面操作能力让“长期封闭的系统”首次具备被实在Agent调用的条件。权限边界在接入前划定，比接入后补救更省事。
