从一次请求到五个存储组件Yuxi语析多租户知识智能体平台部署与架构解读【免费下载链接】Yuxi可私有部署的多租户知识智能体平台统一 RAG、知识图谱、多智能体、MCP/Skills、沙盒与权限管理。Yuxi Cloud Agents Knowledge RAG, Self-hosted knowledge agent platform for RAG, knowledge graphs and multi-agent workflows.项目地址: https://gitcode.com/GitHub_Trending/yu/Yuxi想让企业文档进模型、让智能体检索、分析并产出文件、再按部门划分数据与权限Yuxi语析就是为这类需求准备的。平台本身可私有部署、面向多租户目标用户是需要自管数据、模型和权限的团队。一套 Docker Compose 文件就能拉起从知识库到沙盒的完整拓扑。01 先弄懂三个概念智能体、知识库、工作区整个平台围着三个名词转先读它们后面看文档不卡壳。智能体自己拼装出来的运行单元智能体是 Yuxi 的基本运行单元由模型、提示词、工具、知识库、Skills、MCP 和子智能体拼成。代码骨架是backend/package/yuxi/agents/base.py里的BaseAgentcontext_schema声明可配置字段get_graph()返回编译后的 LangGraph 图。内置ChatbotAgent负责普通对话SubAgentBackend承接主智能体委派的子任务。知识库让文档可检索、可溯源知识库保存文档承担解析、分块、向量检索和来源信息。backend/package/yuxi/knowledge/implementations/下有四个实现Milvus 支持在 Yuxi 内完成上传、解析、索引全链路还能构建知识图谱Dify 与 Notion 是只读连接器复用已有数据集不能在 Yuxi 内上传或索引文档。Workdir所有入口看到同一份文件Workdir 是一个 Project 在用户工作区里的持久目录。智能体文件操作、文件查看器、交付物接口读到的都是同一份文件字节。路径映射和文件原语集中在backend/package/yuxi/workspace/paths.py负责持久路径映射filesystem.py提供 no-follow 文件原语workdir.py给出以 Project 为根的持久化视图。02 什么团队该考虑 Yuxi团队只要沾上下面三条Yuxi 就值得评估文档不能交给外部 SaaS数据要自己管组织规模较大权限要按部门切分任务不止一问一答而是多步执行。数据自管文档进自己的知识库检索结果带命中文本和文件来源可回溯。权限分部门知识库、智能体、扩展能力在用户、部门、管理员之间划分可见与管理范围。多步任务智能体调用搜索、MCP、Skills、子智能体和沙盒工具完成调研、分析与文件产出。边界同样清楚如果只需要一个不带权限和文件操作的单文档聊天页面Yuxi 的能力偏多。它是面向团队协作与数据治理的平台不是聊天封装。03 用户实际能做什么能力按“界面上能干什么”来分不按后端模块罗列。问答与检索文档入知识库后检索返回命中文本加文件来源。RAG检索增强生成即先查文档库、再让模型基于结果作答在这条链路上完整可用。Milvus 知识库还能从已索引的文档块抽取实体和关系写入 Neo4j查询时把图谱结果与文本块结果融合。多步任务管理员配置模型、系统提示词、工具、MCP、Skills、子智能体和上下文压缩策略智能体由 LangGraph 驱动。执行中可以读写 Workdir 文件、执行沙盒命令、搜索网页、请求用户审批或委派子智能体产出的文件支持界面内预览和下载。耗时任务交给独立 worker进度用 SSEServer-Sent Events服务端向浏览器单向推送事件流回传。质量评估知识库检索效果与智能体任务表现都能量化评估版本改动前后可以拿数据对比。团队治理用户、部门、共享范围、模型供应商、API Key 各有管理入口。前端的隐藏入口只改善体验最终授权以后端接口与数据查询处的检查为准这条原则贯穿全系统。04 一次请求的旅程从浏览器到 worker 一次普通智能体请求走这条链路Web / CLI / 外部 API ↓ FastAPI 收下请求Message 与 Request 落库 ↓ PostgreSQL 提交之后 Redis / ARQ 把 AgentRun 投出去 ↓ Worker 执行 LangGraph写出运行事件与最终结果 ↓ 前端经 SSE 消费过程状态与结果在 PostgreSQL 收口这里有一条硬规矩消息和请求在同一数据库事务里创建提交成功后才向 ARQ 投递 Run。队列消息不能先于数据库状态可见。该不变量写在ARCHITECTURE.md由submit_agent_request与agent_request_queue_service的 FIFO 派发共同保证。各存储组件的分工一目了然组件职责PostgreSQL业务状态、知识库元数据、请求队列、LangGraph checkpoint智能体运行快照RedisARQ 任务投递、短期运行事件、取消信号、跨进程缓存MinIO附件、知识库原始文件等对象数据Milvus向量检索Neo4j可选的知识图谱存储Redis 只放短期事件不放历史运行终态一律落 PostgreSQL前端断线恢复也按数据库状态补偿。05 三条命令跑起开发环境 Docker Compose 是开发环境的事实来源。docker-compose.yml的默认拓扑包含api、worker、storage-migrator、sandbox-provisioner、web、graphNeo4j、etcd、minio、milvus、postgres、redismineru-api与paddlex是文档解析/OCR 服务走allprofile 按需启动需要 GPU。沙盒经sandbox-provisioner接入为智能体提供隔离容器环境让它安全地执行命令与文件操作底层运行时可选 Docker 或 Kubernetes 后端。memory后端仅供测试没有真实隔离生产必须用真沙盒。数据库 Schema 的修改权只给一个进程storage-migrator一次性跑完即退出。API 与 worker 等它成功、校验版本匹配后才启动自身不建表、不执行 DDL。启动命令Linux/macOSWindows 改用.\scripts\init.ps1git clone --branch v0.7.3 --depth 1 https://gitcode.com/GitHub_Trending/yu/Yuxi cd Yuxi ./scripts/init.sh # 生成 .env读取模型 API Key、生成独立安全密钥 docker compose up --build -d curl --fail http://localhost:5050/api/system/ready最后一条返回status为ready后打开http://localhost:5173初始化超级管理员并登录API 文档在http://localhost:5050/docs。06 技术栈怎么搭、取舍在哪技术选型以成熟开源组件为主真正的工程取舍体现在目录边界上。层技术职责前端Vue 3、Vite、Pinia工作区、配置界面、实时运行展示API 与运行时FastAPI、LangGraph、ARQ请求接入、智能体编排、后台执行持久化PostgreSQL业务状态、知识库元数据、checkpoint缓存与事件Redis投递、短期事件、取消、缓存对象与检索MinIO、Milvus、Neo4j文件对象、向量索引、知识图谱文档处理MinerU、PaddleX、RapidOCR 等文档解析、版面分析、OCR部署Docker Compose开发与单机部署拓扑后端划成两个顶层边界backend/server是 Web 入口与 HTTP 适配层路由保持薄只处理请求模型、认证上下文和响应装配backend/package/yuxi是业务与基础设施主体新增领域逻辑优先落在这里。改动该进哪一层看这个划分就不会错。07 边界划在哪许可怎么说Yuxi 不假装自己是轻量聊天工具定位是团队协作与数据治理平台轻量单文档需求有更简单的方案可选。许可方面Yuxi 本体采用 MIT LicenseCompose 引入的第三方组件如 Milvus、Neo4j 镜像遵循各自许可证。生产部署和再分发之前按实际镜像版本核对上游许可与源码义务生产部署章节有专门说明。08 值得收藏的文档入口 读完正文后按下面入口继续挖docs/intro/quick-start.md启动一套可用开发环境含前置准备与常见问题。docs/intro/model-config.md接入聊天、嵌入和重排模型。docs/intro/knowledge-base.md创建知识库、让智能体检索文档并构建图谱。docs/agents/agents-config.md查看各配置字段如何进入运行时。docs/mechanisms/index.md深入沙盒、上下文压缩与知识库链路。docs/advanced/deployment.md生产部署、备份迁移与再分发边界。【免费下载链接】Yuxi可私有部署的多租户知识智能体平台统一 RAG、知识图谱、多智能体、MCP/Skills、沙盒与权限管理。Yuxi Cloud Agents Knowledge RAG, Self-hosted knowledge agent platform for RAG, knowledge graphs and multi-agent workflows.项目地址: https://gitcode.com/GitHub_Trending/yu/Yuxi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考