ワークフローのトラブルシューティングはどう進めますか？
ワークフローのトラブルシューティングでは、コンポーネント、接続、認証情報、受信リクエストの4つの領域から、最初に失敗した段階を確認します。ワークフローのほかの部分を変更する前に、その段階のエラーとデータを確認してください。これらのガイドは、エラー一覧に文書化されている失敗の種類に沿っています。
執筆：Ai Flowi · 技術レビュー：Janice Lee、Ai Flowi テクニカルサポート。
公開日： · 更新日：2026年10月9日
該当する確認項目を選ぶ
コンポーネントの欠落、互換性のないポート、モデル設定、インポート、コンポーネント更新については「よくあるエラー」から確認してください。認証と権限には「Google接続」、受信リクエストと応答には「Webhook」を使います。Telegram固有の失敗では、Webhookの基本を確認してから「Telegramのトラブルシューティング」を開いてください。まずエラーを読み、変更のたびに、失敗している処理を最小単位で再テストします。
- よくあるエラーでは、コンポーネントの欠落、互換性のないポート型、モデル設定、インポート、コンポーネント更新を扱います。エディターで接続に失敗する場合や、変更後にワークフローの動作が変わった場合に確認してください。
- Google接続では、保存済みのConnections、アカウント権限、スコープ、再認可を扱います。Googleコンポーネントで認証できない、または操作できない場合に確認してください。
- Webhookでは、拒否されたHTTPメソッド、応答コンポーネント、想定したワークフロー経路に到達しないリクエストを扱います。受信リクエストまたは応答が失敗する場合に確認してください。
- Telegramのトラブルシューティングでは、Webhookの基本を確認した後に、Telegram固有の失敗を扱います。
Telegram固有の失敗では、Webhookの基本を確認してからTelegramのトラブルシューティングを使ってください。TelegramのWebhook設定と更新データの解析も追加の対応領域としてドキュメントに記載されており、それぞれ専用の確認項目があります。
診断を進める順序
まず、表示されたエラーまたは失敗したコンポーネントを確認します。2つのコンポーネントを接続できない場合は、接続元の出力のtypesと接続先の入力のacceptsを比較してください。サービスの操作が失敗した場合は、秘密情報を共有せずに、保存済みの認証情報とサービスの権限を確認します。受信リクエストでは、メソッドと機密情報を除去したペイロードを確認し、応答に至るまでワークフローをたどってください。書き込みに失敗した場合は、再試行の前に再試行を見直すためのランブック例を使って検証記録を整理してください。
構造上の互換性があっても、認証情報や外部サービスが実行時に機能するとは限りません。変更のたびに、失敗している処理を最小単位で再テストし、その後でワークフロー全体を再実行してください。ワークフローの基本のページでは、型に基づく接続がどのように組み合わされるかを説明しています。
記録されたワークフロートレースを確認する
AI Flowi WorkflowのTracesには、確認用に記録されたワークフローの実行が表示されます。ワークフローのTracesを開き、実行を検索し、Success、Error、または日付範囲で絞り込みます。実行を選ぶとTrace Detailsが開きます。この画面は記録済みのトレースデータを使用するため、一覧が空であったりトレースがなかったりする場合、記録されていない実行の状況は、この画面では確認できません。モデル実行の検証記録を解釈するには、トレースの詳細と併せてLLMオブザーバビリティのガイドを確認してください。
Group by Sessionを使うと表示中の実行を整理でき、Reloadを使うと一覧を再取得できます。Downloadは、現在読み込まれている実行の行データをJSONとしてエクスポートします。
実行内のスパンを確認する
Trace Detailsには、スパンのツリーと、選択したスパンの詳細パネルがあります。スパンを選ぶと、そのステータスとレイテンシーを確認でき、記録されている場合はモデル名、入力、出力、エラーも確認できます。
トークン使用量が取得できる場合は、合計トークン数と、プロンプトおよび補完のトークン数が表示されます。トークン使用量が記録されていないLLMスパンにはダッシュが表示されます。Estimated Costは、記録されたトークン使用量に0より大きいコストが含まれる場合だけ表示されます。スパンに入力、出力、エラーがない場合、パネルには追加の詳細がない旨が表示されます。