Yuxi

Yuxi = Cloud Agents + Knowledge RAG，Yuxi 是一个可私有部署的多租户知识智能体平台。自定义智能体，权限可控，沉淀企业轨迹。它把知识库检索、知识图谱、LangGraph 多智能体编排、MCP/Skills、沙盒工具和权限管理放进同一个工作区。让每个用户都拥有一个云端 Codex。

项目主页 · 快速开始 · 演示视频 · 版本记录 · English

Yuxi 能做什么

Yuxi 是面向需要企业自部署的多用户 Agent 产品，且需要自己掌握数据、模型和权限的团队：

• 二开友好：MIT 协议、代码简洁、可拓展性强、高并发部署友好。
• Harness：功能完善的云端多用户 Harness，自定义智能体，沉淀企业轨迹。
• Knowledge： 高效、精准的 Agentic RAG 套件，上传文档，解析、分块和向量索引。
• 执行多步骤任务：组合工具、MCP、Skills、子智能体和沙盒，产出可预览、可下载的文件。
• 连接知识图谱：从 Milvus 知识库的文档块中抽取实体和关系，写入 Neo4j 并参与检索。
• 管理团队使用范围：按用户、部门和共享范围管理知识库、智能体、Skills 和模型。
• 对比运行质量：评估知识库的检索结果，也可以用 Langfuse Dataset 评估完整智能体任务。

赞助商

赞助商	介绍
	Fluxion AI面向个人开发者、技术团队与企业，通过统一API接入并管理全球主流AI模型；通过多线路动态调度提升可用性，模型表现、响应时间与费用透明可查。根据不同模型与线路，API调用成本较官方或基准价格可降低40%—98%。专属链接注册 获 $7 API 额度

快速启动

语析（Yuxi）完全基于 Docker 启动，服务和中间件主要包括：LangGraph、Vue、FastAPI、Milvus、Neo4j、PostgreSQL、MinerU、PaddleOCR。

前置条件

安装 Docker Engine 和 Docker Compose，并准备一个可用的大模型 API。当前仓库默认配置对应 v0.7.3。

1. 获取代码并初始化

git clone --branch v0.7.3 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi

# Linux/macOS
./scripts/init.sh

# Windows PowerShell
.\scripts\init.ps1

初始化脚本会创建 .env、读取 SiliconFlow API Key，并为 JWT、API Key 派生和 Sandbox provisioner 生成独立的安全密钥。也可以手动复制 .env.template 并填写这些值。

2. 启动开发环境

docker compose up --build -d

查看服务状态：

docker compose ps
curl --fail http://localhost:5050/api/system/ready

返回的 status 为 ready 后，打开 http://localhost:5173，按页面提示初始化超级管理员并登录。API 文档位于 http://localhost:5050/docs。

从 v0.7.1 或 v0.7.2 升级到当前版本时，不能直接执行 docker compose up。请先阅读生产部署与升级，在停机窗口完成备份和迁移。

文档导航

• 项目介绍：了解能力、概念和系统边界。
• 快速开始：从零启动本地环境。
• 模型配置：接入聊天、嵌入和重排模型。
• 知识库教程：创建知识库并验证检索。
• 智能体开发：配置 Agent、工具和扩展。
• 生产部署：部署、升级、备份和排障。
• 版本变更记录：查看已发布变更。

能力展示

Yuxi 把知识进入系统、Agent 执行任务和团队治理放在一条完整链路中。以下按六个核心模块介绍系统能力：

模块	解决的问题	代表能力
统一智能体工作台	在一个界面完成提问、执行与交付	多轮对话、知识库检索、任务状态、人工审批
知识库与 RAG	为回答提供检索内容	多格式入库、Embedding/Rerank、检索测试、RAG 评估
知识图谱与知识导图	发现实体关系并浏览知识库文件结构	图谱构建、子图浏览、节点详情、文件元数据导图
多智能体与扩展生态	把复杂任务拆给不同角色和工具	SubAgents、Skills、MCP、Tools、Agent 配置
沙盒工作区与产物	把对话结果变成可继续使用的文件	隔离文件系统、文件生成、在线预览、下载
团队治理与运行管理	在多人环境中管理能力、权限和运行状态	多租户、用户与部门权限、模型配置、API Key、Dashboard

01 · 统一智能体工作台

用户可以在同一个对话界面里引用知识库文档、个人文件或扩展 Skill；查看任务执行状态，并在对话中获取回答或生成的文件。

• 支持使用 @ 快速引入知识库、文件与特定 Skill。
• 展示任务拆解步骤、工具调用状态与上下文 Token 消耗。
• 支持预览和下载生成的文件产物。