SuperAPI AI 工具集

managing-reminders

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:该技能用于在 PostHog 中创建和管理提醒(reminder)。提醒是发给自己的私人定时提示,按计划触发应用内通知,不附带任何条件判断,可选关联一个 PostHog 资源。

适用触发场景:用户说“提醒我”“别让我忘了”,需要某个具体日期时间的一次性提醒,需要每天/每周/每月等周期提醒,需要被提醒去查看某个仪表盘、洞察、实验、功能开关、问卷、笔记本、回放或错误,或需要查看、修改、取消已有提醒。

与 alert、subscription 的区别:有阈值或异常条件要评估的是 alert;要按计划投递导出或快照的是 subscription;只是对人的定时提示才是 reminder。

必填字段:每次创建都必须包含 organization(组织 UUID,用 organization-get 获取,不要猜测)和 title(通知标题)。已知项目时应设置 team(数字项目 ID),关联资源时 team 必填。

调度方式:scheduled_at、recurrence_interval、cron_expression 三者必须且只能选一个。scheduled_at 为未来 ISO 8601 时间戳,触发一次后变为 completed;recurrence_interval 可选 daily、weekly、monthly、yearly;cron_expression 为 5 段 cron(分 时 日 月 周),用于预设无法表达的星期或时间,如每周一 9 点用 "0 9 * * 1"。每天最多触发 4 次,更频繁的 cron 会被拒绝。

时区:已知用户 IANA 时区时应传入,否则在设置 team 时默认项目时区,未设置则默认 UTC。

关联资源:需同时设置 resource_type、resource_id、team,resource_id 一律以字符串传入。resource_type 可为 dashboard(数字 id)、insight(short_id)、experiment(数字 id)、feature_flag(数字 id)、survey(id)、notebook(short_id)、replay(session_id)、error_tracking(issue id)。用户给名称或 URL 时需先解析出 id。

隐私与生命周期:提醒仅创建者可见,属于组织、可选限定项目;以应用内通知触发,不走邮件、Slack 或 webhook;一次性提醒触发后完成;周期提醒保持活跃直到删除或 end_date 到期;一次性提醒投递永久失败会变为 errored。

MCP 工具:reminder-create、reminders-list、reminder-get、reminder-update、reminder-delete。修改调度会重新计算下次触发时间。创建后可用响应中的 next_fire_at 向用户确认下次触发时间。