用途:创建 prompt 类型的 PostHog 订阅,即按 cron 周期用自由文本提示词生成 AI 报告,而非对已有 insight/dashboard 做固定快照。订阅分三种,按所设字段区分并体现为只读 resource_type:insight、dashboard、prompt(返回 ai_prompt)。本技能只覆盖 prompt 订阅的创建,生命周期管理用 subscriptions-* 系列工具(列出、编辑、禁用/重新启用、发送测试投递、删除)。
主要能力与工具:posthog:subscriptions-create 创建;subscriptions-list 确认并查看已有订阅;subscriptions-partial-update 编辑或禁用(enabled: false)与重新启用;subscriptions-test-delivery-create 立即测试投递;subscriptions-delete 软删除;integrations-list 查找 Slack integration_id(过滤 kind=slack);integrations-channels-retrieve 列出 Slack 频道(id 与名称)。
必要参数:prompt(≤4000 字符,仅设 prompt 即为 prompt 订阅)、target_type(email 或 slack,webhook 被拒)、target_value(逗号分隔邮箱,或 "<channel_id>|<channel_name>")、frequency(daily/weekly/monthly/yearly)、interval(1 为每次触发)、start_date(锚定重复规则与时点,无需在未来)、title。没有 resource_type 参数,类型由所设字段推导,返回为只读值。可选:byweekday(仅 weekly)、bysetpos(需与 byweekday 同用,如 monthly 的最后一个周一)、count、until_date、integration_id(Slack 必需)。Slack 目标需先用 integrations-list 取 id,再经 channels-retrieve 取频道,拼成 <id>|<name>,名称仅作展示。
使用前提(三项不满足会返回 400):PostHog Cloud 或 DEBUG=true,自托管生产部署不适用;组织级开启“AI data processing approved”(Org settings → Data → AI data processing);组织已开放 prompt 订阅(PostHog 管理的灰度开关,无自助开关,需联系 PostHog 开启)。访问令牌除 subscription:write 外还需 query:read,仅 subscription:write 会返回 403。
限制与注意事项:类型不可变更,创建后无法把 insight/dashboard 订阅改为 prompt(反之亦然)。重新启用被自动禁用的 prompt 订阅需两条前提:提示词有效(行内已持久化或 PATCH 中提供新的),且原始创建者仍是活跃用户,否则只能重建。next_delivery_date 由服务器根据 rrule 计算,只读不可手动设置;首次投递在 start_date 至少约 15 分钟后的第一个 occurrence 触发。瞬时失败(Slack 限流、SMTP 抖动、网络)会在本次运行内由 Temporal 重试并顺延到下一 tick,不会自动禁用;持续性失败的频道会每 tick 重试,直到修复。仅永久性问题(Slack 集成断开、频道权限被撤销、提示词无效、AI 数据处理同意被撤销)才自动禁用。多收件人邮件仅当全部失败才算失败;单次投递内渲染的 markdown 会缓存,重试不重跑 LLM,但每个新调度 tick 生成新报告。
创建后核对:subscriptions-list 中应有新行,resource_type 为 ai_prompt、enabled 为 true、next_delivery_date 在未来且 prompt 与提交一致。首个 tick 将执行 planner → HogQL → synthesis 流程并投递 Markdown。资料未提供具体定价信息。