workflows-history

Zapier ワークフローの履歴

公開 SDK CLI の実験的なコマンドサーフェスを使用してください。zapier-sdk-code-substrate は使用しないでください。

互換性チェック

このスキルを使用する前に、workflows-doctor バンドルの互換性チェックを実行してください。workflows-doctor がインストールされていない、または読み込めない場合は、続行する前に workflows-install を実行するか、zapier/agent-skills から workflows-doctor をインストールしてください。workflows-doctor が SDK／スキルの不整合を報告した場合は、その更新手順に従い、このスキルの実行を停止してください。必要に応じてエージェントのワークスペースを再読み込みし、元のリクエストを再実行するようユーザーに依頼してください。

ワークフローを特定する

ユーザーがワークフロー ID を指定した場合は、それを直接使用してください。

ユーザーがワークフローを名前または説明で示した場合は、まずワークフローを一覧表示し、一致する ID を探してください。

zapier-sdk --stability experimental list-workflows --json

複数のワークフローが一致した場合は、候補を表示し、どれを指しているのかユーザーに確認してください。

実行履歴を取得する

zapier-sdk --stability experimental list-workflow-runs <workflow-id> --json

JSON 出力を解析してください。役立つフィールドには、id、status、started_at、finished_at、input、output などがあります。

ワークフロー ID が判明している場合は、Zapier エディターのリンクを含めてください。

https://zapier.com/workflow/<workflow-id>

実行の詳細を確認する

デプロイ済みワークフローの実行が 1 件失敗した場合、またはユーザーがステップ単位の詳細を求めている場合：

zapier-sdk --stability experimental get-workflow-run <run-id> --json

run-workflow-draft で開始されたドラフトテスト実行もワークフローの実行です（kind: "draft"）。get-workflow-run で確認してください。

手動トリガーの応答で、ワークフロー実行 ID を取得する前にトリガー ID が返された場合は、トリガーから実行をたどってください。

zapier-sdk --stability experimental get-trigger-run <trigger-id> --json

失敗、ステータス、タイミング、入力、出力、および応答に含まれるステップのエラー詳細を要約してください。ユーザーから求められない限り、生の JSON をそのまま出力しないでください。

ドラフトの状態

実行されるのは公開済みのバージョンです。未公開のドラフト編集内容は実行履歴には表示されません。最近の変更が実行に反映されるはずなのに反映されていない場合は、その変更を保持している未完了のドラフトがないか確認してください。

zapier-sdk --stability experimental list-workflow-drafts <workflow-id> --json

未完了のドラフトがある場合は、ワークフローに問題があると結論付けるのではなく、変更が未公開であることをユーザーに伝えてください（last_edited_at とエディターのリンクを記載してください）。