Jinba Flow
Jinba App
Jinba Toolbox
実行を開き、入力、ステップ出力、エラーを確認します
失敗した実行を調べる
- フローの実行履歴を開き、失敗した実行を選択します。
- 最初に失敗したステップを探します。そのステップに依存するステップは失敗ではなくキャンセルとして表示されるため、先に最初の失敗を修正してください。
- ステップの入力、出力、エラーメッセージを確認します。
- 各入力名と値を、選択したツールのドキュメントと照らし合わせます。
- フローを修正して、もう一度実行します。
StepTimeoutErrorなど)、メッセージ、取得できる場合はスタックトレースが含まれます。
ステップのステータス
forEachステップでは、要素ごとにステータスがあります。一部の要素が失敗し、残りが成功した場合、ステップ全体はpartialになります。
テスト入力を指定してフローを実行し、結果の詳細を開きます
1つのステップをテストする
ステップのステップを実行を使うと、フロー全体を実行せずにそのステップをテストできます。フローに未保存の変更がある場合は保存して実行を使います。- 前のステップの結果は、最後に完了したフロー全体の実行から読み込まれます。その後に前のステップを単独で実行していれば、その新しい結果が使われます。
- フロー全体の実行が一度も完了していない場合、前のステップへの参照は空の値になります。先にフロー全体を一度実行してください。
whenの条件が偽の場合やneedsのステップが失敗している場合でもステップは実行され、再試行は行われません。
resultの形式はツールによって異なります。参照できるフィールドは該当ツールのドキュメントで確認してください。
よくあるエラーを調べる
フローの検証に失敗する
- 各ステップのIDが一意で、有効なツールIDを使っているか確認します。
- ツールステップに
inputの一覧があるか確認します。空の場合も一覧が必要です。 - 入力名と設定名を、選択したツールのドキュメントと照らし合わせます。
- YAMLのインデントとステップ参照を確認します。
マニフェストの構造はYAMLマニフェストの記述方法を参照してください。
ステップがすぐに失敗する
- そのステップに表示されるエラーを読みます。
- 外部サービスとの連携では、認証情報と付与された権限を確認します。
- 必須入力がそろっており、期待される型になっているか確認します。
- 外部サービスから返されたエラーの場合は、レート制限も含めて、その応答とステータスを確認します。
Step '<step_id>' timed out after <N>msは、ステップの実行が制限時間を超えたことを示します。
ステップがスキップまたはキャンセルされる
cancelled: 依存先の失敗したステップを探し、先にそのステップを修正します。skipped:whenの条件を、参照しているステップの実際の出力と照らし合わせます。{{ }}のプレースホルダーは評価前に値が埋め込まれるため、文字列の値は引用符で囲みます("'{{ steps.check.result.type }}' == 'premium'")。Failed to evaluate when condition on step '<step_id>'は、条件を評価できなかったことを示します。結果に含まれないフィールドを参照していることがよくある原因です。この場合、ステップは失敗として扱われます。
後続のステップで値を参照できない
- 参照先のステップIDがマニフェストと正確に一致しているか確認します。
- 前のステップが実際に返した出力を確認します。結果の形式はツールによって異なります。
- 前のステップのIDを
needsに追加します。参照するだけではステップは待機せず、値がない場合もエラーにならず空文字列になります。 {{ steps.fetch.result }}のようなサポートされている参照形式を使います。
ステップの出力が期待と異なる
- ステップに表示される入力が想定どおりか確認します。オブジェクトや配列はJSONテキストとして挿入されます。
- ツールの設定とドキュメントを確認します。
- 変更するたびにステップを実行で再実行します。