自動化とスケジューリング

Cronジョブ

正確なタイミングでエージェントのウェイクアップをスケジュールします。CronジョブはGatewayの再起動後も永続し、柔軟なスケジューリングパターンをサポートします。

スケジュールタイプ

セッションターゲット

• メインセッション -- エージェントのメイン会話にシステムイベントとしてキューイング
• 分離セッション -- 専用セッション（cron:<jobId>）で実行し、メイン会話の汚染を回避

デリバリーモード

ワンショットリマインダー

特定の時刻にリマインダーを設定。エージェントが起動し、リマインダーを処理し、オプションで実行後にジョブを削除します。

定期ジョブ

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ホスト上で実行され、イベントコンテキストデータにアクセスできます。

ユースケース