SuperAPI AI 工具集

huawei-cloud-flexus-l-server-hermes-deployment

部署与运维

查看项目

更新于 10-15 12:02

技能介绍

用途

本技能用于将 Hermes AI Agent 平台一键部署到华为云 Flexus L 实例,并提供完整的部署与配置工作流,包括:自动化实例创建、通过 COC(云运维中心)配置 ModelArts 大模型、通过 COC 配置机器人渠道(飞书、企业微信等),以及已部署实例的网关管理。支持交互模式(逐步提示)和非交互模式(脚本化操作),适用于手动和自动化部署场景。

主要能力

  • 部署 Hermes:创建并配置带 Hermes AI Agent 平台的 Flexus L 实例。
  • 配置模型:通过 COC 设置 ModelArts 大模型(参数包括 API_BASE、API_KEY、MODEL_NAME)。
  • 配置渠道:通过 COC 设置机器人渠道(飞书、企业微信)。
  • 网关管理:按需重启网关服务。
  • 查询执行结果:通过 execute-uuid 查询脚本执行状态(FINISHED 成功、ABNORMAL 失败、RUNNING 执行中)。
  • 查询 UniAgent 状态:ONLINE 表示可执行 COC 脚本,OFFLINE 表示不可执行,UNKNOWN 表示无法确定。

使用方式

提供 Python 命令行脚本,主入口为 scripts/caller.py,支持以下核心命令:

  • 部署:python scripts/caller.py deploy --ak <AK> --sk <SK> --name hermes-{timestamp} --region cn-north-4
  • 模型配置:python scripts/caller.py maas --ak <AK> --sk <SK> --resource-id <instance_id> --region-id cn-north-4 --api-key <api_key> --model-name deepseek-v3.2
  • 渠道配置(飞书):python scripts/caller.py channel --ak <AK> --sk <SK> --resource-id <instance_id> --region-id cn-north-4 --bot-platform feishu --feishu-app-id <app_id> --feishu-app-secret <app_secret>
  • 渠道配置(企业微信):python scripts/caller.py channel --ak <AK> --sk <SK> --resource-id <instance_id> --region-id cn-north-4 --bot-platform wecom --wecom-bot-id <bot_id> --wecom-secret <secret>
  • 网关重启:python scripts/caller.py gateway --ak <AK> --sk <SK> --resource-id <instance_id> --region-id cn-north-4
  • 查询结果:python scripts/caller.py query --ak <AK> --sk <SK> --execute-uuid SCT2023083109562601af694bf
  • UniAgent 状态:python scripts/caller.py uniagent --ak <AK> --sk <SK> --resource-id <instance_id>

临时 AK/SK 需额外传入 --security-token。凭证也可通过环境变量 HW_ACCESS_KEY、HW_SECRET_KEY、HW_SECURITY_TOKEN 传入。运行 python scripts/caller.py 可进入交互菜单。

适用场景

  • 需要在华为云 Flexus L 实例上快速部署 Hermes AI Agent 平台的场景。
  • 需要将机器人接入飞书或企业微信的场景。
  • 手动逐步配置或脚本化自动化部署场景。

限制与注意事项

  • 需有效华为云账户与相应权限(创建 Flexus L 实例、访问 COC 服务、配置 ModelArts 大模型)。
  • Hermes 部署仅支持区域:cn-north-4、cn-east-3、cn-south-1、cn-southwest-2。
  • 目前仅支持飞书和企业微信两种机器人平台,且每种平台类型仅支持一个机器人。
  • 实例创建可能需要 5-10 分钟完成配置。
  • 初始部署后默认模型配置不可用,必须先配置模型才能使用 Hermes。
  • 使用华为云资源会产生费用,需确保账户余额充足。
  • 如需外部访问,需在华为云控制台配置安全组规则。
  • 模型与渠道配置通过华为云 COC 远程执行。
  • 凭证必须通过环境变量传递或自动继承,不得出现在对话、日志或临时脚本中。
  • COC 服务区域与目标实例区域是两个不同概念,可不同。
  • 贵阳区域(cn-southwest-2)使用规格 ahf.small.1.linux,其他区域(北京/上海/广州)使用 hf.small.1.linux。
  • 状态码 200、201、202 均表示成功。