Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

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)を介した帯域外操作で、これらをクリアまたは確認できます。

関連項目も参照してください