EpicStaff/EpicStaff

Source-available, self-hosted platform for building AI agent flows - visual editor over a Django backend.

EpicStaff – 自托管 AI 代理编排平台

是什么 – EpicStaff 是一个源码可用的 Web 应用，允许团队设计、运行和审计多代理 AI 工作流。一个可视化的节点编辑器构建在 Django 后端之上，每个节点可以包含自定义 Python 代码、对 LLM/嵌入器的调用、针对内置向量存储的 RAG，或通过 MCP 协议进行集成。由于整个栈运行在您自己的服务器上的 Docker（或 Podman）中，运营团队可以完全拥有流程的所有权、安全性和可审计性。

为什么重要 – 目前大多数 LLM 代理都是作为脚本编码的，只有工程师才能阅读或修改。EpicStaff 弥合了构建集成的工程师与需要拥有、检查和控制系统流程的运营/审计人员之间的差距。代理做出的每个决定都会持久化在会话账本中，无需重新部署代码即可通过 UI 进行审查或编辑。

快速入门（3 步总结）

安装 Git 和 Docker（或 Podman）。

克隆仓库并复制示例环境文件：

git clone https://github.com/EpicStaff/EpicStaff.git && cd EpicStaff/src
cp .env.example .env

运行 Docker Compose 堆栈（README 中的脚本还会生成密钥并创建所需的卷/网络）：
```
docker compose up --build
```
然后在浏览器中打开 http://localhost 启动可视化工作流构建器。

核心技术功能（面向 AI 工程师）

功能	作用
基于节点的 UI	拖放式图形编辑器；每个节点可以包含自定义 Python、LLM 调用或 RAG 逻辑。
LLM 和嵌入器提供程序	在 OpenAI、Anthropic 或自托管模型之间切换；可以插入任何兼容的推理端点。
检索增强生成（RAG）	直接从 UI 上传文档，构建向量索引（Naive 或 GraphRAG）；代理可以在运行期间查询这些索引。
自定义 Python 工具	编写任意 Python 函数，作为任何代理节点可调用的工具。
持久化代理内存	短期窗口上下文和长期状态存储在 PostgreSQL（pgvector）和 Redis 中，跨会话共享。
Webhooks 和 API 触发器	通过 HTTP POST 启动流程，支持与 CRM、工单系统等集成。
生产级持久性	内置用户/组织变量的状态管理；所有决定都会记录在会话账本中。
Django 后端	强大的低延迟 Python 服务器，执行图形、强制每个代理的权限并提供审计跟踪。

面向商业的益处

可视化工作流构建器让非技术运营人员无需接触代码即可创建和修改自动化。
企业级安全 – 基于角色的访问控制和每个代理的权限。
可审计性 – 代理的每个决定都存储起来，可以检查或回滚。
多代理协作 – 构建“数字团队”，让多个代理协调以自动化整个部门。
可扩展的 Python 工具提供了与内部 API 的无限集成可能性。
语音和网页抓取功能支持免提数据收集和内容生成。

充分利用 EpicStaff

在 UI 中定义代理，附加适当的 LLM 提供程序和所需的任何自定义 Python 工具。
创建知识集合（上传文档并建立索引），如果您想要 RAG 增强的响应。
连接到内部系统 – 通过 MCP 或直接的 Python 调用；平台将对执行进行沙盒化并强制执行您设置的权限。
部署 – 将 Docker 堆栈部署到您的本地服务器或私有云；使用提供的 cosign 验证工作流确保图像的真实性。
监控和审计 – 通过内置的流程消息和会话账本进行；必要时暂停任何步骤进行手动审查。

社区与贡献

EpicStaff 欢迎拉取请求、问题报告和新工具贡献。该项目基于 Foblex 社区的 f‑flow 开源库构建，仓库包含详细的贡献指南（CONTRIBUTING.md）。Star 和 fork 通过常见的 GitHub 徽章进行跟踪。

TL;DR – EpicStaff 提供了一个自托管、基于 Django 的可视化平台，用于构建、运行和审计多代理 AI 工作流。它结合了拖放式编排、持久内存、RAG 和自定义 Python 工具，并具有企业级安全和完全可审计性。