ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Yuxi 知识智能体:从 git clone 到首次企业问答只要10分钟

Yuxi 知识智能体:从 git clone 到首次企业问答只要10分钟 Yuxi 知识智能体从 git clone 到首次企业问答只要10分钟【免费下载链接】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内部产品手册、新人文档、工单记录散落在各处同一个问题被反复问而数据又不敢丢给外部 SaaS。Yuxi 是一个可私有部署的多租户知识智能体平台把知识库检索、知识图谱把文档里的实体和关系画成可查询的图和多智能体编排放进你自己的服务器里让每个团队成员拥有一个可控的 AI 助手。跑起来一条命令流走完全部部署前置只需要一样东西装好 Docker 和 Docker Compose 的机器外加一个能用的大模型 API Key官方默认以 SiliconFlow 为例。先克隆仓库只拉 v0.7.3 这一个版本然后把初始化脚本跑起来。脚本会现场创建.env向你索要模型 API Key自动生成 JWT、API Key 派生、沙盒管理三个互不相同的安全密钥并顺手把开发环境的基础镜像拉好省掉手动抄模板文件的过程git clone --branch v0.7.3 --depth 1 https://gitcode.com/GitHub_Trending/yu/Yuxi cd Yuxi ./scripts/init.shWindows 上则用 PowerShell 执行.\scripts\init.ps1。初始化完成后一条 compose 命令同时拉起 Web 前端、API、任务 worker、沙盒管理服务以及 PostgreSQL、Redis、Milvus、Neo4j、MinIO 五个存储与图数据库服务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。第一次看到效果初始化管理员发出第一条消息首次打开 Web 界面时页面会提示初始化超级管理员账号。设置账号密码登录后你落到的是智能体工作台左侧是对话历史中间是实时回答区右侧是配置面板。随便问一句“介绍一下 Yuxi 平台是做什么的”回答会流式吐出来旁边能看到工具调用状态和 Token 消耗——模型接入和整条智能体链路都通了。你看到的是登录页使用的背景图完成超级管理员初始化后登录后直接进入上面这套工作台界面。它能干什么三个场景走一遍把团队文档变成可对话的知识源在“知识库”页新建一个 Milvus 类型知识库Milvus 是向量数据库存文档切块后的向量表示上传产品手册勾选“上传后自动入库”等文件状态变成indexed就代表分块和向量索引都完成了。打开“检索测试”问一个只有这份文档能答上的问题——返回的片段带文件来源和file_id说明命中来自你的文档而不是模型常识。再把知识库挂到智能体上对话里用就能引用它从此产品文档可以被直接提问。从文档关系里挖出隐性关联文档入库后系统会从文档块里抽取实体和关系写入 Neo4j这些关系随后也参与检索。图谱页可以浏览子图、点节点看详情想直接写 Cypher 查询的话Neo4j Browser 在 localhost:7474 开着自己连上去查。适合用它做产品间关联、人员与项目的交叉分析这类“文档里没写但存在”的关系挖掘。让智能体在沙盒里跑长任务、交付文件除了问答智能体还能执行多步骤任务拆解步骤、调用工具、生成文件产出可预览、可下载的产物。执行发生在隔离沙盒里一次性容器文件系统与主服务隔开遇到修改文件、调外部高危接口这类操作会弹出人工审批卡片点确认才继续。需要更强能力时可以通过 Skills 和 MCP一种把工具接给大模型的协议给它加技能和外接工具复杂任务还能拆给子智能体并行跑。按需调参如果你想换模型模型提供商、聊天、嵌入和重排模型都能在“模型管理”页面切换初始化时默认以 SiliconFlow 为例也可以复制.env.template手动改用其他受支持的提供商。如果你要解析扫描件或复杂排版默认拓扑不含 OCR 服务MinerU 和 PP-Structure-V3 都需要 GPU按需通过allprofile 启动详见 docs/advanced/document-processing.md。如果你要上生产改用docker-compose.prod.yml默认只暴露 Web 入口数据库管理端口不对外。从 v0.7.1 或 v0.7.2 升级不能直接docker compose up先按 docs/advanced/deployment.md 做备份和迁移。如果你要确认端口开发环境 Web 走 5173、API 走 5050、Neo4j 走 7474全部端口清单在 docs/advanced/ports.md。踩坑速查容器迟迟不 healthy原因storage-migrator是一次性服务跑完数据迁移就退出API 和 worker 必须等它成功这个“退出”本身是正常状态。诊断docker compose logs --tail100 storage-migrator api worker sandbox-provisioner。处理确认迁移器是成功结束还是报错报错就按日志修掉后再拉起依赖服务。镜像拉取失败或离线环境原因机器访问不了镜像仓库。诊断docker compose ps看卡在哪个镜像。处理单个补拉用bash scripts/pull_image.sh python:3.13-slim完全离线就用 docker/save_docker_images.sh 在有网机器导出镜像包再docker load进目标机。知识库检索没结果、依赖服务异常原因默认拓扑依赖 Milvus、etcd、MinIO、Neo4j 四个组件任一没起来检索就不可用。诊断docker compose ps milvus etcd minio graph加docker compose logs --tail100看对应日志。处理把 unhealthy 的那个组件修好再docker compose up -d恢复启动。延伸docs/intro/quick-start.md完整快速开始加官方 FAQ部署后按顺序过一遍。docs/intro/knowledge-base.md文档入库、文件状态机、检索验证的完整步骤第一个知识库就照它做。docs/agents/agents-config.md接手智能体、工具、Skills 和 MCP 配置的人看。docs/advanced/deployment.md准备生产部署、升级和备份前必读。packages/yuxi-cli/ 和 backend/package/yuxi/前者是命令行工具的源码适合想不离开终端管理实例的人后者是后端核心适合读代码的人。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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表