ToShop文档例行任务
你交给 Agent 的长任务 —— 按时跑、看见变化跑、等事件跑、或在未来某个时间跑一次。
例行任务 把一个聊天目标变成一个持久任务。你描述一次想要的事情，Agent 就帮你持续完成 —— 按时、监视变化、事件触发、或者在你指定的时间跑一次。结果回到聊天里，或者送到你配的连接上。
什么时候让它跑？
例行任务 有四种触发类型 —— 选最符合你需求的那种：
按时间
选个时间（每天 9:00、每周五下午、每月 1 号），Agent 到点就跑这个任务。
goal: "发送过去 24h Shopify 订单摘要"
trigger: schedule
cron: "0 9 * * 1-5" # 工作日早 9 点
timezone: "America/Los_Angeles"适合：每日摘要、每周报告、定期商品审计。
持续监视
Agent 持续检查一个源。一旦发现新东西，就跑。
goal: "GitHub 出现新的 priority:1 issue 时通知我"
trigger: reactive
sleepPolicy: "5m" # 轮询间隔
initialDelayMs: 0
maxTicks: 1000 # 安全上限只在真有变化时唤醒
为了不把 Token 烧在没变化的源上，Agent 只在真的发生变化时才跑。可以监视：
- 一个网页 —— 只在内容变化时关心。
- 一个 RSS 源 —— 只在出新条目时关心。
- 一个 JSON 端点 —— 只在被监视字段变化时关心。
事件触发
Agent 等一个事件 —— 新邮件、Webhook、Shopify 事件 —— 触发后跑。
goal: "总结并发布任何新工单"
trigger: event
event: "support.ticket.created"
filter: { "priority": ["high", "urgent"] }适合：工单分流、收件箱跟进、运维告警。
什么时候停？
每个 routine 都有一个 Stop when（停止条件）：
- Agent 说完成了 —— Agent 判定目标已达成时停。
- 跑了 N 次后 —— 你指定的次数后停。
- 到达指定时间 —— 到指定时间停。
- 我自己来停 —— 只有你手动停。
- 一直跑下去 —— 不停。定时类的常用选项。
运行状态
routine 活着的时候会处于以下状态之一：
- 等下一次运行 —— 已排程，空闲。
- 正在运行 —— 正在跑。
- 已暂停 —— 你暂停了，可随时恢复。
- 完成 —— 满足了停止条件。
- 失败 —— 中途出错。
- 已取消 —— 你归档了。
持久化
仅本次会话 —— 只在 ToShop 运行期间存在。适合"只在我电脑前时跑"的一次性任务。
跨重启保留 —— 跨重启保留。定时和事件型的默认值。
结果投递到哪
为 Agent 配一个或多个投递目标：
过长结果可由 Wrap response 开关包成摘要卡。
创建一个 routine
打开页面左边栏的 例行任务 入口 → New task —— 结构化表单填目标 + 触发器 + 停止条件 + 投递。适合已经想清楚的任务。
在聊天里说一个目标。如果看起来像"重复/触发"工作，会弹出 Lock it in（锁定）卡片把它做成 routine —— 调字段后确认。
适合：对话中浮现的、不想走表单的。
运行环境
每个 routine 可以只在我的电脑跑、只在云上跑、或哪里能跑都行（电脑可用就跑电脑，否则跑云上）。
- 只在我的电脑跑 —— 跑在本地应用里。电脑离线就等着。
- 只在云上跑 —— 服务器侧跑。电脑合上也继续触发。
- 哪里能跑都行 —— 优先你的电脑，3 秒内拉不起再走云上。
权限
例行任务 继承 Agent 的权限。任务调用的技能和工具走同样的授权门 —— 运行中需要新权限时，任务暂停并向你弹通知（通过连接），不会静默跳过。
抄作业模板
每日摘要
每个工作日早 9 点 → "拉过去 24h Shopify 订单 → 总结 → 发到 #ops Discord"。
新闻监听
监视一个 RSS → "命中关键词 X 的发到 Telegram"。
收件箱分流
新邮件到达时 → "若发件人在优先名单，总结后弹 Telegram"。
生日提醒
9 月 14 日早 8 点单次 → "邮件起草生日祝福"。