実行が失敗したとき

実行が失敗するのは、あるステップを完了できないときです。ツールがエラーを出す、アプリが接続されていない、ワークスペースにクレジットがない、プランがそのステップを許可していない、といった場合です。すべての実行は保存されるので、後から何が起きたかを確認できます。

症状#

• エージェントが途中で止まる、または空の回答や一般的な回答を返す。
• ワークフローが途中で終了する、またはバッチの行に 失敗 と表示される。
• スケジュール実行が何も行わなかった。
• 公開をクリックした後にエラーバナーが表示される。たとえば “検証に失敗しました。コンポーネントで強調表示されているエラーを修正してください。” など。

履歴で実行を見つける#

1. サイドバーの 履歴 をクリックします。
2. エラーメッセージ フィルターをオンにして、エラーを含むセッションだけを一覧表示します。エージェントまたはワークフロー やチャットボットでも絞り込めます。
3. セッションを開きます。標準 または 詳細 で、表示される詳細の量を切り替えられます。
4. イベントを上から順に読みます。イベントには ユーザーメッセージ、チャットボット出力、システムメッセージ、チャットフック、ツール呼び出し、エージェントクエリ というラベルが付いています。エラーを報告している ツール呼び出し イベントを確認します。

表の上にあるメトリクスパネル（メトリクスを表示）には、合計エラー数 が時系列で表示されます。履歴をさかのぼれる範囲はプランによって制限されます。プランと制限 を参照してください。バッチ実行の場合、表には ステータス と エラー の列があり、失敗した実行を再実行 または 行を再試行 で失敗した行を再度実行できます。

よくあるエラーと対処#

スケジュール実行#

ワークスペースのクレジットが切れると、システムは永遠に再試行する代わりにスケジュールをオフに切り替えます。クレジットが復活したら、スケジュールを開いて再度有効にしてください。スケジュール を参照してください。

修正する#

1. 失敗したセッションを見つけて、エラーを正確にコピーします。
2. 表と照合し、対処を適用して、同じ入力を再度実行します。
3. エラーが外部サービスから来ていて原因が分からない場合は、キャンバスからそのステップだけをテストします。テストと実行ログ を参照してください。