---
id: schedules
title: スケジュールで自動実行
category: basic
order: 60
keywords: [スケジュール, 定期実行, cron, daily, weekly, タイムゾーン]
---

# スケジュールで自動実行

決まった時刻にタスクを自動実行したいときは、スケジュールを登録します。「週次ニュースまとめ」「日次レポート生成」のような定期処理に向いています。

## スケジュールを作る

TopBar → スケジュール ページを開き、「新しいスケジュール」を押します。左がスケジュール一覧、右が詳細・編集ペインの 2 カラム構成です。

入力する主な項目:

- **種別** — Agent（LLM が Piece を実行）か Script（登録済みの user script を直接呼び出し、LLM 不要）
- **タイトル** — 一覧での表示名（任意）
- **プロンプト** — Agent の場合、エージェントに送るメッセージ（必須）
- **Piece** — `auto`（LLM が自動選択）または特定の Piece を指定。[Piece を選ぶ・作る](05-pieces.md) 参照
- **出力フォーマット** — markdown / plain / json
- **タイプ**（スケジュール種別）と時刻
- **公開範囲** — Private / Organization / Public（ログインユーザーのみ）

保存すると一覧に追加され、次回実行予定時刻が表示されます。

## スケジュールの 5 タイプ

| タイプ | 設定する内容 |
|---|---|
| 毎日 (daily) | 時刻（時・分）を指定し、毎日その時刻に実行 |
| 毎週 (weekly) | 曜日と時刻を指定 |
| 毎月 (monthly) | 日付（1〜31）と時刻を指定 |
| Cron | Cron 式（`分 時 日 月 曜日`）で柔軟に指定。例: `0 7 * * *` = 毎日 07:00 |
| 一回 (once) | 指定した日時に 1 回だけ実行。実行後は自動で停止する |

> **時刻はすべて UTC です。** 毎日 / 毎週 / 毎月 / Cron の時刻入力欄や一覧のプレビューは UTC 表記になります（一覧の「次回実行」表示は日本時間に変換されます）。一回タイプの日時指定だけはローカル時刻で入力します。日本時間 09:00 に動かしたい場合は UTC 00:00 を指定してください。

毎日・毎週・毎月はプレビューに「毎日 07:00 (UTC)」のように換算結果が表示されるので、保存前に確認できます。

## 重複実行はスキップされる

スケジューラは約 1 分ごとに実行予定を確認します。実行時刻が来ても、**同じスケジュールの前回ジョブがまだ進行中**（queued / dispatching / running / waiting_human / waiting_subtasks のいずれか）の場合、その回はスキップされ、次回実行時刻だけが更新されます。長時間かかるタスクが二重に走ることはありません。

## Agent と Script の違い

- **Agent** — 通常のタスクと同じく、選ばれた Piece を LLM が実行します。`auto` を指定すると実行時に分類器が実 Piece を解決します（解決できないときは `chat` にフォールバック）。
- **Script** — ワークスペースの **設定 → ブラウザ** に登録したブラウザマクロを LLM を介さず直接実行します（汎用 Node の `scripts/` は廃止され、定型処理はブラウザマクロまたはスキルに集約されました。→「[個人の資産（ワークスペース設定）](09-userfolder.md)」）。マクロ名と、必要なら params（JSON object）を指定します。実行結果は output/ とログに保存されます。Script はユーザー単位の機能のため owner が必要で、管理者がこの機能を有効化している場合のみ動きます。

## スケジュールの管理

スケジュール ページの一覧から、各スケジュールに対して以下を操作できます。

- **今すぐ実行** — 次回予定を待たずに即時トリガー
- **停止 / 再開** — 一時的に無効化（停止中は実行されない）
- **編集** — 内容・タイミングの変更
- **削除**

一覧上部のフィルタ（すべて / 有効 / 停止中）と検索で絞り込めます。タスクの作成全般は [タスクを作る](02-tasks.md) を参照してください。

## ワークスペースのスケジュール

ワークスペースを開くと「スケジュール」タブがあり、そのワークスペース専用のスケジュールを登録できます。実行結果はワークスペースの共有ファイルツリーに出力され、メンバー全員が見られます。TopBar のスケジュール ページは全ワークスペース横断の一覧として従来どおり使えます。

ワークスペースのスケジュールは**ワークスペースの資産**です。作成者が異動・退職してワークスペースを離れても消えず、残ったメンバー（オーナー / 管理者 / 編集者）が引き継いで管理できます。

ただし**「何を実行するか」を変えられるのは作成者本人だけ**です。スケジュールは作成者の資格（ブラウザセッション・メモリ・接続情報）で動くため、他のメンバーが本文や Piece、スクリプトを書き換えると作成者になりすました実行になってしまうからです。作成者以外のメンバーができるのは、停止 / 再開・再スケジュール・公開範囲の変更・今すぐ実行・削除といった**運用操作**に限られます。内容を変えたいときは、作成者に依頼するか、自分で新しいスケジュールを作ってください。
