# 自動化とスケジューリング ## Cronジョブ 正確なタイミングでエージェントのウェイクアップをスケジュールします。CronジョブはGatewayの再起動後も永続し、柔軟なスケジューリングパターンをサポートします。 ### スケジュールタイプ | タイプ | 説明 | 例 | |------|-------------|---------| | **Cron式** | タイムゾーン付きの標準cron構文 | `0 7 * * *`（毎日午前7時） | | **インターバル** | 固定間隔で繰り返し | `30m`、`2h`、`1d` | | **ワンショット** | 特定の時刻に1回実行 | `2026-03-15T16:00:00Z` | ### セッションターゲット - **メインセッション** -- エージェントのメイン会話にシステムイベントとしてキューイング - **分離セッション** -- 専用セッション（`cron:`）で実行し、メイン会話の汚染を回避 ### デリバリーモード | モード | 説明 | |------|-------------| | **None** | サイレント実行（出力なし） | | **Announce** | 特定のチャンネルに結果を投稿 | | **Webhook** | 結果を外部URLにHTTP POST | ### ワンショットリマインダー 特定の時刻にリマインダーを設定。エージェントが起動し、リマインダーを処理し、オプションで実行後にジョブを削除します。 ### 定期ジョブ cron式とタイムゾーンサポートで繰り返しタスクをスケジュール。ジョブは実行履歴（成功、失敗、タイミング）を追跡します。 --- ## Webhook 外部サービスからのイベントを受信し、エージェントにルーティングします。 ### Gmail Pub/Sub GmailのPush通知システムと統合し、メール到着時にエージェントアクションをトリガー： 1. GCP Pub/Subトピックとサブスクリプションを設定 2. Gmailラベルフィルタリングを設定 3. Push配信をWebhook URLに向ける 4. NeotaskがメッセージをReceiveし、エージェントイベントをキューイング ### カスタムWebhook 呼び出されるとエージェントターンをトリガーするHTTPエンドポイントを登録。CI/CDパイプライン、モニタリングシステム、またはHTTPリクエストを送信できる任意のサービスとの統合に便利です。 --- ## システムイベント システムイベントは処理のためにエージェントを起動するシグナルです： - **即時** -- 次のハートビートで処理 - **次のハートビート** -- 次のスケジュールされたチェックインのためにキュー リアクティブなワークフローにシステムイベントを使用 -- エージェントは固定スケジュールではなく、何かが発生した時に起動します。 --- ## ハートビート ハートビートは定期的なシグナル（デフォルト約15秒）で、エージェントに保留中の作業を処理する機会を与えます： - 新しいシステムイベントの確認 - キューに入ったメッセージの処理 - 保留中の自動化の実行 ハートビートはエージェントごとに有効化、無効化、または設定できます。 --- ## フック Gatewayイベントに応じてシェルコマンドやスクリプトをトリガーするイベント駆動型自動化： - **メッセージ受信時** -- メッセージ受信時に実行 - **エージェントターン時** -- エージェントがメッセージを処理する前後に実行 - **チャンネルイベント時** -- チャンネル固有のイベント（参加、退出、リアクション）で実行 フックはGatewayホスト上で実行され、イベントコンテキストデータにアクセスできます。 --- ## ユースケース | シナリオ | ソリューション | |----------|----------| | 毎朝のブリーフィング | 午前7時のCronジョブ → エージェントが夜間の更新を要約 | | 週次レポート生成 | 毎週月曜日のCronジョブ → エージェントがレポートを生成しメール送信 | | メールモニタリング | Gmail Webhook → エージェントが受信メールを処理 | | ビルド通知 | CI/CD Webhook → エージェントがビルド結果をDiscordで通知 | | 毎時のデータチェック | インターバルベースのCron → エージェントがダッシュボードを確認し異常をアラート | | スケジュールされたSNS投稿 | Cronジョブ → エージェントが最適な時間にコンテンツを作成・投稿 |