From 5178e97c1fb714700d57cb980a39aa3c9fd12ab5 Mon Sep 17 00:00:00 2001 From: ylzhangah <1194926515@qq.com> Date: Fri, 13 Jun 2025 10:35:24 +0800 Subject: [PATCH 1/3] update version and fix a bug with deploy k3s --- .../scripts/2-install-tools/install_tools.sh | 46 ++----------------- ...50\347\275\262\346\214\207\345\215\227.md" | 6 +-- ...50\347\275\262\346\214\207\345\215\227.md" | 2 +- 3 files changed, 7 insertions(+), 47 deletions(-) diff --git a/deploy/scripts/2-install-tools/install_tools.sh b/deploy/scripts/2-install-tools/install_tools.sh index 8a80dd0e..f60e1f3e 100755 --- a/deploy/scripts/2-install-tools/install_tools.sh +++ b/deploy/scripts/2-install-tools/install_tools.sh @@ -106,7 +106,7 @@ install_basic_tools() { yum install -y tar vim curl wget python3 # 检查 pip 是否已安装 - if ! command -v pip3 &> /dev/null; then + if ! command -v pip &> /dev/null; then echo -e "pip could not be found, installing python3-pip..." yum install -y python3-pip else @@ -317,47 +317,6 @@ function install_helm { return 0 } -function set_kubeconfig() { - local k3s_config="/etc/rancher/k3s/k3s.yaml" - local bashrc_file="$HOME/.bashrc" - local kubeconfig_line="export KUBECONFIG=$k3s_config" - - # 检查 k3s.yaml 是否存在 - if [ ! -f "$k3s_config" ]; then - echo -e "\033[31m[Error] k3s.yaml 文件不存在，请先安装 k3s 或检查路径：$k3s_config\033[0m" - return 1 - fi - - # 检查文件权限（至少需要可读权限） - if [ ! -r "$k3s_config" ]; then - echo -e "\033[33m[Warn] k3s.yaml 文件不可读，尝试修复权限...\033[0m" - sudo chmod 644 "$k3s_config" || { - echo -e "\033[31m[Error] 权限修复失败，请手动执行：sudo chmod 644 $k3s_config\033[0m" - return 1 - } - fi - - # 检查并更新 .bashrc（兼容 root 和普通用户） - if ! grep -Fxq "$kubeconfig_line" "$bashrc_file"; then - echo "$kubeconfig_line" | tee -a "$bashrc_file" >/dev/null - echo -e "\033[32m[Success] KUBECONFIG 已写入 $bashrc_file\033[0m" - else - echo -e "\033[34m[Info] KUBECONFIG 已存在，无需修改\033[0m" - fi - - # 设置当前 Shell 环境变量 - export KUBECONFIG="$k3s_config" - echo -e "\033[33m[Tips] 当前会话已临时生效，永久生效需重新登录或执行：source $bashrc_file\033[0m" - - # 验证集群连通性 - if ! kubectl cluster-info &>/dev/null; then - echo -e "\033[31m[Critical] 集群连接失败，可能原因：\033[0m" - echo -e "1. Kubernetes 未运行 → 执行: sudo systemctl status k3s" - echo -e "2. API 地址配置错误 → 检查 $k3s_config 中的 server 字段" - echo -e "3. 防火墙阻止连接 → 检查端口 6443 是否开放" - return 1 - fi -} function check_k3s_status() { local STATUS=$(systemctl is-active k3s) @@ -411,8 +370,9 @@ function main { else echo -e "[Info] Helm 已经安装，跳过安装步骤" fi + mkdir -p ~/.kube + ln -sf /etc/rancher/k3s/k3s.yaml ~/.kube/config check_k3s_status - set_kubeconfig echo -e "\n\033[32m=== 全部工具安装完成 ===\033[0m" echo -e "K3s 版本：$(k3s --version | head -n1)" diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 760074ba..5bc7b863 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -1,7 +1,7 @@ # **openEuler Intelligence 智能助手部署指南** 版本信息 -当前版本：v0.9.5 +当前版本：v0.9.6 更新日期：2025年4月25日 ## 产品概述 @@ -82,7 +82,7 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen | 类型 | 资源文件/说明 | |------------|--------------| -| **镜像文件** | `hub.oepkgs.net/neocopilot/euler-copilot-framework:0.9.5-x86`
`hub.oepkgs.net/neocopilot/euler-copilot-web:0.9.5-x86`
`hub.oepkgs.net/neocopilot/data_chain_back_end:0.9.5-x86`
`hub.oepkgs.net/neocopilot/data_chain_web:0.9.5-x86`
`hub.oepkgs.net/neocopilot/authhub:0.9.3-x86`
`hub.oepkgs.net/neocopilot/authhub-web:0.9.3-x86`
`hub.oepkgs.net/neocopilot/opengauss:latest-x86`
`hub.oepkgs.net/neocopilot/redis:7.4-alpine-x86`
`hub.oepkgs.net/neocopilot/mysql:8-x86`
`hub.oepkgs.net/neocopilot/minio:empty-x86`
`hub.oepkgs.net/neocopilot/mongo:7.0.16-x86`
`hub.oepkgs.net/neocopilot/secret_inject:dev-x86`
| +| **镜像文件** | `hub.oepkgs.net/neocopilot/euler-copilot-framework:0.9.6-x86`
`hub.oepkgs.net/neocopilot/euler-copilot-web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_back_end:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/authhub:0.9.3-x86`
`hub.oepkgs.net/neocopilot/authhub-web:0.9.3-x86`
`hub.oepkgs.net/neocopilot/opengauss:latest-x86`
`hub.oepkgs.net/neocopilot/redis:7.4-alpine-x86`
`hub.oepkgs.net/neocopilot/mysql:8-x86`
`hub.oepkgs.net/neocopilot/minio:empty-x86`
`hub.oepkgs.net/neocopilot/mongo:7.0.16-x86`
`hub.oepkgs.net/neocopilot/secret_inject:dev-x86`
| | **模型文件** | `bge-m3-Q4_K_M.gguf`
`deepseek-llm-7b-chat-Q4_K_M.gguf`
| | **工具包** | `helm-v3.15.0-linux-{arm64/amd64}.tar.gz`
`k3s-airgap-images-{arm64/amd64}.tar.zst`
`k3s-{arm64/amd64}`
`k3s-install.sh`
`ollama-linux-{arm64/amd64}.tgz` | @@ -92,7 +92,7 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen ```bash # 在联网服务器执行： cd /home/euler-copilot-framework/deploy/scripts/9-other-script/ -./save_images.sh 0.9.5 # 版本号可替换，镜像将保存至 /home/eulercopilot/images/ +./save_images.sh 0.9.6 # 版本号可替换，镜像将保存至 /home/eulercopilot/images/ # 传输至目标服务器： scp /home/eulercopilot/images/* root@target-server:/home/eulercopilot/images/ diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 8adea71a..331c75eb 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -1,7 +1,7 @@ # **openEuler Intelligence 智能助手部署指南** 版本信息 -当前版本：v0.9.5 +当前版本：v0.9.6 更新日期：2025年4月25日 ## 产品概述 -- Gitee From e54f041639a3273eb685e8d809c6fd1a8244ab3d Mon Sep 17 00:00:00 2001 From: ylzhangah <1194926515@qq.com> Date: Fri, 13 Jun 2025 15:22:20 +0800 Subject: [PATCH 2/3] update file --- ...50\347\275\262\346\214\207\345\215\227.md" | 55 +++++++++--------- ...50\347\275\262\346\214\207\345\215\227.md" | 58 +++++++++---------- 2 files changed, 56 insertions(+), 57 deletions(-) diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 5bc7b863..04f602fa 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -2,7 +2,7 @@ 版本信息 当前版本：v0.9.6 -更新日期：2025年4月25日 +更新日期：2025年6月13日 ## 产品概述 @@ -21,29 +21,28 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen | authhub-web-service | 8000 | 鉴权服务前端 | | mysql | 3306 (内部端口) | MySQL数据库 | | redis | 6379 (内部端口) | Redis数据缓存 | -| minio | 9000 (内部端口) 9001(外部部端口) | minio对象存储库 | +| minio | 9000 (内部端口) 9001(外部部端口) | minio对象存储库 | | mongo | 27017 (内部端口) | mongo数据库 | | openGauss | 5432 (内部端口) | 向量数据库 | | secret_inject | 无 | 配置文件安全复制工具 | ### 软件要求 -| 类型 | 版本要求 | 说明 | -|----------------| -------------------------------------|--------------------------------------| -| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | -| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | +| 类型 | 版本要求 | 说明 | +|----- | ----------|------| +| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | +| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | | Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | | python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | --- ### 硬件规格 -| 硬件资源 | 最小配置 | 推荐配置 | +| 硬件资源 | 最小配置 | 推荐配置 | |--------------|----------------------------|------------------------------| -| CPU | 4 核心 | 16 核心及以上 | -| RAM | 4 GB | 64 GB | -| 存储 | 32 GB | 64G | -| 大模型名称 | deepseek-llm-7b-chat | DeepSeek-R1-Llama-8B -| 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | - +| CPU | 4 核心 | 16 核心及以上 | +| RAM | 4 GB | 64 GB | +| 存储 | 32 GB | 64G | +| 大模型名称 | qwen2.5-14B | qwen2.5-32B | +| 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | **关键说明**： - 纯CPU环境，建议通过调用 OpenAI 接口或使用自带的模型部署方式来实现功能。 @@ -211,7 +210,7 @@ sudo ./deploy.sh - 资源不足时可参考 FAQ 中的评估资源可用性解决 - 查看组件日志 ```bash -kubectl logs -n euler-copilot +kubectl logs $pod名称 -n euler-copilot ``` - 查看服务状态 ```bash @@ -230,7 +229,7 @@ helm upgrade euler-copilot -n euler-copilot . ## 验证安装 -恭喜您，**openEuler Intelligence** 已成功部署！为了开始您的体验，请在浏览器中输入 `https://您的openEuler Intelligence域名` 链接访问 openEuler Intelligence 的网页界面： +恭喜您，**openEuler Intelligence** 已成功部署！为了开始您的体验，请在浏览器中输入 链接访问 openEuler Intelligence 的网页界面： 首次访问时，您需要点击页面上的 **立即注册** 按钮来创建一个新的账号，并完成登录过程。 @@ -358,37 +357,37 @@ helm upgrade euler-copilot -n euler-copilot . # 用于问答的大模型；需要为OpenAI兼容接口 answer: # [必填] 接口URL（无需带上“v1”后缀） - url: http://$IP:11434 + endpoint: http://172.168.XXX.XX:11434 # [必填] 接口API Key；默认置空 key: sk-123456 # [必填] 模型名称 name: deepseek-llm-7b-chat:latest # [必填] 模型最大上下文数；建议>=8192 - ctx_length: 8192 + ctxLength: 8192 # 模型最大输出长度，建议>=2048 - max_tokens: 2048 - # 用于Function Call的模型；建议使用特定推理框架 - functioncall: + maxTokens: 2048 + # 用于Function Call的模型；建议使用特定推理框架 + functionCall: # 推理框架类型，默认为ollama # 可用的框架类型：["vllm", "sglang", "ollama", "openai"] - backend: + backend: ollama # 模型地址；不填则与问答模型一致 - url: ollama + endpoint: # API Key；不填则与问答模型一致 - key: + key: # 模型名称；不填则与问答模型一致 - name: + name: # 模型最大上下文数；不填则与问答模型一致 - ctx_length: + ctxLength: 8192 # 模型最大输出长度；不填则与问答模型一致 - max_tokens: - # 用于数据向量化（Embedding）的模型 + maxTokens: 8192 + # 用于数据向量化（Embedding）的模型 embedding: # 推理框架类型，默认为openai # [必填] Embedding接口类型：["openai", "mindie"] type: openai # [必填] Embedding URL（需要带上“v1”后缀） - url: http://172.168.178.107:11434 + endpoint: http://172.168.XXX.XX:11434/v1 # [必填] Embedding 模型API Key key: sk-123456 # [必填] Embedding 模型名称 diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 331c75eb..9fd977bb 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -2,7 +2,7 @@ 版本信息 当前版本：v0.9.6 -更新日期：2025年4月25日 +更新日期：2025年6月13日 ## 产品概述 @@ -12,37 +12,37 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen ### 组件介绍 -| 组件 | 端口 | 说明 | + 组件 | 端口 | 说明 | | ----------------------------- | --------------- | -------------------- | | euler-copilot-framework | 8002 (内部端口) | 智能体框架服务 | | euler-copilot-web | 8080 | 智能体前端界面 | | euler-copilot-rag | 9988 (内部端口) | 检索增强服务 | | authhub-backend-service | 11120 (内部端口) | 鉴权服务后端 | | authhub-web-service | 8000 | 鉴权服务前端 | -| redis | 6379 (内部端口) | Redis数据缓存 | -| minio | 9000 (内部端口) 9001(外部部端口) | minio对象存储 | -| mongo | 27017 (内部端口) | mongo数据库 | +| mysql | 3306 (内部端口) | MySQL数据库 | +| redis | 6379 (内部端口) | Redis数据缓存 | +| minio | 9000 (内部端口) 9001(外部部端口) | minio对象存储库 | +| mongo | 27017 (内部端口) | mongo数据库 | | openGauss | 5432 (内部端口) | 向量数据库 | | secret_inject | 无 | 配置文件安全复制工具 | ### 软件要求 -| 类型 | 版本要求 | 说明 | -|----------------| -------------------------------------|--------------------------------------| -| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | -| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | +| 类型 | 版本要求 | 说明 | +|----- | ----------|------| +| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | +| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | | Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | | python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | --- ### 硬件规格 -| 硬件资源 | 最小配置 | 推荐配置 | +| 硬件资源 | 最小配置 | 推荐配置 | |--------------|----------------------------|------------------------------| -| CPU | 4 核心 | 16 核心及以上 | -| RAM | 4 GB | 64 GB | -| 存储 | 32 GB | 64G | -| 大模型名称 | deepseek-llm-7b-chat | DeepSeek-R1-Llama-8B -| 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | - +| CPU | 4 核心 | 16 核心及以上 | +| RAM | 4 GB | 64 GB | +| 存储 | 32 GB | 64G | +| 大模型名称 | qwen2.5-14B | qwen2.5-32B | +| 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | **关键说明**： - 纯CPU环境，建议通过调用 OpenAI 接口或使用自带的模型部署方式来实现功能。 @@ -328,37 +328,37 @@ helm upgrade euler-copilot -n euler-copilot . # 用于问答的大模型；需要为OpenAI兼容接口 answer: # [必填] 接口URL（无需带上“v1”后缀） - url: http://$IP:11434 + endpoint: http://172.168.XXX.XX:11434 # [必填] 接口API Key；默认置空 key: sk-123456 # [必填] 模型名称 name: deepseek-llm-7b-chat:latest # [必填] 模型最大上下文数；建议>=8192 - ctx_length: 8192 + ctxLength: 8192 # 模型最大输出长度，建议>=2048 - max_tokens: 2048 - # 用于Function Call的模型；建议使用特定推理框架 - functioncall: + maxTokens: 2048 + # 用于Function Call的模型；建议使用特定推理框架 + functionCall: # 推理框架类型，默认为ollama # 可用的框架类型：["vllm", "sglang", "ollama", "openai"] - backend: + backend: ollama # 模型地址；不填则与问答模型一致 - url: ollama + endpoint: # API Key；不填则与问答模型一致 - key: + key: # 模型名称；不填则与问答模型一致 - name: + name: # 模型最大上下文数；不填则与问答模型一致 - ctx_length: + ctxLength: 8192 # 模型最大输出长度；不填则与问答模型一致 - max_tokens: - # 用于数据向量化（Embedding）的模型 + maxTokens: 8192 + # 用于数据向量化（Embedding）的模型 embedding: # 推理框架类型，默认为openai # [必填] Embedding接口类型：["openai", "mindie"] type: openai # [必填] Embedding URL（需要带上“v1”后缀） - url: http://172.168.178.107:11434 + endpoint: http://172.168.XXX.XX:11434/v1 # [必填] Embedding 模型API Key key: sk-123456 # [必填] Embedding 模型名称 -- Gitee From c979b3a207d0de85a61a471e4cf0835b314c4dbc Mon Sep 17 00:00:00 2001 From: ylzhangah <1194926515@qq.com> Date: Fri, 13 Jun 2025 15:49:35 +0800 Subject: [PATCH 3/3] update file --- ...50\347\275\262\346\214\207\345\215\227.md" | 24 ++++----- ...50\347\275\262\346\214\207\345\215\227.md" | 51 +++++++++---------- 2 files changed, 36 insertions(+), 39 deletions(-) diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 04f602fa..bc46cb00 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\346\227\240\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -27,12 +27,12 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen | secret_inject | 无 | 配置文件安全复制工具 | ### 软件要求 -| 类型 | 版本要求 | 说明 | -|----- | ----------|------| -| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | -| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | -| Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | -| python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | +| 类型 | 版本要求 | 说明 | +|-------------| ------------------------------|-------------------------| +| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | +| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | +| Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | +| python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | --- ### 硬件规格 @@ -79,11 +79,11 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen - **资源清单** [openEuler Intelligence 资源下载地址](https://repo.oepkgs.net/openEuler/rpm/openEuler-22.03-LTS/contrib/eulercopilot/) -| 类型 | 资源文件/说明 | -|------------|--------------| -| **镜像文件** | `hub.oepkgs.net/neocopilot/euler-copilot-framework:0.9.6-x86`
`hub.oepkgs.net/neocopilot/euler-copilot-web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_back_end:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/authhub:0.9.3-x86`
`hub.oepkgs.net/neocopilot/authhub-web:0.9.3-x86`
`hub.oepkgs.net/neocopilot/opengauss:latest-x86`
`hub.oepkgs.net/neocopilot/redis:7.4-alpine-x86`
`hub.oepkgs.net/neocopilot/mysql:8-x86`
`hub.oepkgs.net/neocopilot/minio:empty-x86`
`hub.oepkgs.net/neocopilot/mongo:7.0.16-x86`
`hub.oepkgs.net/neocopilot/secret_inject:dev-x86`
| -| **模型文件** | `bge-m3-Q4_K_M.gguf`
`deepseek-llm-7b-chat-Q4_K_M.gguf`
| -| **工具包** | `helm-v3.15.0-linux-{arm64/amd64}.tar.gz`
`k3s-airgap-images-{arm64/amd64}.tar.zst`
`k3s-{arm64/amd64}`
`k3s-install.sh`
`ollama-linux-{arm64/amd64}.tgz` | + | 类型 | 资源文件/说明 | + |------------|--------------| + | **镜像文件** | `hub.oepkgs.net/neocopilot/euler-copilot-framework:0.9.6-x86`
`hub.oepkgs.net/neocopilot/euler-copilot-web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_back_end:0.9.6-x86`
`hub.oepkgs.net/neocopilot/data_chain_web:0.9.6-x86`
`hub.oepkgs.net/neocopilot/authhub:0.9.3-x86`
`hub.oepkgs.net/neocopilot/authhub-web:0.9.3-x86`
`hub.oepkgs.net/neocopilot/opengauss:latest-x86`
`hub.oepkgs.net/neocopilot/redis:7.4-alpine-x86`
`hub.oepkgs.net/neocopilot/mysql:8-x86`
`hub.oepkgs.net/neocopilot/minio:empty-x86`
`hub.oepkgs.net/neocopilot/mongo:7.0.16-x86`
`hub.oepkgs.net/neocopilot/secret_inject:dev-x86`
| + | **模型文件** | `bge-m3-Q4_K_M.gguf`
`deepseek-llm-7b-chat-Q4_K_M.gguf`
| + | **工具包** | `helm-v3.15.0-linux-{arm64/amd64}.tar.gz`
`k3s-airgap-images-{arm64/amd64}.tar.zst`
`k3s-{arm64/amd64}`
`k3s-install.sh`
`ollama-linux-{arm64/amd64}.tgz` | --- @@ -418,7 +418,7 @@ NPU 环境部署可参考链接 [昇腾镜像仓库](https://www.hiascend.com/de 如果遇到如下连接错误： -```text +```bash urllib3.exceptions.NewConnectionError: : Failed to establish a new connection: [Errno 101] Network is unreachable ``` diff --git "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" index 9fd977bb..51a4fd06 100644 --- "a/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" +++ "b/docs/user-guide/\351\203\250\347\275\262\346\214\207\345\215\227/\347\275\221\347\273\234\347\216\257\345\242\203\344\270\213\351\203\250\347\275\262\346\214\207\345\215\227.md" @@ -12,7 +12,7 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen ### 组件介绍 - 组件 | 端口 | 说明 | +| 组件 | 端口 | 说明 | | ----------------------------- | --------------- | -------------------- | | euler-copilot-framework | 8002 (内部端口) | 智能体框架服务 | | euler-copilot-web | 8080 | 智能体前端界面 | @@ -27,12 +27,12 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen | secret_inject | 无 | 配置文件安全复制工具 | ### 软件要求 -| 类型 | 版本要求 | 说明 | -|----- | ----------|------| -| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | -| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | -| Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | -| python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | +| 类型 | 版本要求 | 说明 | +|-------------| ------------------------------|-------------------------| +| 操作系统 | openEuler 22.03 LTS 及以上版本 | 无 | +| K3s | >= v1.30.2，带有 Traefik Ingress 工具 | K3s 提供轻量级的 Kubernetes 集群，易于部署和管理 | +| Helm | >= v3.15.3 | Helm 是一个 Kubernetes 的包管理工具，其目的是快速安装、升级、卸载 openEuler Intelligence 服务 | +| python | >=3.9.9 | python3.9.9 以上版本为模型的下载和安装提供运行环境 | --- ### 硬件规格 @@ -43,7 +43,6 @@ openEuler Intelligence 是一款智能问答工具，使用 openEuler Intelligen | 存储 | 32 GB | 64G | | 大模型名称 | qwen2.5-14B | qwen2.5-32B | | 显存 (GPU) | NVIDIA RTX A4000 8GB | NVIDIA A100 80GB * 2 | - **关键说明**： - 纯CPU环境，建议通过调用 OpenAI 接口或使用自带的模型部署方式来实现功能。 - 如果k8s集群环境，则不需要单独安装k3s，要求version >= 1.28 @@ -199,13 +198,19 @@ helm upgrade euler-copilot -n euler-copilot . ``` ## 验证安装 -恭喜您，**openEuler Intelligence** 已成功部署！为了开始您的体验，请在浏览器中输入 `https://您的openEuler Intelligence域名` 链接访问 openEuler Intelligence 的网页界面： +恭喜您，**openEuler Intelligence** 已成功部署！为了开始您的体验，请在浏览器中输入以下链接访问 openEuler Intelligence 的网页界面: +```text +https://www.eulercopilot.local +``` +首次访问时，您需要： -首次访问时，您需要点击页面上的 **立即注册** 按钮来创建一个新的账号，并完成登录过程。 +1. 点击**立即注册**按钮 +2. 创建新账号 +3. 完成登录 ![Web登录界面](./pictures/WEB登录界面.png) ![Web 界面](./pictures/WEB界面.png) - +--- --- ## 构建专有领域智能问答 @@ -383,27 +388,19 @@ helm upgrade euler-copilot -n euler-copilot . NPU 环境部署可参考链接 [昇腾镜像仓库](https://www.hiascend.com/developer/ascendhub), 可参考[NPU部署案例](./NPU推理服务器部署指南.md) ### FAQ -#### 1. 解决 Hugging Face 连接错误 +#### 1. 解决Hugging Face连接错误 -如果遇到如下连接错误： +如果遇到连接错误： ```text -urllib3.exceptions.NewConnectionError: : Failed to establish a new connection: [Errno 101] Network is unreachable +urllib3.exceptions.NewConnectionError: \: Failed to establish... ``` -尝试以下解决方案： - -- 更新 `huggingface_hub` 包到最新版本。 - - ```bash - pip3 install -U huggingface_hub - ``` - -- 如果网络问题依旧存在，可以尝试使用镜像站点作为端点。 - - ```bash - export HF_ENDPOINT=https://hf-mirror.com - ``` +解决方案： +```bash +pip3 install -U huggingface_hub +export HF_ENDPOINT=https://hf-mirror.com +``` #### 2. 在 RAG 容器中调用问答接口 -- Gitee