> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/scheduled-tasks.md).

# 定時タスク

定時タスクは [エージェント](/docs/jp/cherry-studio/preview/agent.md) 計画に従って自動実行する機能を提供し、「毎朝9時にニュース要約を作成する」「毎週月曜にチームの作業量を集計する」「毎時データダッシュボードを同期する」などの周期的なニーズに適しています。

* **本質**：Cherry Agent にあらかじめ設定したスケジュールに従って自動実行させる
* **対応範囲**：エージェントで完了できるタスクはすべて定時化可能
* **実行記録**：各実行ごとにログが保存され、いつでも確認できます

> まずはこちらを読むことをおすすめします [概念入門](/docs/jp/advanced-basic/concepts-101.md) エージェントに関する概念を理解します。

## フォーム入力はしたくない？ AI に代わりにタスクを作成させましょう

Cron 式や各種スケジューリング項目に慣れていないなら、最も簡単なのは直接ある **自律権限を持つエージェント**（内蔵の Cherry Claw など）に要件を伝えることです：

> 「毎朝9時に最近のニュースを使って5つの要点からなる要約を作って、結果を私の飛書に送ってください。」

エージェントが、どのような定時タスクを作成すべきかを自動で判断し、あなたの記述内容に基づいて各項目（スケジュール種別、時間、プロンプトなど）を補完します。途中で追加情報が必要な場合のみ確認を求めます。

{% hint style="warning" %}
**前提条件の要点**に由来する：

* 内蔵の **Cherry Claw** および自作のエージェントは、デフォルトではいずれも **「自律モード OFF + 通常モード」**。
* **チャンネル（または定時タスク）を使用する前に、必ずそのエージェントの編集パネルに入って「自律モード」を有効にする必要があります**。
* 「自律モード」を有効にすると、基盤のツール呼び出し権限が完全自動で引き継がれ、従来の「権限モード」設定項目は非表示になり、手動設定は不要になります。詳細は [エージェント](/docs/jp/cherry-studio/preview/agent.md)。
  {% endhint %}

手動で設定したい場合や、各項目の意味を理解したい場合は、以下の手順に従って進めてください。

## 手動設定の手順

### 前提要件

定時タスクはエージェントの実行に依存するため、まず次を満たす必要があります：

1. **有効化済み** [**API サーバー**](/docs/jp/advanced-basic/api-server.md)
2. **少なくとも1つのエージェントが設定済み**、かつそのエージェントが編集パネルの「基本設定」で **自律モード**。
   * *注：一度自律モードを有効にすると、従来の「権限モード」設定は自動的に非表示になり、基盤の権限が自動で引き継がれて完全自動実行になります。*

上記条件を満たしていないエージェント **表示されません** 新規タスクのドロップダウンには表示されません。2種類の設定の詳細は [エージェント](/docs/jp/cherry-studio/preview/agent.md#di-5-bu-tiao-zheng-zhi-neng-ti-de-ti-shi-ci-gong-ju-yu-ji-neng)。

{% hint style="info" %}
定時タスクの空状態の案内文は、依然として初期の名称「ソウルモード / 権限なしモード」を使用しており、それぞれ現在の **自律モード / 完全自動モード**。
{% endhint %}

<figure><img src="/files/a5b34c4297797e4e8946424e77e8dbe449d1bc8a" alt=""><figcaption><p>利用可能なエージェントが未設定のときの空状態</p></figcaption></figure>

### 定時タスクを作成する

開く `設定 → 定時タスク`で、中間列上部の **+ 追加** ボタンをクリックすると、右側に **タスクを追加** フォーム：

<figure><img src="/files/e49d82c7820a19d858fa1192d5632dc9931cb0b1" alt=""><figcaption><p>タスク追加フォーム</p></figcaption></figure>

各項目の意味：

| 項目           | 説明                                                                                             |
| ------------ | ---------------------------------------------------------------------------------------------- |
| **名称**       | タスクの表示名。後で識別しやすくするためのものです（例：「毎日のコードレビュー」）。                                                     |
| **プロンプト**    | タスク実行時にエージェントへ送る指示。"今回の実行でエージェントが何をすべきか" を記述します                                                |
| **スケジュール種別** | `間隔` / `Cron` / `単発` 3択のいずれか                                                                   |
| **スケジュール値**  | スケジュール種別に対応します：間隔は分数を入力、Cron は式を入力、単発は具体的な日時を選択します                                             |
| **タイムアウト時間** | 1回の実行の最大時間（分）。空欄の場合は無制限です                                                                      |
| **チャンネルに送信** | （任意）設定済みの [チャンネル](/docs/jp/advanced-basic/agent-channels.md)を選ぶと、タスク結果がその IM プラットフォームに自動送信されます |

入力後にクリック **保存**すると、新しいタスクが中央の一覧に表示され、すぐにスケジュール規則に従って実行待ちになります。

{% hint style="warning" %}
を選択した場合は **チャンネルに送信**、そのチャンネルが対応プラットフォーム上で利用可能な受信先（Chat ID）を持っていることを確認してください。チャンネル配下で誰も Bot にメッセージを送っていない場合、システムは警告を表示します —— **まず対応プラットフォーム上で Bot にメッセージを1件送信してください**。それにより Cherry Studio が Chat ID を記録します。
{% endhint %}

### スケジュール種別の説明

{% tabs %}
{% tab title="間隔（入門におすすめ）" %}
一定の分数ごとに繰り返し実行します。例えば `60` これは1時間ごとに1回実行することを意味します。
{% endtab %}

{% tab title="Cron" %}
標準の Cron 式（5フィールド）を受け付けます：`分 時 日 月 曜日`。よく使う例：

| 式              | 意味       |
| -------------- | -------- |
| `0 9 * * *`    | 毎日午前9:00 |
| `*/15 * * * *` | 15分ごと    |
| `0 0 * * 1`    | 毎週月曜0:00 |
| {% endtab %}   |          |

{% tab title="単発" %}
具体的な日付と時刻を選び、その時点で1回実行した後、タスクは自動的に「完了済み」としてマークされ、それ以後はトリガーされません。

「金曜の午後5時に週報の提出をリマインドする」といった1回だけ実行する場面に適しています。
{% endtab %}
{% endtabs %}

### 既存タスクの管理

各タスクには一覧上で一通りの管理操作があります：

* **実行**：手動ですぐに1回実行します（以後のスケジュールには影響しません）
* **一時停止 / 再開**：タスクを削除せずにスケジュールを一時停止し、必要に応じて再開できます
* **編集 / 削除**：タスク項目の変更または削除
* **タスク状態**：有効 / 一時停止 / 完了済み（単発タスクのみ、時刻到達後に「完了済み」になります）

### 実行結果を表示

各タスクには **実行履歴**に由来する：

* タスクカードをクリックすると、過去の実行記録を確認できます：時刻、所要時間、状態（成功 / エラー）、出力
* 失敗した実行にはエラー情報が付与され、原因調査に役立ちます
* クリック可能 **会話を表示** そのタスクに対応する完全な会話記録へ移動します

### チャンネルとの連携

定時タスクのエージェント出力は [チャンネル](/docs/jp/advanced-basic/agent-channels.md) を通じて自動送信できます：

* 飛書 / Lark
* Telegram / Discord / Slack
* QQ / WeChat

たとえば「毎朝9時にタスク結果を飛書グループへ送信する」。

{% hint style="warning" %}
長時間稼働する定時タスクはモデルのトークンを継続的に消費します。Provider 管理画面で月間上限を設定し、使い過ぎを防いでください。
{% endhint %}

### ヒントとコツ

* まずは **間隔 = 5分、最大実行回数 1回** で試運転し、出力が期待どおりであることを確認してから間隔を長くするのがおすすめです
* 異なるタスクで同じエージェントを共有してもよく、用途ごとに専用エージェントを用意しても構いません
* プロンプト内では `{date}` などのプレースホルダーを参照できます（具体的な対応はエージェントテンプレートに準拠します）

***

### 💡 ヘルプの取得とフィードバックの送信

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルをご参照ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/scheduled-tasks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
