README_ZH.md

一个面向 AI 应用构建、编排、发布与运营的端到端 Agent 平台。
基于 Flask + LangChain/LangGraph 的后端，配合 Vue 3 工作台、可视化工作流、数据集、工具与 OpenAPI 交付能力。

本项目由 Atlas Cloud 和 Bloome 赞助

访问官网 · API 文档 · English · GitHub

目录

• 项目简介
• 架构图
• 技术栈
• 快速开始
• 功能展示
• 测试
• 联系方式
• 鸣谢

项目简介

OpenAgent 不是单一的聊天 Demo，而是一个面向团队和产品化场景的全栈 AI Agent 平台。当前仓库同时包含 Flask 后端、Celery 后台任务、Vue 3 前端工作台、可视化工作流编排、数据集与文档管理、公共应用发布，以及基于 OpenAPI 的对外调用能力。

当前代码库已经覆盖这些核心能力：

• 首页助手可以通过 A2A 将用户问题路由到应用广场中已发布的公共 Agent，也可以把自然语言需求转成新的 AI Agent / 应用创建流程。
• 在独立工作台中创建和管理 AI 应用，支持草稿、发布、分析、版本对比和提示词对比。
• 开启深度思考（Deep Research）后，应用可以拆解复杂任务并调度已绑定的能力完成多步骤处理，适合需要深入推理和实际产出的场景。
• 通过可视化节点编排工作流，节点涵盖 LLM、工具调用、知识库检索、代码执行、HTTP 请求、条件分支、文本处理、模板转换和参数提取。
• 管理数据集、上传文档、查看切片，并把检索能力接入工作流或应用。
• 通过类似应用商店的页面浏览公共应用、工具和工作流。
• 通过 POST /api/openapi/chat 以 REST 或流式方式调用已发布应用。

架构图

点击图片可查看原始大图。

技术栈

• AI 开发框架与编排：LangChain、LangGraph、Workflow 编排、工具调用、A2A 委派、Skill、Memory
• 知识与检索：RAG、向量检索、全文检索、混合检索、Weaviate、FAISS
• 后端：Python、Flask、SQLAlchemy、Celery、Flask-SocketIO、Redis、PostgreSQL
• 前端：Vue 3、JavaScript / TypeScript、Vite、TailwindCSS、Pinia、Vue Flow、Arco Design
• 基础设施与交付：Docker Compose、Nginx、OpenAPI、SSE
• 模型接入：OpenAI、Atlas Cloud、DeepSeek、Grok、Google、Moonshot、Tongyi、Wenxin、Ollama、Zhipu

赞助商

Atlas Cloud

• Atlas Cloud 是 OpenRouter 的模型提供商。本项目可通过 ATLASCLOUD_API_KEY 和 ATLASCLOUD_API_BASE 接入。
• 官方网站：Atlas Cloud
• 接入文档：https://www.atlascloud.ai/docs

Bloome

• Bloome 是一个 AI Agent 即时通讯平台，你可以与 AI Agent 互动并构建协作社区。官方网站：Bloome

(返回顶部)

快速开始

环境要求

• Docker 20.10+
• Docker Compose 2.x
• 推荐 8 GB+ 内存运行完整栈
• 至少准备一个可用的模型提供商 API Key

安装与启动

1. 克隆仓库。

   git clone https://github.com/Haohao-end/openagent.git
   cd openagent

2. 创建运行时环境文件。

   cp api/.env.example api/.env

3. 检查 api/.env 中的最小必填项。

   • JWT_SECRET_KEY
   • POSTGRES_PASSWORD
   • REDIS_PASSWORD
   • WEAVIATE_API_KEY
   • VITE_API_PREFIX
   • 至少一个模型提供商 Key，例如 OPENAI_API_KEY、ATLASCLOUD_API_KEY、DEEPSEEK_API_KEY 或 DASHSCOPE_API_KEY

4. 启动 Docker 编排。

   cd docker
   docker compose up -d --build

5. 打开本地服务。

   服务	地址	说明
   前端	http://localhost:3000	Vue 3 Web 界面
   API	http://localhost:5001	Flask REST API
   Nginx	http://localhost	反向代理

本地开发

后端：

cd api
pip install -r requirements.txt
flask run --port 5001

前端：

cd ui
npm install
npm run serve

Vite 默认在 5173 端口提供服务。前端会基于 VITE_API_PREFIX 解析 API 地址，在本地开发时通常通过 /api 代理到 Flask 后端。

常用命令：

cd api
pytest

cd ui
npm run type-check
npm run lint
npm run build
npm run test:unit -- --run

(返回顶部)

功能展示

1. 首页助手体验

首页可以作为默认的 AI 助手入口，通过 A2A 将用户问题路由到应用广场里最相关的已发布公共 Agent，也可以把自然语言需求转成新的 AI Agent / 应用创建流程。同一个入口还支持多轮对话、推荐问题、图片上传和语音输入。

2. 应用工作台与 Deep Research

应用工作台是 AI 应用的主工作区，不是单独的配置页。左侧负责模型、提示词和能力绑定，右侧负责调试对话、执行轨迹和结果检查。截图中的 Deep Research，对应代码中的深度思考模式 enable_deep_thinking。

主要功能：

• 配置与版本管理：集中处理模型切换、人设与回复逻辑、草稿、发布、版本对比、提示词对比和应用复制。
• 能力接入：统一绑定插件、MCP、Skills、Agent 子应用、工作流和知识库，扩展应用的可调用能力。
• 复杂任务执行：开启 Deep Research 后，应用可以拆解任务并调度已绑定能力完成多步骤处理。
• 沙箱与产物输出：支持脚本执行、代码处理、文件生成和附件导出，适合需要实际产出的任务。
• 调试与结果验证：右侧调试区用于发起真实对话，查看深入思考轨迹、任务状态、生成产物和最终结果。

3. 可视化工作流编辑器

工作流支持通过节点方式编排，包括 LLM、工具调用、数据集检索、代码执行、HTTP 请求、模板转换、文本处理、变量赋值、参数提取、条件分支、开始节点和结束节点。

4. 数据集与检索

你可以创建数据集、上传文档、查看文档切片，并将检索能力接入工作流或 AI 应用，实现知识增强行为。

5. OpenAPI 交付

应用发布后，可以通过 POST /api/openapi/chat 进行标准调用或流式调用，并支持多轮对话所需的会话标识。

(返回顶部)

测试

仓库已经包含自动化的后端与前端测试能力。

• 后端：cd api && pytest
• 前端单元测试：cd ui && npm run test:unit -- --run
• 前端类型检查：cd ui && npm run type-check
• 前端构建校验：cd ui && npm run build

联系方式

• 项目地址：https://github.com/Haohao-end/openagent
• 官网：https://openllm.cloud
• API 文档：https://s.apifox.cn/c76bd530-fd50-429c-94cc-f0e41c2675d1/api-305434417
• DeepWiki: https://deepwiki.com/Haohao-end/openagent

鸣谢

• 感谢 Atlas Cloud 和 Bloome 为 OpenAgent 提供支持。
• 感谢 Rui Yang 和 Haoyu Wang（Johns Hopkins University）以负责任披露的方式报告了内置工具图标 URL 构造中的 Host Header poisoning 问题，帮助项目进一步改进安全性。
• 感谢 Ryan B 以负责任披露的方式报告了自定义 API 工具服务端 URL 中的 SSRF 漏洞，帮助项目改进出站请求的安全性。

(返回顶部)