ToShop文档Autopilot
长任务 —— 按时间排程、监听变化、事件触发、或定时单次。
Autopilot 把一个聊天目标变成一个持久任务。定义一次，Agent 就按时间、按变化、按 Webhook、按指定未来时间运行。结果发回聊天或你配的渠道。
触发器类型
类 cron 周期
标准 cron 表达式 + 可选时区。
目标: "发送过去 24h Shopify 订单摘要"
触发器: schedule
cron: "0 9 * * 1-5" # 工作日早 9 点
timezone: "America/Los_Angeles"适合：每日摘要、每周报告、定期商品审计。
一直看，有变化就跑
持续轮询（或订阅）状态变化，发现新东西就再跑一次。
目标: "GitHub 出现新的 priority:1 issue 时通知我"
触发器: reactive
sleepPolicy: "5m" # 轮询间隔
initialDelayMs: 0
maxTicks: 1000 # 安全上限wakeGate —— 仅在真有变化时唤醒
避免源没变也烧 Token。三种检测器：
http_diff—— 仅当 HTTP 响应内容变化时唤醒。rss_new—— 仅当 RSS 出新条目时。json_diff—— 仅当被监视的 JSON 路径值变化时。
外部事件触发
Webhook 或渠道事件，可带过滤条件。
目标: "总结并发布任何新工单"
触发器: event
event: "support.ticket.created"
filter: { "priority": ["high", "urgent"] }适合：工单分流、收件箱跟进、运维告警。
终止策略
任务何时停止运行？
goal_met—— Agent 判定目标已达成时停。count—— 跑了 N 次后停。deadline—— 到达指定时间戳时停。manual—— 仅你手动停。never—— 不定期（schedule典型）。
生命周期状态
scheduled—— 等下次触发。running—— 正在执行。paused—— 你暂停了（随时恢复）。completed—— 满足终止策略。failed—— 出错中断。cancelled—— 你归档了。
持久化
session —— 仅 ToShop 运行期间存在。适合"只在我电脑前时跑"。
durable —— 跨重启保留。schedule 或 event 触发的默认值。
结果投递到哪
配置一个或多个投递目标：
过长结果可由 Wrap response 开关包成摘要卡。
创建一个 Autopilot 任务
Autopilot → New task —— 结构化表单填目标 + 触发器 + 终止 + 投递。适合已经想清楚的任务。
在聊天里说一个目标。如果看起来像"重复 / 触发"工作，InlineCommitCard 弹出并提示"建一个 Autopilot 任务？" —— 调字段后确认。
适合：对话中浮现的、不想走表单的。
运行环境：桌面 vs 云
desktop—— 跑在本地应用里。快、免费，需 ToShop 开着。cloud—— 托管基础设施跑（Pro+）。电脑合上也继续触发。auto—— 按触发类型和套餐自动选。
权限
远程触发的网络白名单
来自机器外（渠道事件、Webhook）的触发，网络白名单 管控对外网络访问 —— 防止精心构造的远程 Prompt 触达你的私网。
Autopilot 任务继承 Agent 的权限。任务调用的技能和工具走同样的授权门 —— 运行中需要新权限时，任务暂停并向你弹通知（通过渠道），不会静默跳过。
套餐限制
| 套餐 | 投递目标数 | 云运行 |
|---|---|---|
| Free | 0（仅 Chat） | – |
| Pro | 1 | 是 |
| Team | 无限 | 是 |
抄作业模板
每日摘要
schedule "0 9 * * *" → "拉过去 24h Shopify 订单 → 总结 → 发到 #ops Discord"。
新闻监听
reactive + rss_new → "看这个 RSS，命中关键词 X 的就发"。
收件箱分流
event "email.new" → "若发件人在优先名单，总结后弹 Telegram"。
生日提醒
once "2026-09-14T08:00:00" → "邮件起草祝福"。