5分钟快速上手Yuxi智能知识库平台：企业级AI助手部署指南

5分钟快速上手Yuxi智能知识库平台：企业级AI助手部署指南

【免费下载链接】Yuxi结合知识库、知识图谱管理的 多租户 Agent Harness 平台。 An agent harness that integrates a LightRAG knowledge base and knowledge graphs. Build with LangChain + Vue + FastAPI, support DeepAgents、MinerU PDF、Neo4j 、MCP.项目地址: https://gitcode.com/GitHub_Trending/yu/Yuxi

Yuxi（语析）是一款集智能知识库、知识图谱与多智能体编排于一体的企业级AI开发平台，支持多租户管理和RAG检索技术。无论你是技术新手还是企业开发者，都能在5分钟内完成部署，快速构建自己的智能问答系统。本指南将带你从零开始，掌握Yuxi智能知识库平台的一键安装、核心功能配置和最佳实践。

🚀 项目亮点：为什么选择Yuxi？

Yuxi智能知识库平台将知识图谱管理、多智能体编排和企业级RAG检索完美融合，为企业提供开箱即用的AI解决方案：

📦 环境准备：一键安装前检查

系统要求

• 操作系统：Linux、macOS、Windows（WSL2）
• Docker：版本20.10+
• Docker Compose：版本2.0+
• 硬件：建议4GB+内存，10GB+磁盘空间
• 网络：稳定的互联网连接（用于拉取镜像）

必备工具安装

如果你的系统还没有安装Docker和Docker Compose，请先执行以下命令：

# Ubuntu/Debian系统 sudo apt update && sudo apt install docker.io docker-compose -y # macOS系统（使用Homebrew） brew install docker docker-compose # 验证安装 docker --version docker-compose --version

🛠️ 一键安装教程：5分钟完成部署

步骤1：获取项目代码

使用以下命令克隆Yuxi智能知识库平台的最新稳定版本：

git clone --branch v0.7.1.beta2 --depth 1 https://gitcode.com/GitHub_Trending/yu/Yuxi cd Yuxi

💡提示：--depth 1参数只下载最新版本代码，节省时间和磁盘空间。

步骤2：自动环境配置

Yuxi提供了智能初始化脚本，自动完成所有配置：

# Linux/macOS系统 ./scripts/init.sh # Windows PowerShell .\scripts\init.ps1

脚本会引导你完成：

1. 创建环境配置文件
2. 配置大模型API密钥（必需）
3. 设置搜索服务API密钥（可选）
4. 自动拉取Docker镜像

步骤3：启动所有服务

一条命令启动完整的Yuxi智能知识库平台：

docker compose up --build -d

首次启动需要2-3分钟构建时间，请耐心等待。你可以通过以下命令监控启动进度：

# 查看所有容器状态 docker ps # 实时查看后端日志 docker logs api-dev -f

步骤4：访问系统

服务启动成功后，打开浏览器访问：

首次访问时，系统会要求设置超级管理员账号和密码，请妥善保管。

🎯 核心功能快速上手

1. 智能体配置与对话

Yuxi智能知识库平台提供了直观的智能体配置界面，支持多种大模型接入：

智能体配置界面展示了AI助手的完整配置选项，包括系统提示词设置、模型选择和工具配置。左侧是对话历史管理，中间是实时对话区域，右侧是详细的配置面板。

基础配置示例：

# 在系统配置中设置默认模型 model_provider: siliconflow model_name: deepseek-ai/DeepSeek-V3.2 temperature: 0.7 max_tokens: 4096

2. 知识图谱可视化

Yuxi集成了Neo4j图数据库，支持知识图谱的构建和可视化查询：

知识图谱可视化界面展示了实体关系的网络结构，左侧显示数据库统计信息，中间是交互式图谱展示，右侧是节点详情面板，支持Cypher查询语言进行数据检索。

3. 知识库管理

Yuxi智能知识库平台支持多种文档格式的上传和管理：

# 通过CLI工具上传文档到知识库 python -m yuxi_cli kb_upload \ --kb-name "企业文档库" \ --file-path ./docs/ \ --chunk-size 500

支持的文件格式：

• 📄 PDF文档
• 📝 Word文档（.docx）
• 📊 Excel表格（.xlsx）
• 📋 PowerPoint演示文稿（.pptx）
• 📄 纯文本文件（.txt, .md）
• 🌐 网页内容

⚙️ 进阶配置：个性化定制

模型提供商配置

Yuxi智能知识库平台支持多种大模型提供商，根据你的需求灵活选择：

# 编辑配置文件 vim backend/package/yuxi/config/user.py # 配置多个模型提供商 MODEL_PROVIDERS = { "siliconflow": { "api_key": "你的硅基流动API密钥", "base_url": "https://api.siliconflow.cn/v1" }, "openai": { "api_key": "你的OpenAI API密钥", "base_url": "https://api.openai.com/v1" }, "deepseek": { "api_key": "你的DeepSeek API密钥", "base_url": "https://api.deepseek.com" } }

知识库优化配置

针对不同的使用场景，可以调整知识库参数：

# 知识库配置示例 knowledge_base: chunking_strategy: "semantic" # 语义分块 chunk_size: 512 # 分块大小 chunk_overlap: 50 # 重叠长度 embedding_model: "bge-large-zh" # 向量化模型 retrieval_top_k: 5 # 检索数量

🔧 常见问题排查

问题1：Docker镜像拉取失败

如果遇到网络问题导致镜像拉取失败：

# 使用国内镜像源 export DOCKER_REGISTRY_MIRROR=https://docker.mirrors.ustc.edu.cn docker compose pull # 或手动拉取关键镜像 bash scripts/pull_image.sh python:3.13-slim

问题2：服务启动超时

检查端口占用和服务依赖：

# 检查端口占用 netstat -tulpn | grep -E '5173|5050' # 重启特定服务 docker compose restart api-dev web-dev

问题3：API密钥配置错误

验证API密钥配置：

# 检查环境变量 cat .env | grep API_KEY # 测试API连接 curl -X POST http://localhost:5050/api/v1/models/test \ -H "Content-Type: application/json" \ -d '{"provider": "siliconflow"}'

🚀 最佳实践建议

1. 生产环境部署

# 使用生产环境配置 cp docker-compose.prod.yml docker-compose.yml docker compose up -d # 配置Nginx反向代理 # 参考配置：docs/advanced/deployment.md

2. 性能优化

• 轻量模式：如果不需要知识图谱功能，使用make up-lite启动
• 缓存配置：合理配置Redis缓存策略
• 数据库优化：根据数据量调整PostgreSQL参数

3. 安全加固

• 修改默认管理员密码
• 配置HTTPS证书
• 设置防火墙规则
• 定期备份数据

📚 深入学习资源

官方文档

• 快速开始：docs/intro/quick-start.md
• 模型配置：docs/intro/model-config.md
• 知识库管理：docs/intro/knowledge-base.md
• 智能体开发：docs/agents/agents-config.md

核心源码目录

• 后端核心：backend/package/yuxi/
• 前端界面：web/src/
• 配置示例：backend/package/yuxi/config/

社区支持

• 查看项目更新日志：docs/develop-guides/changelog.md
• 学习开发指南：docs/develop-guides/contributing.md
• 了解架构设计：ARCHITECTURE.md

🎉 开始你的智能知识库之旅

通过本指南，你已经成功部署了Yuxi智能知识库平台，并了解了核心功能的使用方法。接下来你可以：

1. 上传企业文档：将公司手册、产品文档导入知识库
2. 构建知识图谱：建立业务实体之间的关系网络
3. 配置智能体：创建专属的AI助手
4. 集成业务系统：通过API与其他系统对接

Yuxi智能知识库平台的开源特性让你可以根据业务需求自由定制，无论是中小企业知识管理，还是大型企业的AI应用开发，都能找到合适的解决方案。立即开始你的智能知识库建设之旅吧！

💡提示：遇到问题时，可以参考故障排除章节，或查阅项目文档获取更多帮助。

【免费下载链接】Yuxi结合知识库、知识图谱管理的 多租户 Agent Harness 平台。 An agent harness that integrates a LightRAG knowledge base and knowledge graphs. Build with LangChain + Vue + FastAPI, support DeepAgents、MinerU PDF、Neo4j 、MCP.项目地址: https://gitcode.com/GitHub_Trending/yu/Yuxi