Hermes进阶：自定义技能开发指南

用户请求 → 意图识别 → 技能匹配 → 槽位填充 → 动作执行 → 响应生成 → 对话结束

// 定义一个天气查询技能
const WeatherSkill = {
// 技能元数据
name: 'weather',
description: '提供天气查询服务',
version: '1.0.0',
// 意图定义
intents: [
{
name: 'query_weather',
description: '查询天气',
patterns: ['天气', '温度', '预报', '气候']
},
{
name: 'weather_forecast',
description: '查询天气预报',
patterns: ['预报', '未来', '明天']
}
],
// 槽位定义
slots: [
{
name: 'location',
type: 'string',
required: true,
prompt: '请问要查询哪个城市的天气？'
},
{
name: 'date',
type: 'date',
required: false,
default: 'today',
prompt: '请问要查询哪一天的天气？'
}
],
// 动作处理器
action: async (context) => {
const { location, date } = context.slots;
// 调用天气API获取数据
const weatherData = await fetchWeather(location, date);
return weatherData;
},
// 响应模板
responses: {
success: '{location}{date}的天气是{weather}，温度{temperature}度',
error: '抱歉，无法获取{location}的天气信息'
}
};

// 创建Hermes实例
const hermes = new Hermes();
// 注册技能
hermes.registerSkill(WeatherSkill);
// 注册多个技能
hermes.registerSkills([WeatherSkill, NewsSkill, MusicSkill]);
// 检查技能是否已注册
const isRegistered = hermes.isSkillRegistered('weather');

// Todo技能实现
const TodoSkill = {
name: 'todo',
description: '待办事项管理',
intents: [
{ name: 'add_todo', patterns: ['添加', '创建', '新建'] },
{ name: 'list_todo', patterns: ['列表', '查看', '显示'] },
{ name: 'complete_todo', patterns: ['完成', '标记'] },
{ name: 'delete_todo', patterns: ['删除', '移除'] }
],
slots: [
{
name: 'task',
type: 'string',
required: true,
prompt: '请问要添加什么任务？'
},
{
name: 'index',
type: 'number',
required: false,
prompt: '请问要操作第几个任务？'
}
],
action: async (context) => {
const { intent, slots } = context;
const todoStore = new TodoStore();
switch (intent.name) {
case 'add_todo':
await todoStore.add(slots.task);
return { success: true, message: `已添加任务: ${slots.task}` };
case 'list_todo':
const todos = await todoStore.list();
return { success: true, todos };
case 'complete_todo':
await todoStore.complete(slots.index);
return { success: true, message: '已完成任务' };
case 'delete_todo':
await todoStore.delete(slots.index);
return { success: true, message: '已删除任务' };
}
},
responses: {
success: '{message}',
list: '{todos.map(t => `${t.index}. ${t.text}`).join("\\n")}',
error: '操作失败，请重试'
}
};

// 在一个技能中调用另一个技能
const CalendarSkill = {
// ...
action: async (context) => {
// 获取用户的待办事项
const todoResult = await hermes.invokeSkill('todo', {
intent: 'list_todo',
slots: {}
});
// 使用待办事项数据
if (todoResult.success) {
const todos = todoResult.todos;
// 与日历数据整合
return { calendar: calendarData, todos };
}
}
};

const ContextSkill = {
action: async (context) => {
// 获取对话历史
const history = context.history;
// 获取用户信息
const user = context.user;
// 设置会话变量
context.session.set('lastQuery', context.slots);
// 获取会话变量
const lastQuery = context.session.get('lastQuery');
return { result: 'success' };
}
};

const ConditionalSkill = {
action: async (context) => {
const { slots } = context;
// 根据时间选择不同逻辑
const hour = new Date().getHours();
if (hour < 12) {
// 上午逻辑
return await handleMorningRequest(slots);
} else if (hour < 18) {
// 下午逻辑
return await handleAfternoonRequest(slots);
} else {
// 晚上逻辑
return await handleEveningRequest(slots);
}
}
};

const AsyncSkill = {
action: async (context) => {
// 立即返回响应
context.respond('正在处理，请稍候...');
// 异步执行耗时操作
setTimeout(async () => {
const result = await performLongRunningTask(context);
// 更新响应
context.updateResponse(`处理完成: ${result}`);
}, 1000);
return { async: true };
}
};

// 使用Jest测试技能
describe('WeatherSkill', () => {
test('should recognize weather intent', async () => {
const hermes = new Hermes();
hermes.registerSkill(WeatherSkill);
const result = await hermes.handle('北京明天天气');
expect(result.intent).toBe('query_weather');
expect(result.slots.location).toBe('北京');
});
test('should fill missing slots', async () => {
const result = await hermes.handle('明天天气');
expect(result.response).toContain('请问要查询哪个城市');
});
});

// 创建技能包
const skillPackage = {
name: 'my-weather-skill',
version: '1.0.0',
main: './weather-skill.js',
dependencies: {
'weather-api': '^1.0.0'
},
config: {
apiKey: '<%= WEATHER_API_KEY %>'
}
}; // 导出技能
module.exports = WeatherSkill;

// server.js
const express = require('express');
const Hermes = require('hermes');
const app = express();
const hermes = new Hermes();
// 加载技能
hermes.loadSkill(require('./skills/weather'));
hermes.loadSkill(require('./skills/todo'));
// 创建API端点
app.post('/api/chat', async (req, res) => {
const { message, sessionId } = req.body;
const result = await hermes.handle(message, {
sessionId: sessionId,
user: req.user
});
res.json(result);
});
app.listen(3000, () => {
console.log('Hermes server running on port 3000');
});

// 发布技能命令
hermes publish --name my-skill --version 1.0.0 --description "我的自定义技能"
// 更新技能
hermes publish --update --name my-skill --version 1.1.0 // 安装第三方技能
hermes install weather-skill@1.0.0