IM 定時リマインダー

クロスプラットフォームの定時リマインダースキルで、正確な時間トリガーとメッセージ配信を保証します。cron job 設定を通じて、メッセージがユーザーのリマインダー要求元のチャネルに送信されるようにし、NO_REPLY の問題を回避します。

適用シーン

• ユーザーが定時リマインダーを要求する場合（例：「5分後に会議のリマインダー」）
• ユーザーが周期的なタスクを要求する場合（例：「毎時間、水分補給のリマインダー」）
• 指定された時間に Agent が操作を実行し、ユーザーに応答する必要がある場合

固定フィールド

以下のフィールドは、すべてのタスクで固定値を取り、変更できません。

動的フィールド

以下のフィールドは、現在のセッションコンテキストに基づいて自動的に入力する必要があります。

スケジューリング方式

一度限りのタイマー（at）

指定された時間に一度トリガーします。「X分後にリマインダー」のようなシナリオに適しています。

"schedule": {
  "kind": "at",
  "atMs": 1770449700000
}

atMs は、目標トリガー時間の Unix タイムスタンプ（ミリ秒）です。

周期的なタイマー（every）

固定間隔で繰り返しトリガーします。「X分ごとにリマインダー」のようなシナリオに適しています。

"schedule": {
  "kind": "every",
  "everyMs": 60000
}

everyMs は、トリガー間隔のミリ秒数です（例：60000 = 1分）。

Cron 式タイマー（cron）

標準の cron 式を使用してスケジュールします。「毎朝7時にリマインダー」のような、カレンダーに基づいた規則的なシナリオに適しています。

"schedule": {
  "kind": "cron",
  "expr": "0 7 * * *"
}

expr は、標準の5桁の cron 式で、以下の形式です。

┌───────────── 分 (0-59)
│ ┌───────────── 時 (0-23)
│ │ ┌───────────── 日 (1-31)
│ │ │ ┌───────────── 月 (1-12)
│ │ │ │ ┌───────────── 曜日 (0-6，0=日曜日)
│ │ │ │ │
* * * * *

一般的な式：

完全なサンプル

サンプル1：一度限りのリマインダー

指定された時間にトリガーされ、一度実行されると終了します。

{
  "version": 1,
  "jobs": [
    {
      "id": "0dd466ae-d52a-448f-ad01-2fc719f1f48c",
      "name": "test2",
      "description": "test2",
      "enabled": true,
      "schedule": {
        "kind": "at",
        "atMs": 1770449700000
      },
      "sessionTarget": "isolated",
      "wakeMode": "next-heartbeat",
      "payload": {
        "kind": "agentTurn",
        "message": "回复内容是test2",
        "deliver": true,
        "channel": "feishu",
        "to": "ou_XXXXXXXXXXX"
      }
    }
  ]
}

サンプル2：周期的なリマインダー

固定間隔でトリガーされ、継続的に実行されます。

{
  "version": 1,
  "jobs": [
    {
      "id": "50f53ed1-4ad6-4ed2-9984-fdd4eba1fdab",
      "name": "测试1",
      "description": "测试1",
      "enabled": true,
      "schedule": {
        "kind": "every",
        "everyMs": 60000
      },
      "sessionTarget": "isolated",
      "wakeMode": "next-heartbeat",
      "payload": {
        "kind": "agentTurn",
        "message": "回复这是测试1",
        "deliver": true,
        "channel": "feishu",
        "to": "ou_XXXXXXXXXXX"
      }
    }
  ]
}

サンプル3：Cron 式による定時リマインダー

cron 式に従ってスケジュールされ、カレンダーに基づいた規則的なタスクに適しています。

{
  "version": 1,
  "jobs": [
    {
      "id": "0ec68ffa-07b2-4ca6-93ee-75edd26b4b74",
      "name": "cron",
      "description": "cron",
      "enabled": true,
      "schedule": {
        "kind": "cron",
        "expr": "0 7 * * *"
      },
      "sessionTarget": "isolated",
      "wakeMode": "next-heartbeat",
      "payload": {
        "kind": "agentTurn",
        "message": "cron",
        "deliver": true,
        "channel": "feishu",
        "to": "ou_XXXXXXXXXXX"
      }
    }
  ]
}

チャネル検出

1. チャネルタイプの取得：ランタイムの channel 属性から取得します（例：feishu）
2. ユーザー ID の取得：現在のセッションまたはメッセージコンテキストから取得します（例：ou_xxxx）
3. 常に自動検出：リクエストを開始した元のチャネルを使用し、ハードコーディングしないでください

メッセージ内容のガイドライン

• プレーンテキストメッセージは避けてください。Agent が応答を生成するための指示を含める必要があります
• 完全な指示文を使用してください。Agent が処理後に目に見える応答を生成するようにします

実装手順

1. 現在のチャネルタイプとユーザー ID を検出します
2. ユーザーの時間リクエストをタイムスタンプ（ミリ秒）または間隔のミリ秒数に変換します
3. 完全な job 設定を構築します（固定フィールド + 動的フィールド）
4. API を呼び出して定時タスクを作成します
5. 作成が成功したことを確認し、ユーザーに通知します

よくある落とし穴