Macha の基本概念

スケジュール実行エージェント

定義

スケジュール実行エージェントとは、スケジュールド（cron 形式の）トリガーを紐づけた Macha のエージェントです。日次のダイジェスト、定期的な監査、決まった点検などを、イベントや人の操作を待たずに、一定間隔で自ら実行します。

別名: スケジュールドトリガーcron エージェント定期実行エージェント

仕組み

エージェントにスケジュールドトリガーを追加します。実行間隔を時間単位（実行と実行の間は最短 1 時間）で設定し、初回の開始時刻を決めます。Macha のスケジューラーは 60 秒ごとに実行時刻の来たトリガーを確認し、エージェントを自律的に起動します。人が介在しないため、書き込み系の操作はそのまま実行されます。したがって、エージェントの指示は、その実行を単独で完結できるだけの十分さが必要です。

暴走を防ぐためのガードレールもあります。トリガー 1 つあたり 1 日 24 回の実行上限、組織あたり同時 3 件までのスケジュール実行、5 回連続でエラーが出た場合の自動停止（メール通知あり）、そして実行前のクレジット確認です。

何に向いているか

スケジュール実行エージェントは、Macha を受け身の仕組みから先回りの仕組みへ変えます。よくある使い方は、夜間に届いたチケットの朝一番のサマリーを Slack に投稿する、キューを週次で監査する、データを定期的に取得する、といったものです。各実行は、通常のエージェントの応答と同じようにクレジットを消費します。

よくある質問

スケジュール実行エージェントはどのくらいの頻度で動かせますか？

最短で 1 時間に 1 回です。実行間隔の下限が 1 時間で、暴走を防ぐために各トリガーは 1 日 24 回までに制限されています。

スケジュールドトリガーはどのプランで使えますか？

すべてのプランです。スケジュールトリガーは全プランに含まれ、最短間隔 1 時間、1 トリガーあたり 1 日 24 回、組織あたり同時実行 3 件、5 回連続で失敗すると自動停止というガードレールがあります。

スケジュール実行エージェントトリガーのドキュメント

スケジュール実行エージェント

仕組み

何に向いているか

よくある質問

関連用語