> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# スケジュールタスクとセッションタイマー：スケジュールに従って自動実行する

> スケジュールタスクを使うと、Agent がスケジュールに従ってクラウドサーバー上で指示を自動実行します。セッションタイマーを使うと、Agent が指定した時刻にセッション内で作業を続けます。このページでは、タスクの作成、確認カード、セッションタイマー、更新、失敗、自動一時停止について説明します。

AIHubMix Cloud には 2 種類のスケジュールがあります。

* **スケジュールタスク**：プロジェクトに属する指示です。指定した時刻に Agent がそのプロジェクトのクラウドサーバー上で実行し、実行ごとにセッションが作成されます（または同じセッションで続けます）。**Scheduled** ボードで作成するか、Agent がセッション内で下書きを作成し、確認後に有効になります。
* **セッションタイマー**：セッションに紐づくタイマーです。指定した時刻にそのセッションでトリガーメッセージを送信し、Agent が作業を続けます。Agent はセッション内で直接作成でき（確認は不要）、セッションのトップバーにあるタイマーパネルから作成することもできます。繰り返しのセッションタイマーは 7 日後に期限切れとなり、更新できます。

どちらも **Scheduled** ボードに表示されます。スケジュールは、アプリや Web ページを閉じていてもクラウドサーバー上で実行されます。スケジュールタスクの実行には [Plus](https://docs.aihubmix.com/jp/cloud/plus/plus-plan.md) が必要で、デスクトップアプリ、Web アプリ、モバイル Web で利用できます。

## 入口

* デスクトップアプリの左側アイコンバーの **Scheduled**、または Web アプリのサイドバー下部の **Scheduled**。
* コマンドメニュー（`⇧⌘P`、Windows では `Ctrl+Shift+P`）で **Go to · Scheduled tasks** を検索します。
* アプリ内通知（スケジュールタスクの完了、失敗、一時停止）をクリックすると、そのスケジュールタスクが開きます。
* セッションタイマーには追加の入口があります：セッションのトップバーにあるタイマーアイコン、またはトップバーの **…** › **Session timers**。

## ボード

左側の一覧は **Upcoming**、**Paused**、**Ended** のグループに分かれます。各行には次回実行時刻とスケジュールが表示されます。セッションタイマーには、そのセッションと期限も表示されます。行をクリックすると、右側に詳細が開きます。

詳細では次の操作ができます。

| 操作 | 説明 |
| - | - |
| **Run now** | すぐに 1 回実行します。前回の実行が続いている間はクリックできません |
| **Renew** | 繰り返しのセッションタイマーのみ。7 日間延長します |
| **Pause** / **Resume** | 一時停止後は、スケジュールに従って実行されなくなります |
| 編集（鉛筆アイコン） | **Edit scheduled task** を開きます。セッションタイマーは編集できません |
| 削除（ゴミ箱アイコン） | 確認後に削除します |

詳細には、スケジュール、次回実行、プロジェクト、モデル、通知、作成方法（セッションから作成したタスクはそのセッションへのリンクがあります）、指示、実行履歴も表示されます。

**Runs** には実行ごとに 1 行が表示され、時刻と結果（実行中、**Done**、**Failed · 理由**、**Skipped · 理由**、**Stopped**）が示されます。セッションがある記録をクリックすると、その実行のセッションが開きます。

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

1. ボードで **New task** をクリックし、**Schedule a task** を開きます。Plus がない場合は先にサブスクリプションのダイアログが開き、サブスクリプション後に自動的にここへ戻ります。
2. テキストボックスに、スケジュールで実行する内容を書きます。
3. **Project** を選択します。デフォルトは最近使用したプロジェクトです。プロジェクトがまだない場合は、先にプロジェクトを作成して公開する必要があります。
4. **Repeat** を選択し、その繰り返しオプションに応じた時刻を入力します（下表を参照）。
5. （任意）**Advanced** を展開して、その他の設定を調整します。
6. **Create** をクリックします。**Scheduled · next run X** と表示されます。

| Repeat | 入力する内容 |
| - | - |
| Once | **Date**（今日から 7 日以内）+ **Time** |
| Daily | **Time** |
| Weekdays | **Time**（月曜日から金曜日） |
| Weekly | **Day** + **Time** |
| Fixed interval | **Run every**：15 min、20 min、30 min、1 h |

* **Time** は 30 分刻みで、現地時間です。
* 指示は最大 16 KiB です。各実行は最長 1 時間で、超えた実行は **Timed out** として記録されます。
* 1 回限りのタスクは実行後に **Ended** へ移動します。

### 詳細設定

| 設定 | オプション | デフォルト |
| - | - | - |
| Notifications | All updates（完了時と失敗時に通知）/ Important updates（失敗時のみ通知）/ Off | Important updates |
| New chat for each run | オフにすると、すべての実行が同じセッションで続きます | オン |
| Harness / Model / Effort | 新しいセッションと同じオプション | 前回の新しいセッションで選択したもの |

スケジュールタスクには権限設定がありません。クラウドのスケジュールタスクは常にフルアクセスで実行されます。

### スケジュールタスクを編集する

詳細で鉛筆アイコンをクリックし、**Edit scheduled task** を開きます。項目は作成時と同じです。タスクを自分の別のプロジェクトに移動できます。セッションから作成したタスクはプロジェクトを変更できません。

## セッション内で Agent が下書きを作成する

任意のセッションで、自然言語でスケジュールを依頼します。例：「毎週平日の午前 9 時に依存関係の更新を確認する」。Agent がスケジュールタスクの下書きを作成し、セッション内に確認カードが表示されます。**確認カードのスケジュールタスクは、Create をクリックするまで実行されません。**

* **Create**：すぐに有効になります。カードは **Scheduled · next run X** に変わり、**View in Scheduled** が表示されます。
* **Edit**：**Edit scheduled task** を開いて変更します。保存後、**Create** をクリックします。
* **Not now**：何も作成されません。

しばらく対応しないまま放置した下書きは期限切れになります。

## セッションタイマー

**セッションタイマー**はセッションに紐づきます。指定した時刻にそのセッションでトリガーメッセージを送信し、Agent がそのセッションで作業を続けます。「30 分後にデプロイをもう一度確認する」や「1 時間ごとにキューを確認する」など、現在のセッションのコンテキストに関連するタスクに適しています。

* **Agent が作成**：Agent は現在のセッションのタイマーを、**確認なしで**直接作成、変更、削除できます。変更のたびにタイムラインに 1 行が残ります。
* **タイマーパネル**：セッションにタイマーがある場合、トップバーのタイトルの横にタイマーアイコンが表示されます。タイマーがない場合は、トップバーの **…** › **Session timers** からパネルを開きます。パネルでは、各タイマーで **Run now**、**Turn off** / **Turn on**、**Renew**、**Delete** を実行できます。
* **New timer**：パネルで **New timer** をクリックし、**Prompt** と **Name (optional)** を入力して、**In N minutes**（最長 7 日）または **Repeating (cron)**（5 フィールドの cron 式、間隔は 5 分以上）を選択し、**Create** をクリックします。
* セッションを停止しても終了するのは現在のターンのみです。セッションタイマーは有効なままです。

### タイマーが作動したとき

* 指定した時刻に、**Timer fired · name** というメッセージがセッションに表示され、Agent がターンを開始します。
* セッションがビジーの場合は、タイマーの **When busy** 設定（**Skip this run** または **Wait in queue**）に従います。
* 1 回限りのタイマーは作動後に自動的にオフになります。

### 期限と更新

* 繰り返しのセッションタイマーは作成後 7 日間有効です。期限切れの 24 時間前以内になると、パネルに **Expiring soon** と表示され、タイムラインに **Renew** ボタン付きのリマインダーが表示されます。クリックするとタイマーが 7 日間延長されます。
* 期限切れのタイマーはオフになります。先に更新してからオンにします。
* 更新しても元のオン / オフの状態は維持されます。自分でオフにしたタイマーは更新後もオフのままです。期限切れでオフになったタイマーは、更新後に再びオンになります。

## 実行ルール

| 状況 | 結果 |
| - | - |
| 前回の実行がまだ続いている | 今回の実行はスキップされます。この間 **Run now** はクリックできません |
| 1 回の失敗 | 失敗の理由が記録され、通知設定に従って通知されます。次回の実行は通常どおり行われます |
| 3 回連続の失敗 | 自動的に一時停止します。次のセクションを参照してください |
| アプリまたは Web ページを閉じている | 通常どおり実行されます。結果は後でセッションと実行履歴で確認します |
| Plus がない、またはサブスクリプションが無効 | **Run now** と **Resume** は使えません。サブスクリプションまたは更新を促す表示が出ます |
| クラウドサーバーが稼働していない | **Run now** は使えません |

## 連続失敗後の自動一時停止

3 回連続で実行に失敗すると、スケジュールタスクは自動的に一時停止します。ボードに **Paused after failures** と表示され、通知が届きます。実行履歴で失敗の理由を確認して修正し、**Resume** をクリックします。

## 削除

詳細で削除アイコンをクリックし、確認します。スケジュールは実行されなくなり、実行履歴は削除されます。すでに作成されたセッションとセッション内のメッセージは保持されます。

## 注意事項と制限

* スケジュールタスクの最短の固定間隔は 15 分です。繰り返しのセッションタイマーの最小間隔は 5 分です。
* スケジュールタスクのフォームはカスタムの cron 式に対応していません。セッションタイマーは cron を受け付けます。
* 繰り返しのセッションタイマーは 7 日後に期限切れとなり、更新が必要です。
* 各実行はモデルの使用量を消費します（Plus モデル、または選択したサブスクリプション / BYOK）。
* Plus がなくてもボードは閲覧でき、タスクを作成しようとすると先にサブスクリプションに案内されます。[Plus がない場合](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md)を参照してください。

## よくある質問

### パソコンの電源を切ってもスケジュールタスクは実行されますか？

はい。スケジュールタスクはクラウドサーバー上で実行されるため、デバイスの電源状態には関係ありません。

### スケジュールタスクが一時停止されたのはなぜですか？

手動で一時停止したか、3 回連続で失敗して自動的に一時停止された可能性があります。セッションタイマーの場合は期限切れの可能性もあります。実行履歴で理由を確認して修正し、**Resume** をクリックします（期限切れのタイマーは先に **Renew**）。

### Agent は私の承認なしにスケジュールを作成できますか？

セッションタイマーは作成できます。Agent は現在のセッションで直接作成でき、タイムラインに記録の行が残り、トップバーのパネルでオフにしたり削除したりできます。プロジェクトのスケジュールタスクは作成できません。Agent は下書きのみを作成でき、確認カードで **Create** をクリックする必要があります。

### セッションタイマーとスケジュールタスクのどちらを使えばよいですか？

現在のセッションのコンテキストを引き継いで作業を続ける必要がある場合は、セッションタイマーを使います。プロジェクト内で長期的なスケジュールに従って独立して実行する必要がある場合は、スケジュールタスクを使います。

## 関連ページ

* [Plus がない場合](https://docs.aihubmix.com/jp/cloud/plus/without-plus.md)
* [クラウドサーバーの概要](https://docs.aihubmix.com/jp/cloud/cloud-host/overview.md)
* [Harness とモデル](https://docs.aihubmix.com/jp/cloud/models/harness-and-models.md)
* [通知設定](https://docs.aihubmix.com/jp/cloud/settings/notifications.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.