AgenticHub

1. 概述

AgenticHub 是 CSGHub 平台中专门负责 AI Agent 开发、配置、运行与协作的模块。

该模块提供两种核心能力：

AgenticFlow：可视化编排工作流，支持节点拖拽、条件分支、循环等复杂流程设计。
CSGBot：AI 助手服务，支持对话、代码生成、Web Search、文档解析等多种能力。

本 Chart 通过 Helm 提供标准化部署方式，支持灵活配置与自动化资源管理。

2. 环境要求

项目	说明
Kubernetes 版本	v1.33+
Helm 版本	v3.12+
网络要求	集群节点需能访问 CSGHub Server 与外部镜像仓库
权限要求	具备创建命名空间与 RBAC 资源的权限

3. 组件说明

3.1 AgenticFlow

可视化工作流编排引擎，主要功能：

拖拽式流程设计
支持条件分支与循环
内置多种功能节点（LLM、Tool、Code 等）
支持 Python/JavaScript 脚本执行

3.2 CSGBot

AI 助手服务，主要功能：

对话与问答
代码生成与解释
Web Search 集成
文档解析与处理
沙箱执行环境（GeniusSandbox、DocSandbox、OpenClaw）

4. 开始部署

前置要求：部署 AgenticHub 需要配置 EE License，请联系 OpenCSG 获取授权。

4.1 添加 Helm 仓库

helm repo add csghub https://charts.opencsg.com/csghub
helm repo update

4.2 创建命名空间（可选）

kubectl create namespace csghub

4.3 获取 CSGHub 配置信息

需要从 CSGHub 主服务获取以下信息：

externalUrl：CSGHub 访问地址

helm get notes csghub -n csghub | grep -A 6 'Access your CSGHub'

hubAPIToken：API Token

kubectl get cm csghub-core -o yaml -n csghub | grep 'API_TOKEN' | awk '{print $NF}'

4.4 执行部署

helm install agentichub csghub/agentichub \
  --namespace csghub \
  --create-namespace \
  --set externalUrl="<csghub external_url>" \
  --set hubAPIToken="<csghub hub_api_token>" \
  --set global.gateway.external.domain="example.com"

💡 提示：

国内部署添加：--set global.image.registry="opencsg-registry.cn-beijing.cr.aliyuncs.com"

建议将自定义配置写入 custom-values.yaml，方便后续升级与版本管理。

4.5 使用外部数据库（可选）

helm install agentichub csghub/agentichub \
  --namespace csghub \
  --set externalUrl="https://csghub.example.com" \
  --set hubAPIToken="<token>" \
  --set global.postgresql.enabled=false \
  --set agenticflow.postgresql.host="<pg_host>" \
  --set agenticflow.postgresql.port=5432 \
  --set agenticflow.postgresql.database="csghub_agenticflow" \
  --set agenticflow.postgresql.user="csghub" \
  --set agenticflow.postgresql.password="<password>"

4.6 使用外部 Redis（可选）

helm install agentichub csghub/agentichub \
  --namespace csghub \
  --set global.redis.enabled=false \
  --set agenticflow.redis.host="<redis_host>" \
  --set agenticflow.redis.port=6379 \
  --set agenticflow.redis.password="<password>"

5. 部署后配置 CSGHub

AgenticHub 部署完成后，需要配置 CSGHub 主服务以连接 AgenticFlow 和 CSGBot。

5.1 获取 HTTPRoute 地址

AgenticHub 通过 HTTPRoute 暴露服务，执行以下命令获取域名：

# 获取 AgenticFlow 访问地址
kubectl get httproute -n csghub -o wide | grep agenticflow

# 获取 CSGBot 访问地址
kubectl get httproute -n csghub -o wide | grep csgbot

输出示例：

NAME                          HOSTNAMES                          AGE
agentichub-agenticflow-xxx    agenticflow.example.com            5m
agentichub-csgbot-xxx        csgbot.example.com                 5m

5.2 配置 CSGHub

更新 CSGHub 的配置文件（custom-values.yaml），添加以下配置：

server:
  agenticflow:
    host: "http://agenticflow.example.com"  # 替换为实际的 AgenticFlow 域名
    token: "<从 agentichub-agenticflow configmap 获取的 FLOWS_ACCESS_TOKEN>"  # AgenticFlow API Token，不可为空

  csgbot:
    host: "http://csgbot.example.com"        # 替换为实际的 CSGBot 域名
    port: 80

获取 AgenticFlow Token：

kubectl get cm agentichub-agenticflow -o yaml -n csghub | grep 'FLOWS_ACCESS_TOKEN' | awk '{print $NF}'

或使用 --set 参数直接配置：

helm upgrade csghub csghub/csghub -n csghub \
  --set server.agenticflow.host="http://agenticflow.example.com" \
  --set server.agenticflow.token="<agentichub_agenticflow_token>" \
  --set server.csgbot.host="http://csgbot.example.com" \
  --set server.csgbot.port=80

💡 更多配置参考 CSGHub 标准安装。

5.3 升级 CSGHub

helm upgrade csghub csghub/csghub -n csghub -f custom-values.yaml

5.4 验证连接

# 查看 CSGHub Server 日志，确认连接成功
kubectl logs -f deploy/csghub-server -n csghub | grep -i "agenticflow\|csgbot"

5.5 LLM 配置

为 AgenticHub 配置 Model API 服务，步骤如下：

点击右上角头像，选择管理员后台
在侧边栏选择商业 API
配置需要的 Model API 服务，配置参数说明：

参数	说明
模型名称	自定义名称，如 `MiniMax-M2.7`
官方名称	模型官方名称，如 `MiniMax-M2.7`
API 地址	模型 API 端点，如 `https://api.minimaxi.com/v1/chat/completions`
认证头信息	API 密钥认证头，如 `{"Authorization": "Bearer sk-cp-***"}`
提供方	服务提供方名称，如 `minimax`
类型	16
路由策略	选择单节点
属性配置	如 `{"is_csgbot_model":true,"tasks":["text-generation"]}`

⚠️ 注意：以上为配置示例，实际配置请根据您使用的模型服务进行调整。

6. 配置说明

6.1 全局配置

参数	默认值	说明
`global.edition`	`ee`	版本：`ce`（社区版）/ `ee`（企业版）/ `saas`（SaaS 版）。AgenticHub 需要 `ee` 或 `saas`（`ce` 下不部署）
`global.gateway.external.domain`	`example.com`	平台基础访问域名
`global.gateway.service.type`	`LoadBalancer`	服务类型：`LoadBalancer` 或 `NodePort`
`global.image.registry`	`docker.io`	镜像仓库地址
`global.image.tag`	`latest`	镜像版本标签
`global.postgresql.enabled`	`true`	是否启用内置 PostgreSQL
`global.redis.enabled`	`true`	是否启用内置 Redis

6.2 AgenticHub 配置

参数	默认值	说明
`externalUrl`	`https://csghub.example.com`	CSGHub 外部访问地址
`hubAPIToken`	`""`	CSGHub API 认证 Token

6.3 AgenticFlow 配置

参数	默认值	说明
`agenticflow.image.repository`	`opencsghq/agenticflow`	镜像仓库地址
`agenticflow.image.tag`	`ee-v0.6-4`	镜像版本（v0.5.x 为 `v0.5.1-ee`）
`agenticflow.service.port`	`7860`	服务端口
`agenticflow.persistence.size`	`20Gi`	存储大小

6.4 CSGBot 配置

参数	默认值	说明
`csgbot.image.repository`	`opencsghq/csgbot`	镜像仓库地址
`csgbot.image.tag`	`v0.6.2-ee`	镜像版本（v0.5.x 为 `v0.5.1-ee`）
`csgbot.service.port`	`8070`	服务端口
`csgbot.persistence.size`	`20Gi`	存储大小

6.5 CSGBot 沙箱配置

参数	默认值	说明
`csgbot.config.aigateway.model`	`qwen3.6-plus`	csgbot AI 模型 ID
`csgbot.config.aigateway.temperature`	`0.1`	模型温度
`csgbot.config.starship.endpoint`	`""`	Starship 端点 URL
`csgbot.config.speechToText.modelId`	`qwen3-asr-flash`	STT 模型 ID
`csgbot.config.sandbox.genius.image`	`opencsghq/genius-sandbox`	Genius 沙箱镜像
`csgbot.config.sandbox.doc.image`	`opencsghq/doc-sandbox`	Doc 沙箱镜像
`csgbot.config.sandbox.openclaw.image`	`opencsghq/openclaw-sandbox`	OpenClaw 沙箱镜像
`csgbot.config.sandbox.csgclawServer.image`	`opencsghq/csgclaw-server-sandbox`	CSGClaw server 沙箱镜像
`csgbot.config.sandbox.csgclawAgent.image`	`opencsghq/csgclaw-agent-sandbox`	CSGClaw agent 沙箱镜像
`csgbot.config.sandbox.timeoutSeconds`	`600`	沙箱执行超时（秒）
`csgbot.config.sandbox.maxUploadFileBytes`	`52428800`	单次最大上传文件字节
`csgbot.config.integrations.notification.enabled`	`false`	启用飞书通知
`csgbot.config.fileServer.endpoint`	`""`	文件服务器端点 URL
`csgbot.config.observability.serviceName`	`csgbot-ee`	可观测服务名
`csgbot.config.observability.phoenixEndpoint`	`""`	Phoenix 端点
`csgbot.config.logging.logPath`	`logs/server.log`	日志文件路径
`csgbot.config.logging.logLevel`	`INFO`	日志级别

⚠️ v0.6.x schema 变更：csgbot.config.webSearch.*、integrations.feishuEnabled、externalDocs.* 键已移除。如在用，升级前迁移至上述新键。

6.6 内置 PostgreSQL 配置

参数	默认值	说明
`postgresql.image.tag`	`15.17`	PostgreSQL 版本
`postgresql.service.type`	`ClusterIP`	服务类型
`postgresql.service.port`	`5432`	服务端口
`postgresql.persistence.size`	`50Gi`	存储大小
`postgresql.databases`	`["agentichub_agenticflow"]`	自动创建的数据库

6.7 内置 Redis 配置

参数	默认值	说明
`redis.image.tag`	`7.2.5`	Redis 版本
`redis.service.type`	`ClusterIP`	服务类型
`redis.service.port`	`6379`	服务端口
`redis.requirePass`	`false`	是否需要密码
`redis.persistence.size`	`10Gi`	存储大小

7. 验证部署

部署完成后，可通过以下命令验证运行状态：

kubectl get pods -n csghub
kubectl get svc -n csghub

查看各组件日志：

# 查看 AgenticFlow 日志
kubectl logs -f deploy/agentichub-agenticflow -n csghub

# 查看 CSGBot 日志
kubectl logs -f deploy/agentichub-csgbot -n csghub

获取访问地址：

helm status agentichub -n csghub

8. 升级与卸载

8.1 升级 Chart

helm upgrade agentichub csghub/agentichub -n csghub -f custom-values.yaml

8.2 卸载 Chart

helm uninstall agentichub -n csghub

9. 常见问题

问题	解决方案
AgenticFlow 无法连接 CSGHub	检查 `externalUrl` 与 `hubAPIToken` 配置是否正确
CSGBot 沙箱执行失败	检查沙箱镜像是否正常拉取，网络是否可达
数据库连接失败	检查 PostgreSQL 配置及网络连通性
Redis 连接失败	检查 Redis 配置及密码是否正确
镜像拉取失败	确认镜像仓库访问权限与 `global.image.pullSecrets` 配置

1. 概述​

2. 环境要求​

3. 组件说明​

3.1 AgenticFlow​

3.2 CSGBot​

4. 开始部署​

4.1 添加 Helm 仓库​

4.2 创建命名空间（可选）​

4.3 获取 CSGHub 配置信息​

4.4 执行部署​

4.5 使用外部数据库（可选）​

4.6 使用外部 Redis（可选）​

5. 部署后配置 CSGHub​

5.1 获取 HTTPRoute 地址​

5.2 配置 CSGHub​

5.3 升级 CSGHub​

5.4 验证连接​

5.5 LLM 配置​

6. 配置说明​

6.1 全局配置​

6.2 AgenticHub 配置​

6.3 AgenticFlow 配置​

6.4 CSGBot 配置​

6.5 CSGBot 沙箱配置​

6.6 内置 PostgreSQL 配置​

6.7 内置 Redis 配置​

7. 验证部署​

8. 升级与卸载​

8.1 升级 Chart​

8.2 卸载 Chart​

9. 常见问题​