开源一款「AI + 低代码 + 工作流」企业协作平台：ComPilot Platform 上手与实践

2301_81955753

344人浏览 · 2026-05-19 14:57:50

2301_81955753 · 2026-05-19 14:57:50 发布

本文介绍开源项目 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	配置第三方 HTTP（Bearer / 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
连接测试、密钥脱敏展示

低代码字段选 source=external_api 即可做下拉；低代码 AI 可用 external_api_list、external_api_invoke 代理调用。

三、技术架构

3.1 技术栈

层级	选型
后端	Python 3.10+、FastAPI、SQLite（默认）/ PostgreSQL
AI	LangGraph 1.x、LangChain OpenAI、SQLite checkpoint
前端	Vue 3、TypeScript、Vite、Element Plus
认证	JWT + bcrypt，多租户 `tenant_id` 隔离
测试	pytest

3.2 目录结构（精简）

ComPilotPlatform/
├── app/                 # FastAPI：api / core / schemas / services
├── web/                 # Vue 3 前端
├── data/                # 运行时 DB、上传、设置（Git 忽略）
├── dist/                # 前端构建产物（生产由 FastAPI 托管）
├── tests/
└── requirements.txt

3.3 架构示意

四、5 分钟本地跑起来

4.1 克隆仓库

git clone https://gitcode.com/socialman/ComPilotPlatform.git
cd ComPilotPlatform

4.2 启动后端

python -m venv .venv
source .venv/bin/activate          # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python -m uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload

首次启动会在 data/ 下自动建库并执行 schema 迁移（当前 v13）。

4.3 启动前端（开发模式）

cd web
npm install
npm run dev

浏览器访问 http://127.0.0.1:5173，API 通过 Vite 代理到 8000。

4.4 默认管理员

用户名	密码
admin	admin123

生产环境请第一时间修改密码。

4.5 配置 AI（可选）

在项目根目录创建 .env（已在 .gitignore 中）：

OPENAI_API_KEY=你的密钥
OPENAI_BASE_URL=https://api.openai.com/v1

也可登录后在 系统设置 → AI 里配置 OpenAI 兼容接口。

4.6 生产部署（前后端一体）

cd web && npm run build
cd .. && python -m uvicorn app.main:app --host 0.0.0.0 --port 8000

构建产物输出到 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）与附件预览增强
明确开源 License（MIT / Apache 2.0 等）
Docker Compose 一键部署

九、参与贡献

Star 仓库：https://gitcode.com/socialman/ComPilotPlatform
Fork 后提 PR：功能、文档、测试均可
提 Issue：Bug、需求、使用反馈

# 跑测试
pytest

十、写在最后

ComPilot Platform 不是又一个「纯聊天 Demo」，而是尝试把 AI 工具调用 和 可交付的企业业务模块 放在同一套代码里：你能看到权限怎么拦、租户怎么隔、低代码字段怎么联动外部系统、三种 Agent 怎么各守其责。

如果你正在做内部数字化、AI 应用落地，或想学习 FastAPI + Vue3 + LangGraph 的全栈整合，不妨 clone 一份本地跑跑，也欢迎把使用体验和改进建议留在仓库 Issue 里。

👉 https://gitcode.com/socialman/ComPilotPlatform

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

防止Agent胡来五大安全防线

防止 Agent 调用外部工具时“胡来”，不能仅依赖模型自身的指令遵循能力，必须构建**“架构隔离 + 代码校验 + 流程审批 + 全程审计”**的综合防御体系。通过本地化部署大模型减少数据外泄风险，并结合特定业务的风险预警模块，可显著提升系统的可控性与安全性。最终目标是实现效率与安全的平衡，确保智能体在既定规则范围内可靠运行。