本文介绍开源项目ComPilot Platform——一套可本地部署的多租户企业协作底座把LangGraph 对话式 AI、低代码建模、RBAC 权限、组织架构和审批流程放在同一个仓库里适合中小团队快速搭建内部系统也适合开发者二次开发学习「AI Agent 业务平台」的整合方式。一、为什么做这个项目很多团队在落地内部系统时会遇到几类典型问题低代码平台能搭表单但和 AI、权限、组织模型各搞一套集成成本高对话式 AI很炫却缺少「查报表、填表单、发起审批」等可落地的工具链开源 Admin 模板功能全但低代码、流程、多租户 AI 往往要自己动手拼。ComPilot Platform的目标是用一套后端 一套前端把「日常用 AI」和「管理员搭系统」放在同一平台里并且普通用户首页 AI 助手查数据、填表、走流程业务搭建者低代码工作室里用 AI 建实体、表单、报表、菜单系统管理员设置里管用户、组织、字典、外部 API、运维助手。项目已开源仓库地址https://gitcode.com/socialman/ComPilotPlatform欢迎 Star、Fork、提 Issue。二、核心能力一览模块能做什么AI 助手三套智能体首页通用助手 / 低代码开发助手 / 运维助手工具权限隔离低代码实体设计 → 表单应用 → 报表 → 流程定义与实例权限 RBAC用户、角色、菜单与资源权限组织架构部门树、负责人、实体数据范围、流程审批人如部门负责人数据字典字典类型与字典项表单字段下拉联动外部 API配置第三方 HTTPBearer / API Key / Basic 等表单与 AI 代理调用工作流待办、审批、流程运行时系统设置AI 模型、智能体、菜单、用户、组织、字典、外部 API 等2.1 三套 AI 助手权限边界清晰这是项目比较有特色的设计之一——不是一个大而全的 Agent 给所有人用而是按场景拆分智能体使用场景能力边界default通用助手首页普通业务用户查报表、增删改业务数据、发起流程等不含低代码建模与运维lowcode低代码助手低代码工作室建实体、应用、菜单、流程可调外部 API含角色/菜单管理工具ops运维助手系统设置租户级用户、组织、AI 配置查看等运维操作底层基于LangGraph LangChain OpenAI对话 checkpoint 持久化工具调用走统一的chat_tools注册表扩展新工具只需登记元数据即可。2.2 低代码从实体到上线典型搭建路径实体字段、校验、联动 → 表单/报表应用 → 挂菜单 → 可选绑定审批流程字段支持多种联动数据源用户 / 部门含部门树选择数据字典本系统报表外部 API配置编码、路径、响应数组路径、值/显示字段表单填写时通过平台代理请求外部接口密钥不暴露给浏览器适合对接企业已有 HTTP 服务。2.3 组织与数据权限支持部门树、部门负责人实体可配置数据范围如本部门、本部门及下级等流程节点支持dept_leader、starter_dept_leader等指派方式——更贴近国内企业审批习惯。2.4 外部 API低代码与 AI 共用在系统设置 → 外部 API中维护Base URL、超时、默认 Header鉴权none/bearer/api_key_header/api_key_query/basic/custom连接测试、密钥脱敏展示低代码字段选sourceexternal_api即可做下拉低代码 AI 可用external_api_list、external_api_invoke代理调用。三、技术架构3.1 技术栈层级选型后端Python 3.10、FastAPI、SQLite默认/PostgreSQLAILangGraph1.x、LangChain OpenAI、SQLite checkpoint前端Vue 3、TypeScript、Vite、Element Plus认证JWT bcrypt多租户tenant_id隔离测试pytest3.2 目录结构精简ComPilotPlatform/ ├── app/ # FastAPIapi / core / schemas / services ├── web/ # Vue 3 前端 ├── data/ # 运行时 DB、上传、设置Git 忽略 ├── dist/ # 前端构建产物生产由 FastAPI 托管 ├── tests/ └── requirements.txt3.3 架构示意存储后端 FastAPI前端首页 AI 助手低代码工作室系统设置认证 / RBAC低代码 Runtime流程引擎LangGraph Chat外部 API 代理SQLite / PostgreSQLCheckpoint DB四、5 分钟本地跑起来4.1 克隆仓库gitclone https://gitcode.com/socialman/ComPilotPlatform.gitcdComPilotPlatform4.2 启动后端python-mvenv .venvsource.venv/bin/activate# Windows: .venv\Scripts\activatepipinstall-rrequirements.txt python-muvicorn app.main:app--host0.0.0.0--port8000--reload首次启动会在data/下自动建库并执行 schema 迁移当前v13。4.3 启动前端开发模式cdwebnpminstallnpmrun dev浏览器访问http://127.0.0.1:5173API 通过 Vite 代理到8000。4.4 默认管理员用户名密码adminadmin123生产环境请第一时间修改密码。4.5 配置 AI可选在项目根目录创建.env已在.gitignore中OPENAI_API_KEY你的密钥 OPENAI_BASE_URLhttps://api.openai.com/v1也可登录后在系统设置 → AI里配置 OpenAI 兼容接口。4.6 生产部署前后端一体cdwebnpmrun buildcd..python-muvicorn app.main:app--host0.0.0.0--port8000构建产物输出到dist/由 FastAPI 直接托管静态资源。API 文档http://127.0.0.1:8000/docs五、典型使用场景场景 1业务人员用 AI 查报表、提交流程员工在首页对助手说「帮我查一下本月销售报表」或「发起请假流程」——通用助手通过工具调用查询报表、写入实体、启动流程实例无需接触低代码设计器。场景 2实施顾问 30 分钟搭一个内部应用在低代码工作室设计实体字段文本、数字、日期、关联用户/部门/字典等创建表单应用并发布菜单让低代码 AI 助手协助批量建字段、挂菜单、绑流程。适合 OA、台账、轻量 CRM 等内部系统。场景 3对接已有 HTTP 服务在设置里配置外部 API如天气、主数据、第三方认证服务表单字段选「外部 API」联动或由 AI 通过external_api_invoke代理调用——鉴权在服务端完成前端与 Prompt 中不出现明文密钥。场景 4管理员运维系统设置中管理用户、部门、角色权限、数据字典运维 AI 助手可协助查询租户信息、用户列表等工具均带tenant_id隔离防止越权。六、安全与开源注意事项项目.gitignore已排除敏感路径请勿将以下内容提交到公开仓库.env、.env.*data/数据库、settings.json、.jwt_secret、上传文件虚拟环境与node_modules接口返回外部 API Key、AI Key 时会脱敏为********。当前仓库尚未标注正式开源许可证二次商用前建议联系维护者或自行补充 License。七、适合谁用人群建议独立开发者 / 小团队本地部署一套内部协作 低代码底座减少从零拼装学习 AI Agent 的开发者参考三套 Agent 拆分、工具注册表、租户隔离实现低代码爱好者体验实体 → 表单 → 报表 → 流程一体化链路企业信息化实施Fork 后按行业包定制实体与流程需自行评估许可证八、后续规划欢迎共建开源社区常见演进方向也欢迎在 Issue / PR 中讨论表单提交 Webhook / 外部 API 触发更多流程节点类型与会签规则对象存储OSS与附件预览增强明确开源 LicenseMIT / Apache 2.0 等Docker Compose 一键部署九、参与贡献Star仓库https://gitcode.com/socialman/ComPilotPlatformFork后提 PR功能、文档、测试均可提 IssueBug、需求、使用反馈# 跑测试pytest十、写在最后ComPilot Platform不是又一个「纯聊天 Demo」而是尝试把AI 工具调用和可交付的企业业务模块放在同一套代码里你能看到权限怎么拦、租户怎么隔、低代码字段怎么联动外部系统、三种 Agent 怎么各守其责。如果你正在做内部数字化、AI 应用落地或想学习FastAPI Vue3 LangGraph的全栈整合不妨 clone 一份本地跑跑也欢迎把使用体验和改进建议留在仓库 Issue 里。 https://gitcode.com/socialman/ComPilotPlatform