定時タスク

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

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

まずはこちらを読むことをおすすめします 概念入門 エージェントに関する概念を理解します。

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

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

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

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

前提条件の要点に由来する：

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

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

手動設定の手順

前提要件

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

1. 有効化済み API サーバー
2. 少なくとも1つのエージェントが設定済み、かつそのエージェントが編集パネルの「基本設定」で 自律モード。

   • 注：一度自律モードを有効にすると、従来の「権限モード」設定は自動的に非表示になり、基盤の権限が自動で引き継がれて完全自動実行になります。

上記条件を満たしていないエージェント 表示されません 新規タスクのドロップダウンには表示されません。2種類の設定の詳細は エージェント。

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

利用可能なエージェントが未設定のときの空状態

定時タスクを作成する

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

タスク追加フォーム

各項目の意味：

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

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

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

スケジュール種別の説明

間隔（入門におすすめ）

一定の分数ごとに繰り返し実行します。例えば 60 これは1時間ごとに1回実行することを意味します。

Cron

単発

既存タスクの管理

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

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

実行結果を表示

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

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

チャンネルとの連携

定時タスクのエージェント出力は チャンネル を通じて自動送信できます：

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

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

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

ヒントとコツ

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

---

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

設定や使用の過程で疑問、Bug、機能改善の提案がある場合は、 フィードバックと提案 に記載の公式チャネルをご参照ください。