hermesagent需通过caldav/ics集成日程、rag注入向量知识库、调度器触发提醒、imap解析会议邮件、mqtt/websocket多端同步实现日常事务协调。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望使用HermesAgent承担日常事务协调职责，例如自动同步日程、识别会议时间并触发提醒，则需明确其当前能力边界与可集成路径。以下是实现该目标的具体操作方式：
一、确认HermesAgent本地部署环境是否启用日历协议支持
HermesAgent本身不内置日历服务，但可通过对接标准日历协议（如CalDAV或ICS订阅）获取日程数据源。需确保运行实例已配置对应协议客户端模块，并能定期轮询或接收Webhook推送。
1、检查HermesAgent配置目录中是否存在calendar.yml或integrations/calendar/子目录。
2、确认calendar.enabled字段值为true，且calendar.protocol设置为caldav或ics。
3、在配置中填入您的日历服务地址、用户名及应用专用密码（如Google Calendar需开启App Password并授权CalDAV访问）。
二、通过RAG工作流注入个人日程知识库
将导出的ICS文件或结构化日程CSV转换为嵌入向量，注入HermesAgent的本地向量数据库，使其能在自然语言查询中定位未来24–72小时内待办事项及会议上下文。
1、使用icalendar库解析原始.ics文件，提取DTSTART、SUMMARY、LOCATION、DESCRIPTION字段。
2、对每条日程生成语义描述句，例如：“2026年5月18日10:00在Zoom召开Q3产品评审会，议程含原型反馈与排期确认。”
3、调用HermesAgent提供的/v1/embed接口批量提交描述句，指定collection名称为personal_schedule。
三、配置基于时间戳的主动提醒触发器
HermesAgent支持通过外部调度器（如systemd timer或cron）定期调用其/v1/trigger/reminder端点，结合当前系统时间筛选临近事件并生成语音/消息提醒。
1、编写Shell脚本，调用date -d "+15 minutes" +%Y%m%dT%H%M%S生成未来15分钟时间戳。
2、向http://localhost:8080/v1/trigger/reminder?before=20260515T151300发起GET请求，携带认证token。
3、在HermesAgent响应体中提取upcoming_events数组，按urgency_score排序后推送至Telegram Bot或本地通知中心。
四、绑定邮件规则实现会议邀请自动解析与入库
当HermesAgent部署于具备邮件收件能力的服务器时，可监听IMAP邮箱中含“invitation.ics”附件的邮件，自动提取会议时间、参会人与议程摘要，并写入日程知识库。
1、在mail.yml中启用imap.watch_enabled: true，填写邮箱主机、端口、用户名与OAuth2 token。
2、设置过滤规则：subject_contains: "Invitation"且has_attachment: true且attachment_ext: ".ics"。
3、启用auto_import_calendar_event: true，使附件解析结果经NLP清洗后同步至personal_schedule向量集合。
五、启用多端状态同步以保障提醒可达性
单一终端提醒易被忽略，需确保HermesAgent的提醒动作可跨设备触发。依赖其MQTT或WebSocket长连接能力，将提醒指令广播至已注册的客户端ID列表。
1、在用户首次登录Web界面或移动端SDK时，调用/v1/device/register提交设备类型、唯一ID与推送令牌（如FCM token）。
2、当触发提醒逻辑时，HermesAgent从device_registry表中查出所有status=active且last_seen > now()-30m的设备。
3、对每个设备执行对应通道推送：iOS设备走APNs，Android走FCM，桌面端走WebSocket心跳通道。
