ルーチン
Agent に任せる長時間タスク —— スケジュール実行、変化の監視、イベント発火、未来の特定時刻に一度きり。
ルーチン はチャットのゴールを永続的なタスクに変えます。一度だけやりたいことを伝えれば、Agent がそれを継続して実行します —— スケジュール、変化の監視、イベント、または指定した時刻の一度きり。結果はチャットに戻る、または設定したコネクションに届きます。
いつ走らせる?
ルーチン のトリガーは 4 種類です。やりたいことに合うものを選んでください:
On a schedule
時刻を決めると(毎日 9:00、毎週金曜の午後、毎月 1 日など)、Agent がその時刻にタスクを実行します。
goal: "Send a digest of last 24h Shopify orders"
trigger: schedule
cron: "0 9 * * 1-5" # 9am, weekdays
timezone: "America/Los_Angeles"向き: 日次ダイジェスト、週次レポート、定期的なカタログ監査。
Watch continuously
Agent がソースを継続的にチェックします。新しいものを見つけたタイミングで実行します。
goal: "Notify me when a new GitHub issue with label priority:1 arrives"
trigger: reactive
sleepPolicy: "5m" # poll cadence
initialDelayMs: 0
maxTicks: 1000 # safety cap実際の変化があるときのみ実行
変化のないソースをチェックしてトークンを浪費しないよう、Agent は実際に何かが動いたときだけ発火します。監視できるものは:
- 内容が変わったときだけ気にしたい Web ページ。
- 新しい項目が増えたときだけ気にしたい RSS フィード。
- 監視中の値が変わったときだけ気にしたい JSON エンドポイント。
When something happens
Agent がイベントを待ち受け —— 新着メール、Webhook、Shopify イベントなど —— 発火したら走ります。
goal: "Summarize and post any new support ticket"
trigger: event
event: "support.ticket.created"
filter: { "priority": ["high", "urgent"] }向き: チケットトリアージ、受信箱のフォローアップ、運用アラート。
Once at a time
未来の特定時刻に一度だけ実行するタスクです。
goal: "Remind me to renew domain"
trigger: once
fireAt: "2026-11-15T09:00:00-08:00"向き: 日付付きリマインダー、予約された下書き。
いつ止める?
各 routine には Stop when(停止条件)があります:
- Agent が完了と判断したとき —— Agent がゴール達成と判断した時点で停止。
- N 回実行したあと —— 指定回数を超えたら停止。
- 特定時刻に —— 指定したタイムスタンプで停止。
- 自分で止める —— あなたが停止したときだけ止まります。
- ずっと走らせる —— 無期限。スケジュール型では一般的です。
実行状態
routine が生きている間は次のいずれかの状態が表示されます:
- Waiting for next run —— スケジュール待ち。
- Running —— いま動いている。
- Paused —— 一時停止中。いつでも再開できます。
- Completed —— 停止条件を満たした。
- Failed —— 実行中にエラーが発生。
- Cancelled —— あなたがアーカイブした。
永続化
Session only —— ToShop の実行中のみ存在します。「席にいる間だけ」のワンオフ routine に最適。
Saved across restarts —— 再起動後も保持されます。スケジュール型・イベント型のデフォルトです。
結果の届け先
Agent が結果を送る場所を 1 つ以上設定します:
Chat スレッド
起点となる Agent のメインチャット(デフォルト)。
Telegram
Telegram コネクション経由で特定のチャネル/ユーザーへ。
Discord
Discord コネクション経由で特定のチャネル/スレッドへ。
長い結果は Wrap response トグルでサマリーカードにまとめられます。
routine の作成
左サイドバーの ルーチン タブ → New task を開きます。ゴール、トリガー、停止条件、投送先を入力する構造化フォームが出ます。すっかり練り上げたタスクに最適です。
チャットでゴールを打ち込みます。繰り返しまたはトリガー駆動のジョブのように見える場合、Lock it in カードが現れて routine 化を提案します —— フィールドを調整して確定してください。
向き: 会話の中で自然に浮かんだ、軽い感じのもの。
どこで動くか
各 routine は 自分のコンピュータでだけ、クラウドでだけ、または 動ける場所どこでも(コンピュータが使えればそちら、無理ならクラウド)で動かせます。
- 自分のコンピュータでだけ —— ローカルアプリで実行。オフラインなら待機します。
- クラウドでだけ —— サーバー側で実行。ラップトップを閉じても発火し続けます。
- 動ける場所どこでも —— まず自分のコンピュータ、3 秒で立ち上がらなければクラウドにフォールバック。
権限
ルーチン は Agent の権限を継承します。タスクが呼び出そうとする Skills とツールは同じ承認ゲートを通ります —— 実行中に新しい権限が必要になると、タスクは黙ってスキップせず、一時停止して(コネクション通知で)あなたに知らせます。
コピーして使える例
日次ダイジェスト
平日朝 9 時 → "過去 24h の Shopify 注文を取得し、要約して #ops Discord に投稿"。
ニュースウォッチャー
RSS を監視 → "キーワード X に一致するものを Telegram に投稿"。
受信箱トリアージ
新着メールが届いたら → "送信者が優先リストに含まれていれば、要約して Telegram に通知"。
誕生日リマインダー
9 月 14 日朝 8 時に 1 回 → "'お誕生日おめでとう' メールの下書きを作成"。
関連
- 接続 —— routine の結果が届く場所。
- Permissions —— Agent がいつ・どんな承認を求めるか。
ToShopドキュメント