Developer Docs

文档首页

开发文档

架构与接入方式

智能化叠加分层模型、应用/技术/集成架构图与四种价值连接。

Fellow 叠在客户 L1 业务系统 之上。L1 不动,从 L2 集成连接开始逐层向上。业务背景见 企业智能化升级

智能化叠加分层模型(L1–L5)

在现有业务系统之上,按阶段叠加智能化能力的建设参考模型——不是 Fellow 内部模块图,也不是部署架构。L5 安全与治理贯穿各层。

叠加建设顺序:从 L2 开始,逐层向上。

层级客户侧改动进入下一层的条件
L2 集成连接配置 Connector / MCP / SDK / IM数据与工具边界可验证
L3 Agent 平台选型 Skills、配置 Agent、权限边界与 L2 并行
L4 价值产出选定试点场景、验收交付标准结果可重复且有业务负责人
L5 安全治理部署、权限、运行记录与合规复核贯穿全程

图 1 · 应用架构

面向业务用户与管理员的产品能力分层。L1 客户现有系统不在 Fellow 内,通过集成层读取业务上下文;只有 Connector、MCP 或 Client Tool 明确提供修改能力时,才可以在其权限边界内写回。

价值产出回写路径

路径机制示例
SDK 嵌入回写Client Tools(fellow-embed)在宿主页面执行CRM 跟进邮件写入表单、工单备注
MCP / Connector 回写Agent 调用已授权写接口更新 CRM 商机、MES 工单备注
IM 通道推送Channel Adapter 回复消息 / 文件周报推回飞书 / 企微
工作区保存交付物留在 Fellow 工作区文档、数据文件与其他成果

试点建议:先只读 + 工作区交付,验证后再开放受限写回。交互演示见 场景样例

图 2 · 技术架构(端云一体)

桌面版、Cloud SaaS、私有化部署共用同一 Monorepo 与运行时内核;差异由 @fellow/deployment-policy Deployment Profile 切换,非两套产品线。部署形态见 部署选型

维度端(桌面版)云(SaaS / 私有化)一致性
代码同一 Monorepo同一 Monorepo
工作台 UIapps/web 内嵌 ElectronGateway 托管或独立 SPA✅ 同一 SPA
接入协议@fellow.work/client@fellow.work/client✅ Thread/Run/SSE
Agent 内核Pi / DSH HarnessPi / DSH Harness
集成层MCP · Connectors · Channels同左
差异点本机 Gateway、OS 沙箱、SQLite数据库、Sandbox、认证与独立 Console 由部署配置决定需按目标 Profile 验证

图 3 · 集成架构

业务系统无需改造,通过标准接口双向对接——读上下文、写回成果。

集成方式协议 / 组件文档
MCPModel Context ProtocolMCP Server
Connectors HubAnyConnect HTTPConnectors Hub
SDK + Client Tools@fellow.work/client + fellow-embedClient SDK · 嵌入指南
IM 通道Webhook / Bot APIIM 通道

四种价值连接

智能化落地需要四类连接:能力决定 Agent 做什么,数据 / 嵌入 / 协作决定在工作流里怎么触发与交付。

1. 能力与应用 — Agent 会什么、留下什么

对话内:Skills 与 行业能力包 封装方法论,用户 @ 即用,产出可验收成果。

对话外HARP 应用 可以把验证过的高频流程封装为可安装的 HTTP 应用。当前 Fellow Host 只实现目标规范的子集,生产发布仍需要代码、安全和平台兼容性评审。

对应架构 L3 Agent 平台层L4 价值产出

行业能力包 · Skills · HARP 应用

2. Connectors + MCP — 数据流

Agent 读取业务数据、调用 API、检索知识库。典型:CRM 尽调摘要、MES 工艺文件、知识库合规意见书。

Connectors Hub · MCP Server

3. SDK 嵌入 — 交互流

在 CRM、工单、门户内增加智能入口;Client Tools 将成果写回表单。

Client SDK · 接入应用 · 场景样例

4. IM 通道 — 协作流

飞书、企微、钉钉、Slack 等 @Bot 触发,零培训推广。

IM 通道

相关文档