Forward Session で自然言語を使用して Schedule を作成、照会、アーカイブします。
Forward Session で自然言語を使用して、Schedule を直接作成、照会、アーカイブできます。
API の呼び出しに加えて、エンドユーザーは Web または IM Channel でタスクの内容と実行時刻を説明できます。Agent が Schedule を作成し、その後は元の Session をオンラインに保たなくても、予定どおりに自動実行されます。
Template で、次の管理対象ツールを有効にする必要があります。
既存の Template を更新する例：
同じ Template 配下の Identity ごとに異なる Schedule 機能が必要な場合は、Identity Config でツール名ごとに個別スイッチを設定できます。
Identity Config に記載されていないツールは Template のベースラインを継承します。個別ツールを
会話で次の情報を指定します。
監視タスクでは、実行頻度、対象日、年、開始時刻と終了時刻、トリガー条件を明示することをお勧めします。必要な情報が不足している場合、Agent が追加で確認します。
作成が完了すると、Agent が結果を返します。作成した Schedule を表示するよう Agent に依頼し、タスク名、トリガールール、タイムゾーンを確認することもできます。
現在表示できる Schedule を照会し、名前、タスク内容、またはステータスで絞り込めます。例：
Schedule ID、名前、またはタスク内容を指定してアーカイブできます。自然言語では引き続き「削除」と表現できますが、データは物理削除されません。例：
複数の Schedule が一致した場合、Agent はアーカイブを実行せず、Schedule ID で選択できる候補を返します。「削除」は実際にはアーカイブであり、新しい Run は作成されません。Schedule は ID または
前提条件
Template で、次の管理対象ツールを有効にする必要があります。
- Schedule の作成：
create_forward_schedule - Schedule の照会：
list_forward_schedules - Schedule のアーカイブ：
delete_forward_schedule
managed_tool_config は Template のトップレベルフィールドです。Template の作成時に設定するか、既存の Template を更新してください。
- Template の作成：
POST /api/v1/forward/templates - Template の更新：
POST /api/v1/forward/templates/{template_id}
enabled_tools を指定すると、現在有効になっている Schedule 管理対象ツールのセット全体が置き換えられます。
Identity ごとのオーバーライド
同じ Template 配下の Identity ごとに異なる Schedule 機能が必要な場合は、Identity Config でツール名ごとに個別スイッチを設定できます。
null にするとそのオーバーライドを削除し、managed_tool_config: null にするとすべてのオーバーライドを削除します。詳細なマージおよび競合ルールは、Identity Config の作成または更新を参照してください。
既存の Identity では、identity_config.tools.<name>.enabled=false を使用して継承した管理対象ツールを無効化する方法も引き続き利用できます。新規連携では identity_config.managed_tool_config を使用してください。
ツール設定を確認するには、Agent に「現在使用できるツールを教えてください」と質問し、上記 3 つのツールが使用可能であることを確認します。
Schedule を作成する
会話で次の情報を指定します。
- 実行時刻（毎日午前 9 時、毎週月曜日の午前 10 時、2 時間後など）
- タスクの内容
- 出力要件
- タイムゾーン。指定しない場合、デフォルトは
Asia/Shanghaiです。
定期タスク
1 回限りのタスク
固定間隔のタスク
Schedule を照会する
現在表示できる Schedule を照会し、名前、タスク内容、またはステータスで絞り込めます。例：
Schedule をアーカイブする
Schedule ID、名前、またはタスク内容を指定してアーカイブできます。自然言語では引き続き「削除」と表現できますが、データは物理削除されません。例：
include_archived=true で取得でき、履歴も保持されます。既存の pending または running Run はキャンセルされません。
実行結果を確認する
- Web で作成した Schedule の結果は元の Session に返されます。作成後にオフラインになっても、次にその Session を開いたときに保留中の結果を受け取れます。
- IM Channel で作成した Schedule の結果は、対応する Channel Session に送信されます。
- API で Schedule Run を一覧表示 または Schedule Run を取得 することもできます。
制限事項
cronおよびintervalトリガーの最小粒度または間隔は 1 分です。onceトリガーで相対遅延を指定する場合、上記の最小頻度は適用されませんが、遅延は 0 より大きい必要があります。- Schedule の実行中は、別の Schedule を作成、照会、アーカイブできません。これにより、タスクの自己複製や再帰的な Schedule 管理を防ぎます。