在Notebook中安装配置Hermes

对于AI开发人员来说，如果需要在华为云ModelArts Notebook中高效地编写和管理AI模型，可能会遇到代码编写效率低、模型管理复杂的问题。本文介绍如何在华为云ModelArts Notebook中部署并使用Hermes。

Hermes是NousResearch开源的AI智能体，本文提供的安装脚本已针对ModelArts环境进行适配，预置了MaaS、百炼（DashScope）、DeepSeek等主流模型提供商的接入配置，可通过终端（CLI）进行交互，并借助Memory（持久记忆）、Skill（技能复用）、Web Search（联网搜索）、子代理协作等核心能力，快速使用和管理ModelArts服务，从而提高开发效率和简化模型管理。

Notebook是容器运行时环境，运行环境会在关机时被清理。请通过保存镜像及时保留apt-get install、npm install、uv pip install安装后的环境，以及~/.hermes/ 目录下的配置文件（config.yaml、.env）、Skills、Memory和对话session等，以避免Notebook运行环境中的数据丢失。关于如何保存镜像，请参见保存镜像。

注意事项

使用Hermes时可能出现风险，详情请参见Hermes风险说明及安全建议。

约束限制

Notebook Hermes功能仅支持“华北-北京四”、“西南-贵阳一”、“华北-乌兰察布一”、“华东-上海一”和“华南-广州”区域。

您创建的Notebook实例需满足如下条件，才能正常使用Hermes。

表1 Notebook实例约束限制
类型	限制
环境配置	容器镜像的操作系统：暂不支持ubuntu_18.04及以下。说明：假设预置镜像的地址为pytorch_cuda: pytorch_2.7.0-cuda_12.8-py_3.11.10-ubuntu_22.04-x86_64-20251215163925-4e5422a，其中“ubuntu_22.04”为镜像的操作系统。 JupyterLab版本：仅支持4.4.x版本。图1 创建Notebook实例-环境配置
资源配置	仅支持专属资源池，以确保安全使用。关于如何创建专属资源池，请参见创建专属资源池。由于GPU、NPU资源受限购买，需联系客户经理或提交工单申请开通相应的资源规格；如果您所在的区域无CPU规格，请尝试切换至其他区域，例如华东-上海一、华北-北京四、亚太-曼谷、中东-利雅得等。图2 创建Notebook实例-资源配置

计费说明

在ModelArts运行Notebook实例时，会使用计算资源和存储资源，产生计算资源和存储资源的累计值计费。计费详情请参见开发环境计费项。
Hermes本身不收费，但调用大模型API会产生费用。具体计费方式取决于您选择的API Provider。

在Notebook配置Hermes

登录ModelArts管理控制台，在左侧导航栏按需选择以下操作。
- 新版控制台：选择“模型开发与训练 > Notebook”，进入“Notebook”页面。
- 旧版控制台：选择“开发空间 > Notebook”，进入“Notebook”页面。
在“状态”为“运行中”的Notebook实例的操作列，单击“接入环境”，在“接入方式”对话框的“WebIDE”页签，单击“JupyterLab 接入”右侧的“接入”。
在“ModelArts Launcher”页面的“AI Agent”区域，单击“Hermes”。
图3 Hermes插件图标
在“Hermes 控制面板”，勾选协议，单击“安装配置 Hermes”，在Terminal中选择“完整安装 Hermes Agent”，按Enter确认。
图4 安装配置Hermes

图5 完整安装Hermes
安装版本选择推荐版本，安装完成后，会显示“Hermes Agent安装完成”。
图6 选择安装版本

按实际情况配置模型信息。

如果您需要配置自定义模型，模型需要支持Function Call能力。Qwen3_32B及以下的模型都默认不支持Function Call。查看MaaS模型能力，请参见推荐模型；查看ModelArts模型能力，请参见模型调用功能介绍。

下文以配置华为云MaaS为例。第三方模型配置信息请参见对应的模型提供商的指导文档。

表2 首次配置向导-MaaS配置示例
配置项	说明	配置示例
是否现在配置华为云MaaS	选择配置MaaS或其他服务，本文以MaaS为例。	Y
MaaS API URL	使用MaaS API地址时，需删除地址末尾的/chat/completions，修改示例参见表3。	https://api.modelarts-maas.com/openai/v1
MaaS API Key	输入在MaaS创建的API Key。关于如何在MaaS创建API Key，请参见创建API Key。	D1Jy5b4n_JOKGSDEbhmNTZxpX5Obk6asJrA4bS660GZ_nrKFL-NSU2wv13AuliG_tbIz7i0wiY7*********
选择AI模型	按需选择使用的模型。	glm-5.1（GLM-5.1）
配置已更新，是否立即启动Gateway服务	启动Gateway，使配置生效。	Y

表3 MaaS API地址说明
接口	原MaaS API地址	修改后的MaaS API地址	相关文档
MaaS标准API V2	https://api.modelarts-maas.com/v2/chat/completions	https://api.modelarts-maas.com/v2	模型API调用规范
OpenAI兼容接口	https://api.modelarts-maas.com/openai/v1	与原MaaS API地址一致	模型API调用规范