SuperAPI AI 工具集

creating-ai-subscription

数据与分析

查看项目

更新于 10-16 03:44

技能介绍

用途:创建 prompt 类型的 PostHog 订阅,即按周期(每日/每周/每月/每年)用自由文本提示词触发 LLM 生成一份新的 AI 报告,并通过邮件、Slack 或 Microsoft Teams 投递。订阅有三种,按设置的字段区分并返回只读的 resource_type:insight(已有洞察快照)、dashboard(仪表盘快照)、prompt(AI 生成报告,resource_type 为 "ai_prompt")。若只是想定期收到已有洞察或仪表盘的关键数字,应优先用 insight/dashboard 订阅(可配 summary_enabled: true),prompt 订阅最重,且 LLM 自写 HogQL 可能与已保存图表数字有偏差。

主要能力与工具:posthog:subscriptions-create 创建;subscriptions-list 确认与查看;subscriptions-partial-update 编辑/禁用/重新启用;subscriptions-test-delivery-create 发送测试投递;subscriptions-delete 软删除;integrations-list 与 integrations-channels-retrieve 用于查找 Slack 集成与频道。

必要参数:prompt(≤4000 字符,设置它且不设 insight/dashboard 即为 prompt 订阅)、target_type(email/slack/teams)、target_value、frequency(daily/weekly/monthly/yearly)、interval、start_date(锚定周期与时间,支持整点与半点)、title、send_test_now。可选:byweekday、bysetpos、count、until_date、integration_id(仅 Slack 必填)。Slack 的 target_value 格式为 <channel_id>|<channel_name>。Teams 的 target_value 为完整 https webhook URL,且不要传 integration_id。

限制与注意事项:创建时有三项硬性门槛——须为 PostHog Cloud 或 DEBUG=true;组织需开启 "AI data processing approved";组织需被开放 prompt 订阅(无自助开关,需联系 PostHog)。访问令牌还需 query:read 与 subscription:write。创建非幂等,超时后先 list 再重试。订阅类型不可事后更改。next_delivery_date 只读,由 rrule 计算。瞬时投递失败会重试,仅永久性失败自动禁用。Teams webhook URL 属凭据,不应回显或写入确认信息。

适用场景:用户明确要求 AI 撰写的周期报告,且现有洞察/仪表盘无法覆盖。