logo
Development
検索
スケジュールタスク NEW

スケジュールタスク NEW

概要

スケジュールタスク(Scheduled Tasks)は、Agent に事前設定したタスクを自動的に定期実行させる機能です —— 手動で対話を開始する必要はありません。デスクトップ APP 独自の機能です。

典型的なシナリオ:

  • 毎日 9:00 に競合他社 5 社の公式サイトを取得し、変化を比較して DingTalk に送信
  • 毎週月曜 18:00 に Gmail から今週の「契約」関連メールをすべて検索し、Excel にまとめて上司にメール送信
  • 30 分ごとにメールをチェックし、緊急メールがあれば WeChat で通知
  • 毎月 1 日に先月のチーム業務サマリーレポートを生成

スクリーンショット位置


入口

デスクトップ APP → 左側の設定メニュー → スケジュールタスク


3 つのスケジュールモード

モード 英語識別子 説明 設定
一回限り at 指定した時点に一度だけ実行 日時を選択
周期 interval 固定間隔で繰り返し実行 間隔数 + 単位(分/時間/日)
Cron cron 標準的な Cron 式 5 フィールドの Cron(例:0 9 * * 1 = 毎週月曜 9:00)

よく使う Cron 式

意味
0 * * * * 毎時 0 分
0 9 * * * 毎日 9:00
0 9 * * 1 毎週月曜 9:00
0 0 1 * * 毎月 1 日 0:00
*/15 * * * * 15 分ごと
0 9-18 * * 1-5 平日 9:00-18:00 の毎時

実行モード

タスク作成時に実行方式を選択します:

モード 説明
normal 実行のたびに同一の永続セッションを共用
isolated 実行のたびに独立したセッションを新規作成し、互いに干渉しない
persistent 永続セッションで、履歴コンテキストを保持
selected 指定した既存セッションを使用

選択の目安

  • 互いに独立したタスク(毎日の監視など) → isolated
  • Agent に以前の結果を記憶させたい場合(継続的にフォローするプロジェクトなど) → persistent
  • 既存セッションのコンテキストを再利用する必要がある場合 → selected

通知設定

タスクの実行完了後、さまざまなチャネルで通知を受け取れます:

通知チャネル 要件
Telegram 事前に Telegram チャネルの設定が必要
DingTalk 事前に DingTalk チャネルの設定が必要
Feishu Feishu の webhook 設定が必要
企業 WeChat 企業 WeChat の webhook 設定が必要
Slack 事前に Slack チャネルの設定が必要
Teams 事前に Teams チャネルの設定が必要
Discord 事前に Discord チャネルの設定が必要
メール 受信メールアドレスを入力

チャネル設定の詳細は チャネル設定 を参照してください。

通知内容:タスクの実行ステータス(成功/失敗)+ 簡易サマリーまたは完全な出力


タスク詳細ページ

各タスクの詳細ページには以下が含まれます:

エリア 内容
基本情報 名称、説明、作成者、作成日時
スケジュール設定 モード(at/interval/cron)+ パラメータ
実行モード normal / isolated / persistent / selected
タスク Prompt Agent が毎回実行する指示内容
通知設定 有効化された通知チャネルの一覧
実行ステータス nextRunAtMslastRunAtMslastStatuslastDurationMs、連続失敗回数
実行履歴 各実行の個別レコード(ステータス、開始日時、継続時間、エラーログ)

実行履歴(AllRunsHistory)

各タスクには独立した実行履歴テーブルがあります:

説明
実行日時 その実行の開始日時
ステータス 成功 / 失敗 / タイムアウト / 中断
継続時間 実行に要した時間
結果サマリー 出力の先頭数文字
エラー情報 失敗時のエラースタック(展開可能)

日時、ステータスによるフィルタリングに対応しています。


操作ガイド

スケジュールタスクを作成する

  1. APP を開く → 設定 → スケジュールタスク
  2. + 新規タスク をクリック
  3. 基本情報を入力:
    • 名称:例「毎日競合監視」
    • 説明:簡単な説明
  4. スケジュールモードを選択:
    • 一回限り:日時を選択
    • 周期:間隔数と単位を入力
    • Cron:Cron 式を入力
  5. タスク Prompt を入力:
    以下の 3 つの競合他社の公式サイトのトップページを取得し、 昨日と今日の変化(新製品、新しいお知らせ、新しい価格設定)を比較し、 変化のサマリーを出力してください: - 競合 A: https://... - 競合 B: https://... - 競合 C: https://...
                          
                          以下の 3 つの競合他社の公式サイトのトップページを取得し、
    昨日と今日の変化(新製品、新しいお知らせ、新しい価格設定)を比較し、
    変化のサマリーを出力してください:
    - 競合 A: https://...
    - 競合 B: https://...
    - 競合 C: https://...
    
                        
    このコードブロックをポップアップで表示
  6. 実行モードを選択(通常は isolated を選択)
  7. 通知チャネルを設定(DingTalk など)
  8. 保存

手動で一度トリガーする

タスク一覧でタスク行の 今すぐ実行 ボタンをクリックすると、手動で一度実行をトリガーできます(次回の予定実行時刻には影響しません)。

タスクの一時停止 / 再開

タスク詳細ページに 有効化/無効化 スイッチがあります。無効化するとタスクのスケジュールが停止しますが、設定は保持され、いつでも再開できます。


組織の分離

スケジュールタスクは orgId で分離されます —— 自分が所属する組織のタスクのみ表示できます。組織を切り替えると、タスク一覧も切り替わります。

アカウント切り替えの影響:現在ログインしているユーザーが変更された場合(アカウントをまたいで切り替えた場合)、セッション中のタスクは終了しませんが、以降の実行時に帰属が検証されます。


よくある質問

スケジュールタスクは権限ポップアップのあるツールを実行できますか

タスク実行時にツール権限のポップアップがトリガーされます。この時あなたが APP のフォアグラウンドにいれば応答できます。誰も応答しない場合、システムは以下のルールで処理します:

  • 同一アカウント:APP がオンラインであればポップアップが表示され、ユーザーは応答できます
  • アカウントをまたぐ enterprise シナリオ:5 分間応答がなければデフォルトで拒否

ブロッキングを避けるため、以下を推奨します:

  1. スケジュールタスクでよく使う Bash、Web Fetch などのツールを P0(APP が自動実行)に設定する
  2. 「常に許可」オプションを使ってよく使うコマンドをホワイトリストに追加する
  3. ランタイムセキュリティ で個別に設定する

タスクの実行が失敗した場合はどうすればよいですか

タスク詳細ページの実行履歴 → 失敗レコード → エラー情報を確認してください。よくある原因:

  • モデル API Key の期限切れ:「モデル」ページで再設定
  • ネットワークの問題:ツールが外部ネットワークにアクセスできない可能性
  • 権限のタイムアウト:前の質問を参照
  • LLM のレート制限:リトライ間隔を長くするか、より高いクォータのモデルに切り替える

連続失敗がしきい値に達すると、タスクは自動的に一時停止され、通知が送信されます。

APP を閉じてもタスクは実行されますか

いいえ。スケジュールタスクは APP がオンラインでないとトリガーできません。7×24 時間の実行が必要な場合は:

  1. APP を常駐実行させる(macOS のバックグラウンド実行 / Windows のシステムトレイ)
  2. 常時起動している予備マシンに APP をデプロイすることを検討する

Work の「scheduled-task」スキルと組み合わせて使えますか

使えます。Work の対話で scheduled-task スキルが有効になっている場合、Agent は対話の中であなたに代わってスケジュールタスクを作成できます。たとえば「毎日 9 時にこの 3 つのサイトを取得して」と言えば、Agent は scheduled-task スキルを呼び出して自動的にタスクを作成します。


関連ドキュメント