managing-subscriptions

管理订阅

订阅会按固定计划发送产品数据。 订阅支持洞察快照、仪表板快照和 AI 提示词报告。

阅读相关参考文档

• 选择或更改资源类型前，请阅读 subscription-types.md。
• 创建或更改目标位置前，请阅读 destinations.md。
• 有关计划、限制、计费、发送检查和失败情况，请阅读 operations.md。
• 创建提示词报告的详细工作流，请使用 creating-ai-subscription。

选择正确的产品

• 对于固定发送场景（例如“每周一发送此仪表板”），请使用订阅。
• 对于某个条件（例如“转化率低于 10% 时通知我”），请使用产品提醒。
• 如果用户希望稍后通过私有提示词查看某个资源，请使用提醒。
• 如果 Agent 需要判断哪些内容值得报告，请使用 Signals scout。

订阅不会评估阈值、恢复情况、连续违规或安静时段。 即使保存的结果没有变化，快照订阅也会尝试发送每次计划的内容。

工具

工具	用途
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	查找 Slack 集成
posthog:integrations-channels-retrieve	查找 Slack 频道
posthog:dashboard-get	读取仪表板图块
posthog:insight-get	解析洞察 ID

创建订阅

1. 调用 posthog:subscriptions-list 并检查是否存在重复项。
2. 从 subscription-types.md 中选择一种资源类型。
3. 根据 destinations.md 确定目标位置。
4. 根据 operations.md 确定计划。
5. 询问用户是否希望立即发送。
6. 根据用户的选择设置 send_test_now。
7. 调用 posthog:subscriptions-create。
8. 读取已保存的订阅，并检查每个请求的字段。
9. 如果用户批准了立即发送，请检查对应的发送记录。

如果创建操作超时或返回的结果不确定，请先列出匹配的订阅，再重试。 创建操作不是幂等的。 盲目重试可能会创建重复订阅，并发送重复的即时内容。

不要推断缺失的收件人、频道、时间或时区。 创建前请询问这些值。

查找现有订阅

如果下列列表筛选条件有助于减少歧义，请使用它们：

• resource_type：insight、dashboard 或 ai_prompt。
• target_type：email、slack 或 teams。
• insight 或 insights：一个洞察 ID，或以逗号分隔的 ID 列表。
• dashboard：一个仪表板 ID。
• dashboard_tiles：针对某个仪表板上实时图块的洞察订阅。
• created_by：一个创建者 UUID。

检查重复项

当用户提供了标题、洞察名称、仪表板名称或提示词文本时，使用 search。 提示词订阅会匹配其标题和提示词文本。 比较资源、目标类型、目标、计划和启用状态。

Teams 结果仅包含 webhook 主机。 一个主机可以服务多个频道。 不要使用主机来识别重复项。

对于可能匹配的 Teams 订阅，显示标题、计划、创建者和创建日期。 如果这些字段能够识别目标频道，请让用户选择订阅。 如果没有字段能够识别目标频道，请创建新订阅。

确认已保存的结果

创建后检查以下字段：

• resource_type 与 insight、dashboard 或 ai_prompt 相符。
• target_type 和安全目标标签与请求相符。
• enabled 为 true。
• next_delivery_date 与计划和时区相符。
• AI 和投递选项与用户的选择相符。

更改订阅

每次更新前，调用 posthog:subscriptions-retrieve。 进行可能发送投递的更新前，先列出当前投递 ID。 然后调用 posthog:subscriptions-partial-update，并传入已更改的字段。

进行可能立即发送投递的更新前，请先征求用户同意。 MCP 更新工具无法抑制这些更改触发的立即投递。 如果用户未批准投递，请勿进行更新。

• 设置 enabled: false 可暂停投递。
• 设置 enabled: true 可恢复投递。
• 更改接收方时，发送完整的新目标。
• 更改目标类型时，同时发送 target_type 和 target_value。
• 省略 target_value 可保留已保存的 Teams webhook URL。
• 替换 Teams webhook URL 时，发送完整的新 URL。

资源类型无法更改。 如果用户需要不同的资源类型，请创建新订阅。

更新计划后，检查新的 next_delivery_date。 计划耗尽后，只有用户延长或移除结束条件才能恢复。

发送投递的更新完成后，轮询是否出现新的 target_change 投递 ID。 读取该投递，直到其达到最终状态。 然后重新获取订阅，并检查其最终的 enabled 值。

测试和检查投递

1. 除非用户已请求测试，否则请先征求批准。
2. 列出当前投递 ID。
3. 调用 posthog:subscriptions-test-delivery-create。
4. 轮询是否出现新的手动投递 ID。
5. 如果列表结果需要更多详情，请读取新的投递。

轮询之间应等待一段时间，并在两分钟后停止。 如果投递未达到最终状态，请报告最后的状态，并建议稍后再次检查。

测试会发送真实消息。 工具会在投递排队后返回 202。 如果另一个测试正在进行，或者订阅已禁用，工具会返回 409。

投递状态包括 starting、completed、failed 和 skipped。 调查失败时，按 status 筛选投递列表。 工作流已排队并不能证明投递成功。 已完成的投递可能包含部分接收方失败的情况。 MCP 工具会隐藏各接收方的结果。 不要声称每位接收方都已成功收到消息。

停止订阅

确认订阅 ID 和安全目标标签。 除非用户已请求删除或取消订阅，否则请先征求批准。 然后调用 posthog:subscriptions-delete。

通过 MCP 删除属于单向软删除。 这会停止后续投递并释放一个计划名额。 如果用户之后还需要，请创建新订阅。

报告结果

• 说明资源类型、目标类型、计划和下次投递日期。
• 说明订阅是否已启用。
• 说明 AI 功能是否可能消耗 AI 积分。
• 除非用户需要确认，否则不要重复电子邮件地址。
• 绝不要重复 Teams webhook URL。

相关技能

• creating-ai-subscription：根据自由文本 AI 提示词创建报告。
• building-a-dashboard：订阅仪表板之前先创建仪表板。
• adding-product-alerting：当数据满足条件时通知用户。
• managing-reminders：安排私密提示词来检查资源。
• understanding-billing-usage：调查 PostHog AI 额度的使用情况。