---
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** — ユーザーフォルダの `scripts/` または `browser-macros/` に登録済みのスクリプトを LLM を介さず直接実行します。スクリプト名と、必要なら params（JSON object）を指定します。実行結果は output/ とログに保存されます。Script はユーザー単位の機能のため owner が必要で、管理者が user script を有効化している場合のみ動きます。

## スケジュールの管理

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

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

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