ToShopドキュメントAutopilot
長時間タスク —— スケジュール、変更への反応、イベント発火、または将来の特定時刻の単発実行。
Autopilot はチャットのゴールを永続的なタスクに変えます。一度定義すれば、Agent はスケジュール、変更時、Webhook イベント、または特定の将来時刻に実行します。結果はチャットまたは設定したチャネルに戻ります。
トリガータイプ
cron 風の繰り返し
標準 cron 式と任意のタイムゾーン。
goal: "Send a digest of last 24h Shopify orders"
trigger: schedule
cron: "0 9 * * 1-5" # 9am, weekdays
timezone: "America/Los_Angeles"向き: 日次ダイジェスト、週次レポート、定期的なカタログ監査。
監視し続け、変化で発火
状態変化を継続的にポーリング（またはサブスクライブ）し、新しいものが検出されたら再実行します。
goal: "Notify me when a new GitHub issue with label priority:1 arrives"
trigger: reactive
sleepPolicy: "5m" # poll cadence
initialDelayMs: 0
maxTicks: 1000 # safety capwakeGate —— 実際の変化があるときのみ実行
変化していないソースの確認でトークンを消費するのを避けます。3 種類の検出器:
http_diff—— HTTP レスポンスのコンテンツが変化したときのみ。rss_new—— RSS フィードに新しいアイテムが現れたときのみ。json_diff—— 監視中の JSON パスの値が変化したときのみ。
外部イベントで発火
Webhook またはチャネルイベント、任意のフィルター付き。
goal: "Summarize and post any new support ticket"
trigger: event
event: "support.ticket.created"
filter: { "priority": ["high", "urgent"] }向き: チケットトリアージ、受信箱のフォローアップ、運用アラート。
特定時刻に発火
一度きりの将来タスク。
goal: "Remind me to renew domain"
trigger: once
fireAt: "2026-11-15T09:00:00-08:00"向き: 日付付きリマインダー、予約された下書き。
終了ポリシー
タスクはいつ停止すべきか？
goal_met—— Agent がゴールが達成されたと判断したときに停止します。count—— N 回の実行後に停止します。deadline—— 特定のタイムスタンプで停止します。manual—— あなたが停止したときだけ止まります。never—— 無期限（scheduleに典型的）。
ライフサイクル状態
scheduled—— 次のトリガーを待機中。running—— 実行中。paused—— 一時停止中（いつでも再開可）。completed—— 終了ポリシーが満たされた。failed—— エラーで中断した。cancelled—— アーカイブした。
永続化
session —— ToShop の実行中のみ存在します。「席にいる間だけ」のワンオフタスクに最適。
durable —— 再起動後も保持されます。schedule または event トリガーのデフォルトです。
結果の届け先
1 つ以上の 投送先を設定します:
Chat スレッド
起点となる Agent のメインチャット（デフォルト）。
Telegram
Telegram チャネル経由で特定のチャネル/ユーザーへ。
Discord
Discord チャネル経由で特定のチャネル/スレッドへ。
長い結果は Wrap response トグルでサマリーカードにまとめられます。
Autopilot タスクの作成
Autopilot → New task —— ゴール + トリガー + 終了 + 投送のための構造化フォーム。完全に練り上げたタスクに最適。
チャットでゴールを打ち込みます。繰り返しまたはトリガー駆動のジョブのように見える場合、InlineCommitCard に「Create Autopilot task?」が表示されます —— フィールドを調整して確定してください。
向き: 会話の中で浮上した、軽い感じのもの。
ランタイム: デスクトップ vs クラウド
desktop—— ローカルアプリで実行します。速くて無料、ToShop が開いている必要があります。cloud—— マネージドインフラで実行（Pro+）。ラップトップを閉じても発火し続けます。auto—— トリガータイプとプランに基づいて自動選択します。
権限
リモートトリガー実行の許可リスト
マシン外からトリガーされるタスク（チャネルイベント、Webhook）に対しては、ネットワーク許可リストが外向きネットワークアクセスをゲートします —— 細工されたリモートプロンプトがプライベート IP に到達するのを防ぎます。
Autopilot タスクは Agent の権限を継承します。タスクが呼び出そうとする Skills とツールは同じ承認ゲートを通ります —— 実行中に新しい権限が必要になると、タスクは黙ってスキップせず、一時停止して（チャネル通知で）あなたに知らせます。
プラン制限
| プラン | 投送先数 | クラウドランタイム |
|---|---|---|
| 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" → "'お誕生日おめでとう' メールの下書きを作成"。
関連
- How Tasks Work —— 同じ Agent ループ、異なる入口。
- Channels —— Autopilot の結果が届く場所。
- Permissions —— 許可リストがリモートトリガー実行をどうゲートするか。