配置源监视
使用现有的 Synoptic 数据流及其支持的目标配置来设置监视。创建发布流并不会自动设置抓取器。不同数据流在覆盖范围、目标格式、更新速度、延迟和账户限制上有所差异。
选择监视器和目标
使用 search 查找候选数据流,然后用 get_stream 检查它们。用于账户帖子、搜索查询、关注/取消关注或资料变更的社交媒体数据流不覆盖其他类型。Telegram 频道和 GitHub 仓库活动需要它们对应的提供方数据流。对于新闻、备案、政府发布以及其他事件类数据流,请使用 read-streams 技能中的源家族。
对于可配置的数据流,请阅读 customTargetsData.targetType、targetTypeInstruction、targetValidationRegex 以及目标数量限制。使用所需数据流要求的语法和大小写。用户名、数字账户 ID、频道 URL、仓库路径、关键词、标签、股票标签和完整搜索表达式不可互换。没有身份查找工具;不要从显示名称推断数字 ID。在写入之前,请从用户或经过验证的源获取缺失的标识符。正则表达式匹配仅验证语法,不验证身份或源的可用性。
如果现有的数据流已覆盖请求内容且无需自定义目标,请在用户设置请求授权的情况下关注它。如果没有合适的可配置数据流,请说明缺少什么。如果用户要求发送自定义流请求,请使用 request-stream-or-feature 技能;提交的请求不是活动监视器。
保存选择
使用 streams_following 检查现有的关注情况。如果用户要求监视一个他们有资格关注但尚未关注的数据流,请先调用 follow_stream,然后再读取其目标选择。然后使用 get_stream_custom_targets 读取当前目标。关注者拥有自己的选择;所有者拥有所有关注者目标的并集,不得复制为个人选择。报告权限或目标数量错误;不要替换为不同的监视器。
更改目标需要直接订阅该数据流并拥有目标配额。仅有关注、套餐访问或组织访问是不够的。使用 subscriptions.read 和 get_stream_subscription 查看直接订阅及其目标配额。如果缺少权益,请说明在 Synoptic 中如何设置;这些工具无法购买它。
使用带有 add 或 remove 参数的 patch_stream_custom_tarets 进行局部更改。set_stream_custom_targets 会替换整个选择;空列表会清除所有目标。保留不相关的目标。已移除目标对应的帖子将停止到达用户;开放 Synoptic 应用的数据流在重新连接后会应用更改。已移除的目标随后会从用户有限制到特定目标的收集中移除;如果一个源在移除后没有剩余目标,它会被删除。get_stream_custom_targets 需要 streams.read 权限;set_stream_custom_targets 需要 following.write 和 workspace.write;patch_stream_custom_targets 还需要 following.read。
使用 manage-workspace 技能在仪表板中组合数据流,并应用包含/排除关键词、正则表达式或 AI 过滤器。收集过滤器会更改出现在收藏中的帖子,而非抓取器的目标。
报告已建立的内容
从工具结果中确认已保存的目标,并在相关时使用 get_stream_posts 检查最近的更新。报告已达到的阶段:找到数据流、获得访问权限、保存目标、配置收藏或观察到匹配的帖子。空的历史页面不能证明失败,旧的匹配帖子也不能证明新目标正在收集。没有工具报告抓取器健康状态。
若要交付到其他应用程序,请使用 connect-feed-to-app 技能。在此对话中阅读帖子不会启动后台监视或保持外部消费者连接。