SuperAPI AI 工具集

relevance-coarse-filter

营销与增长

查看项目

更新于 10-15 17:10

技能介绍

用途

Relevance Coarse Filter 是 newsjacking 管道中的第一道低成本闸门,唯一职责是丢掉明显的垃圾信号,让后续昂贵的处理环节只运行在值得花费成本的信号上。它不负责排序或挑选最佳信号、撰写角度、研究报道最初出处(story-origin)、检查新鲜度或 24 小时截止线,也不决定是否进行 pitch,这些都交给后续环节(story-origin-check,以及检测器的完整判断)。

主要能力与判断逻辑

该技能一次针对一个信号、对照客户画像进行判断。每个信号提供:signal id、标题和摘要/证据;来源或 lane,以及检测器的 profile_matches;story_size.band(若有)以及低置信度的 story_size.attention_hint;客户画像(公司、主题、竞争对手、standing terms、监管机构/客户/类别)用于匹配。

“Standing terms”指与客户评论某话题的权利相关的词;“Bridge”指信号与客户之间的合理联系。

允许的决策有三种:keep(可能相关,继续传递)、monitor_only(值得关注但较弱或不清楚,标记但不丢弃)、reject(明显垃圾,丢弃)。允许的理由包括:relevant_news、plausible_client_bridge、major_news_no_bridge、keyword_collision、not_news、owned_docs_or_product_page、seo_landing_page、competitor_or_promotional、low_reach_x_post、safety_risk、duplicate、off_beat、no_profile_bridge。

判定细则

只拒绝明显的垃圾:关键词碰撞(词匹配但话题不匹配)、明显的非新闻、文档/产品/SEO 页面、常青内容、单条低触达的 X 帖子、安全风险钩子或明显偏离主题的项目。

任何画像匹配都会阻止以 no_profile_bridge 为由拒绝。如果客户、具名竞争对手、画像主题、standing term、画像指定的监管机构/客户/类别或直接同义词出现在标题、摘要、证据或 profile_matches 的任何位置,就不得以 no_profile_bridge 拒绝,应选择 keep 或 monitor_only。竞争对手即使不是标题也算数:如果报道涉及 Meta、中国、监管机构、收购方、合作方或受阻交易,但实际受影响的公司是画像中的竞争对手,就应保留进入下一阶段。

绝不拒绝重大新闻。对于高或重大 story_size.band 的信号,或未知大小但具有高/重大 story_size.attention_hint 的信号,最低只能到 monitor_only,即使完全没有 bridge。重大新闻始终值得呈现:敏锐的公关人员常能找到非显而易见的角度,该技能的职责是建议并让人类决定,而不是替其做丢弃判断。attention_hint 应视为低置信度的召回压力,而非广泛覆盖的证明。当 bridge 具体时用 keep;当 bridge 弱、缺失或可能是关键词碰撞时用 monitor_only,并在 reason 中记录真实理由(keyword_collision、off_beat、no_profile_bridge 等),因为报告用它来排序和标记建议(例如可能的 keyword-match 警告)。引擎也会以确定性方式执行该规则(big_story_recall),因此在此处 reject 是徒劳的:它无论如何都会被升级为 monitor_only。

对于中大型报道,倾向于广度。一个遥远但连贯的联系也应存活,让下游环节判断是否存在真正的切入点。

促销或自有内容很少胜出,但不要拒绝。这涵盖新闻稿(publication_type 为 brand_content 或 newswire,或带有电头的稿件摘要)以及供应商撰写的投稿或思想领导力文章,尤其是来自具名竞争对手的,因为 pitch 竞争对手自己的内容只会为其放大。不要以此为由拒绝:保持召回,让 triage 决定。将其标记为 monitor_only 并附理由 competitor_or_promotional,以便常设 triage 环节把关。上述重大新闻规则仍然优先:绝不拒绝高/重大级别的信号。只有当候选人中未出现任何画像实体、竞争对手、主题、standing term 或合理的买方/监管机构/类别时,才使用 no_profile_bridge,并需说明理由。

需引用证据,保留 evidence URLs;每个决策列出所使用的 URL。

引擎

该规则集可在两种引擎上运行,两者写入相同的 decisions 文件,之后的一切不变。

低成本 LLM worker(默认):worker 加载此文件并判断其负责的信号块。这是未配置其他方式时的路径。

Jev(TypeSafe AI),当存在密钥时:Jev 是一种类型化决策模型,用带概率的固定问题作答而非撰写文字,可在不到一秒内以极小成本判断一个信号。newsjack coarse-filter --engine jev 命令将此规则集翻译为六个类型化问题(decision、reason、is-it-news、profile bridge、promotional、safety risk),对每个信号调用一次 Jev,并应用确定性后置规则,使类型化答案无法破坏上述硬规则(画像匹配阻止 no_profile_bridge 拒绝,促销和安全敏感报道最低为 monitor_only,低置信度 reject 最低为 monitor_only)。重大新闻召回仍如之前一样留在 newsjack filter-apply 中。运行 newsjack coarse-filter --print-questions 可查看翻译,运行 newsjack help coarse-filter 查看用法。

当 newsjack doctor 显示 TypeSafe 已配置时选择 Jev,否则使用 worker 路径。Jev 决策携带以 Jev: 开头的 rationale 并列出原始概率,因为该引擎不提供文字理由;报告应如实展示而非粉饰。如果超过五分之一的 Jev 调用失败,该命令以非零退出,本次运行应回退到 worker 路径。

机器交接

该技能是运行在低成本模型或 Jev 上的管道阶段。决策被收集到 decisions 数组中并由 newsjack filter-apply 应用:keep 和 monitor_only 存活进入 story-origin 研究;reject 被丢弃。该技能不运行这一步。

管道将其输出作为原始 JSON 读取。每个信号恰好输出一个 JSON 对象,字段如下,只返回 JSON,前后无文字,无 Markdown 包裹:

{ "signal_id": "engine signal id", "decision": "keep | monitor_only | reject", "reason": "allowed reason", "rationale": "One short sentence explaining the filter decision.", "confidence": "high | medium | low", "evidence_urls": ["https://..."], "relevance_basis": "Why this is plausibly relevant or why it is junk." }