ToShopToShopドキュメントBeta
ToShopToShopドキュメントBeta
ホームToShop へようこそ

スタート

ToShop を使う

Agent OverviewルーチンReview & PermissionsPromptingSkills(スキル)Memories

パーソナライズ

ヘルプ

Agent

ルーチン

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 がいつ・どんな承認を求めるか。

Agent Overview

1 つのワークスペースに複数の Agent —— それぞれが独自のパーソナリティ、Skills、コネクション、メモリを持ちます。

Review & Permissions

ToShop がシステムに触れるすべてのアクションをあなたの承認の後ろにゲートする仕組みと、ルールの管理方法。

目次

いつ走らせる?On a scheduleWatch continuouslyWhen something happensOnce at a timeいつ止める?実行状態永続化結果の届け先routine の作成どこで動くか権限コピーして使える例関連