SuperAPI AI 工具集

managing-subscriptions

智能体与模型

查看项目

更新于 10-16 03:45

技能介绍

用途:管理 PostHog 订阅,按固定计划投递产品数据,支持洞察快照、仪表盘快照和 AI 提示报告。订阅不评估阈值、恢复、连续违规或静默时段;快照订阅即使结果未变化也会按计划尝试投递。

主要能力:通过 MCP 工具完成订阅全生命周期管理,包括 posthog:subscriptions-list(查找)、posthog:subscriptions-retrieve(读取单个)、posthog:subscriptions-create(创建)、posthog:subscriptions-partial-update(修改、暂停、恢复)、posthog:subscriptions-test-delivery-create(测试投递)、posthog:subscriptions-deliveries-list 与 posthog:subscriptions-deliveries-retrieve(查看投递)、posthog:subscriptions-delete(停止未来投递)。还可借助 posthog:integrations-list、posthog:integrations-channels-retrieve 查找 Slack 集成与频道,用 posthog:dashboard-get、posthog:insight-get 解析仪表盘与洞察 ID。

使用方式:创建前先读取 subscription-types.md、destinations.md、operations.md 等参考,选择资源类型、解析目标与计划,询问是否需要立即投递并设置 send_test_now,再调用创建工具。创建后核对资源类型、目标、启用状态、下次投递时间等字段。修改前先 retrieve,可能触发投递的更新需先征得同意;暂停设 enabled:false,恢复设 enabled:true。测试投递会发送真实消息,返回 202 表示已排队,409 表示已有测试或订阅被禁用;投递状态包括 starting、completed、failed、skipped。删除为单向软删除,会停止未来投递并释放计划名额。

适用场景:需要按固定时间发送仪表盘、洞察或 AI 提示报告时使用;条件触发应改用产品告警,私有提醒用 reminder,由智能体判断重要性用 Signals scout。

限制:创建非幂等,超时或结果不确定时先列出匹配订阅再重试,避免重复。不得推断缺失的收件人、频道、时间或时区。Teams 结果仅含 webhook 主机,不能据此判断重复,且报告中不得重复 Teams webhook URL。MCP 工具隐藏逐收件人结果,completed 也可能包含部分失败,不能声称每位收件人均成功。轮询投递需间隔等待,两分钟后停止并报告最后状态。资源类型不可更改,需新建订阅。