提醒 API
重要事实:Lyncore 没有独立的 HTTP 提醒接口。在代码中全库检索
/api/reminders无任何路由命中。提醒(reminder)仅作为对话内的 MCP / 函数调用工具 存在,由 Agent 在对话中调用,没有对外暴露的 REST 端点。
如果你在旧文档中看到 GET/POST/PUT/DELETE /api/reminders,那属于过时且不符合代码的写法,请以本说明为准。
提醒能力的真实形态
- 对话内工具:提醒通过 Lyncore 内置的 reminder 工具在对话中创建与管理(例如「提醒我明天下午 3 点开会」)。它本质是 Agent 的函数调用,不是独立 API。
- 与调度器关系:需要「定时触发」的能力,走 调度器 API(
POST /api/v4/scheduler/create,两者都提供),可设定 cron/一次性触发并向通道推送。 - 与日历关系:日程类提醒可结合 CalDAV 日历(
/api/v4/...日历能力,见 邮件与日历指南)。
相关接口
| 能力 | 端点 | 说明 |
|---|---|---|
| 定时任务 | POST /api/v4/scheduler/create | 替代「定时提醒」的编程入口 |
| 日历事件 | CalDAV(见指南) | 日程类提醒 |
| 提醒工具 | 对话内 MCP 工具 | 由 Agent 在对话中调用 |
如需以编程方式实现「提醒」,建议在对话中通过工具完成,或使用调度器端点触发回调。