SOP ファンイン: 手動
手動トリガーは、外部イベントからではなく、エージェントのターン内から実行を開始します。エージェントは sop_execute ツールを呼び出し、実行する SOP を指定します。設定するリスナーやイベントソースはありません。実行は、エージェントが開始を決定したときに始まります。
実行の判断が外部シグナルではなくエージェントの推論に委ねられる場合は、手動トリガーを使用します。これは実践例で使われている方法です。リリースがチャネル経由で到着し、エージェントがそれについて推論し、その後 SOP 自体を起動します。
それを定義しています
manual トリガーを持つ SOP にはマッチフィールドがありません。トリガーブロックについては Syntax を参照してください。他の SOP と同じ方法で検証および検査してください:
zeroclaw sop validate
zeroclaw sop list
zeroclaw sop show <name>
Dashboard から開始します
ダッシュボードの実行ボタン(POST /sops/{name}/run)は同じ manual イベントを発行するため、manual トリガーには2つの経路からアクセスできます。1つはエージェントのターン、もう1つはエージェントを介さないオペレーターです。ダッシュボードから開始された実行は、cron による実行とまったく同じくヘッドレスで駆動されます。
このちがいは責任の所在に表れます。sop_execute を通じて実行する場合は呼び出し側のエージェントが実行を担当するため、agent は省略できます。一方、ダッシュボードから開始された実行には引き継ぐエージェントがないため、execute ステップに所有者が宣言されていない手順は、最初のステップで失敗する実行を開始するのではなく、エンドポイントが拒否します(422、該当ステップを名指しで返します)。オーサリング時にはブロックせず警告を出すため、sop_execute 専用の手順も保存できます。ダッシュボードから手動 SOP を開始できるようにするには、SOP.toml(またはステップ単位)で agent を設定してください。
承認して観察する
チェックポイントに到達した実行は WaitingApproval として一時停止します。CLI(zeroclaw sop list、zeroclaw sop approve)またはゲートウェイAPIの承認エンドポイント(GET /admin/sop/pending、POST /admin/sop/approve、POST /admin/sop/deny)を介した帯域外操作で、これらをクリアまたは確認できます。