hermes agent新手快速上手需五步：一、安装0.4.2版本并初始化；二、配置llm的provider、api_key和model；三、用yaml定义greeting_agent；四、通过hermes chat调试交互；五、注册本地tools.py工具扩展功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚刚接触Hermes Agent，希望快速完成基础配置并执行首个智能体任务，则可能是由于缺乏对核心组件和初始化流程的清晰认知。以下是新手快速上手Hermes Agent的实操步骤：
一、安装Hermes Agent运行环境
确保本地具备Python 3.9及以上版本与pip包管理器，Hermes Agent依赖特定版本的异步框架与LLM连接模块，需通过官方推荐方式安装以避免兼容性问题。
1、打开终端或命令提示符，执行命令：pip install hermes-agent==0.4.2。
2、验证安装是否成功，运行：python -c "import hermes; print(hermes.__version__)"，输出应为0.4.2。
3、创建独立工作目录，进入该目录后执行：hermes init，自动生成config.yaml与agents/子目录。
二、配置基础LLM接入参数
Hermes Agent默认不内置大模型服务，需手动指定API端点、密钥及模型名称，此配置决定后续所有智能体的推理能力来源。
1、用文本编辑器打开项目根目录下的config.yaml文件。
2、在llm节点下填写以下字段：provider: openai、api_key: sk-xxx（替换为实际密钥）、model: gpt-4o-mini。
3、保存文件后，在终端执行：hermes check-config，确认配置项无语法错误且API可连通。
三、定义首个简单任务型Agent
通过YAML声明式方式定义Agent行为逻辑，无需编写Python类，适合新手理解“角色-目标-工具”三层结构。
1、在agents/目录中新建文件greeting_agent.yaml。
2、写入以下内容：name: greeting_agent\nrole: 你是一个欢迎助手\ngoal: 向用户输出包含当前时间的友好问候语\ntools: []。
3、保存后执行：hermes run --agent greeting_agent，观察控制台输出问候消息。
四、启用内置调试交互模式
调试模式允许用户以对话形式实时触发Agent响应，跳过代码封装环节，直接验证意图理解与指令执行效果。
1、在项目根目录下运行命令：hermes chat --agent greeting_agent。
2、输入任意文本如你好，Agent将立即返回结构化问候响应。
3、按Ctrl+C退出交互，日志自动保存至logs/chat_session_YYYYMMDD.log。
五、加载本地工具扩展功能
当需要让Agent调用系统命令或读取本地文件时，可通过注册轻量工具函数实现，无需修改核心代码。
1、在项目根目录新建tools.py，定义函数def get_system_time(): return datetime.now().strftime("%H:%M")。
2、在config.yaml的tools节点下添加：system_time: ./tools.py:get_system_time。
3、修改greeting_agent.yaml中的tools字段为[system_time]，重新运行hermes run命令验证时间嵌入效果。
