并行监控器（Parallel Monitor）

持续在 Web 上追踪变更。监控器是一种周期性执行的研究任务，按设定频率（每小时 / 每日 / 每周 / 每两周）运行，并在每个周期生成一个事件。可选地，将事件投递至 Webhook。

适用场景

当用户提出以下请求时，触发本技能：

• “监控 [某事物]”、“追踪 [某事物] 的变更”、“关注 [某网页/主题]”
• “当 [X] 发生变更 / 新增文件 / 上线发布 / 发布内容时提醒我”
• “持续关注 [定价页面 / 竞品动态 / SEC 报告]”
• 需自动重复执行、无需重新提示的周期性研究任务

一次性查询请使用 Search；需要长期持续观测时，请使用 Monitor。

快速开始

parallel-cli monitor create "追踪 iPhone 16 Pro 的价格变动" --json

CLI 参考文档

基础用法

parallel-cli monitor create "<目标描述>" [选项]
parallel-cli monitor list --json
parallel-cli monitor get mon_xxx --json
parallel-cli monitor update mon_xxx [选项] --json
parallel-cli monitor delete mon_xxx
parallel-cli monitor events mon_xxx --json
parallel-cli monitor simulate mon_xxx --json

常用参数（create / update）

示例

创建基础监控器（默认每日执行）：

parallel-cli monitor create "追踪特斯拉发布的最新 SEC 文件" --json

每小时执行并投递至 Webhook 的监控器：

parallel-cli monitor create "AI 领域新融资公告" 
  --cadence hourly 
  --webhook https://example.com/hooks/funding 
  --json

支持结构化输出的监控器：

parallel-cli monitor create "追踪 apple.com 上 iPhone 16 Pro 的定价信息" 
  --output-schema '{"properties":{"price_usd":{"type":"number"},"in_stock":{"type":"boolean"}}}' 
  --json

列出已存在的监控器（默认返回前 10 条）：

parallel-cli monitor list --json

查看某监控器产生的事件：

parallel-cli monitor events mon_xxx --json

不等待真实执行周期，直接测试 Webhook 投递：

parallel-cli monitor simulate mon_xxx --json

（simulate 要求该监控器已配置 --webhook；否则将报错。）

更新已有监控器的执行频率：

parallel-cli monitor update mon_xxx --cadence weekly --json

删除一个监控器：

parallel-cli monitor delete mon_xxx

最佳实践：Prompt 编写规范

目标描述（Objective）

用 1–3 句话清晰说明以下内容：

• 监控器应检测的信号类型（例如：“价格变动”、“新增申报文件”、“网站宕机”）
• 何为“变更”（数值阈值变化、新实体出现、状态翻转等）
• 如有必要，注明首选数据源（例如：“来自 sec.gov”、“取自官方定价页面”）

执行频率（Cadence）

选择能及时捕获信号的最慢频率：

• hourly —— 突发新闻、价格波动、状态页更新
• daily（默认）—— 大多数常规持续追踪场景
• weekly / every_two_weeks —— 变更节奏较慢的主题，如监管申报、高管人事变动

输出 Schema（可选）

若需每次事件输出结构化数据（例如 {price_usd, in_stock}），请提供 JSON Schema。Monitor API 将在每个周期中按该 Schema 填充字段，便于下游自动化处理。

响应格式

monitor create 和 monitor list 返回包含如下字段的 JSON：

• monitor_id —— 如 mon_xxx
• objective —— 自然语言描述的目标
• cadence —— 当前执行频率
• webhook —— 投递地址（如已设置）
• created_at / updated_at —— 创建与更新时间戳
• last_event_at —— 最近一次事件发生时间戳（如存在）

monitor events 返回一个对象数组，每个对象含 {event_id, observed_at, output} 字段。

输出处理建议

向用户传递监控器结果时，请注意：

• 始终回显 monitor_id，方便用户后续管理该监控器
• monitor list 默认添加 -n 10 限制，避免在长期运行的工作区中产生超大体积输出
• 对 events 输出，应汇总多个周期的趋势，而非仅呈现最新一次事件

上下文不足怎么办？

对于长时间运行的监控器管理会话，建议保存状态并使用 sessions_spawn：

parallel-cli monitor list --json -o /tmp/monitors.json

随后启动子智能体：

{
  "tool": "sessions_spawn",
  "task": "读取 /tmp/monitors.json 并生成按执行频率分组的活跃监控器摘要报告。",
  "label": "monitor-summary"
}

错误处理

前提条件

需已安装并完成身份验证的 parallel-cli。若执行 parallel-cli --version 失败，或后续命令因鉴权失败而报错，请提示用户查阅 https://docs.parallel.ai/integrations/cli 并终止当前流程。

参考资料

• API 文档
• Monitor API 参考文档