Hermes Agent 快速上手指南：三步看懂意图识别与槽位填充

Hermes Agent 是一个会在对话里替你办事的开源 AI 代理，它靠意图识别和槽位填充来听懂话、抓住细节。

你：「帮我约个明天上午的会。」 Hermes：「好，明天上午 10:00，时长按默认 1 小时。没说地点，需要加吗？」

它没问你"这是什么业务"，直接就把话拆成了意图和字段——这就是今天要聊的两个词。

📇 看懂两个词：意图和槽位

先记住两个类比：

• 意图识别，像前台听懂你想办什么业务——"开会"、"提醒我"、"查天气"，各算一类。
• 槽位，像登记表上的栏目——时间、地点、事件，填进对应格子才算一单完整的信息。

拿"帮我明天晚上 8 点提醒我浇花"这句拆开看：

意图对了但栏位空着，系统要么自己补默认值，要么回头问你一句，就像上面那个"需要加地点吗"。

🎯 一句话是如何被处理的：意图识别三步走

第一步：听懂。你发来的话不会孤立处理。代理会先组装好系统提示、技能索引和上下文文件（见 agent/prompt_builder.py），再把你这句话连同最近几轮对话一起交给模型，由对话主循环（agent/conversation_loop.py）驱动整轮处理。

第二步：分类。模型判断这句话属于哪类"业务"：是执行一个技能、调用某个工具，还是纯粹聊天。Hermes 的技能系统和斜杠命令就是这些业务类别的落点。

第三步：安全过滤。用户输入在进模型之前先过一道清洗，把可能破坏消息结构的坏字符修掉或剥掉，这一步在 agent/message_sanitization.py 里实现，保证脏数据不会让整轮对话崩掉。

📝 槽位填充：像填表一样提取关键信息

三个要点就够用了：

• 槽位是什么：每类业务有自己的栏目清单，"设提醒"要有时间和事件，"开会"还要有地点和参会人。提取就是把话里的信息塞进对应栏目。
• 缺省值怎么补：你只说"明天上午开会"，没说几点，系统会按常识补成 10 点、时长 1 小时这种默认值，而不是直接报错。
• 什么时候反问：默认值补不了的必填栏（比如会议地点影响日程写入）才会触发一句"需要加地点吗"，问完就继续，不卡流程。

🚀 5分钟上手体验

1. 克隆仓库：git clone https://gitcode.com/GitHub_Trending/he/hermes-agent
2. 照着README.zh-CN.md的"快速安装"配好环境，再跑一次hermes setup走完整向导
3. hermes model选一个你能用的模型
4. 运行hermes进入对话，试试"帮我约明天上午的会"，观察它怎么确认时间、追问地点

❓ 常见问题

意图识别错了怎么办？直接说"我指的是 X"，代理会结合上下文重新处理；不想纠缠就发/new开一轮。

如何新增一类意图？不用写分类器代码。用自然语言描述任务，让代理沉淀成技能（技能系统见 agent/skill_commands.py），下次说类似的话就会命中新"业务"。

去哪看提取出的槽位？每轮处理完，关键参数会体现在回复的确认句里（"明天 10:00，1 小时"）；会话记录里也能回看完整对话，密钥类内容会被 agent/redact.py 打码。

到这儿你已经走通了"听懂话 → 分类 → 填表 → 反问"的完整链路。想继续深挖，从README.zh-CN.md里那张文档导航表入手，配置、消息网关、技能系统都有专门章节。