コンテンツにスキップ

AIでワークフローのエラーを修正する

ワークフローのステップが失敗した場合や警告をログに記録した場合、AI修正アシスタントはそのエラーを読み取って原因を突き止めます。原因がステップ自体の設定ミスであれば、修正した設定を提案し、承認を受けて適用します。エラーを説明するだけにとどまらず、変更そのものを代行できます。

これはPlaidCloudのWeave AIの機能の1つで、プロジェクトのログビューアー、ワークフローエディター、プロジェクトのWeaveタブから、失敗したステップを指定した状態でWeaveドックに開きます。スケジュールされた実行が失敗した場合、Weaveが修正を用意して待っていることがあります。失敗した実行の後に待機している修正を参照してください。

プロジェクトのログタブから開きます。

  1. プロジェクトを開き、ログタブをクリックします。
  2. ログ一覧で、失敗したステップのエントリを選択します。スタックトレースを含む完全なメッセージが、右側のパネルのログメッセージの下に表示されます。
  3. メッセージの下にある修正をクリックします。ステップのエラーまたは警告には修正が表示され、それ以外のエントリにはWeave に質問が表示されます。その横の ⋯ には、説明とその他のWeaveの操作があります。

ドックは、選択したログエントリの元になったワークフローとステップをあらかじめ指定した状態で開くため、すぐに診断を始めます。どのステップが失敗したかを伝える必要はありません。ログメッセージで未加工のエラーを確認しながら、ドックでアシスタントの回答を読めます。よくあるエラーの一部では、最初の返信が説明になります。よくあるエラーを参照してください。

ワークフローエディターから開く

Section titled “ワークフローエディターから開く”

キャンバスで赤い点が付いたステップを選択します。インスペクターの前回の実行エラーカードでは、修正アシスタントがオンの場合は見出しの横に修正が、オフの場合はWeave に質問が表示されます。ステップが失敗したときを参照してください。

キャンバスまたはステップ一覧でステップを右クリックするか、ログのエラー行を右クリックし、メニューのWeaveセクションで修正を選択します。修正は、ステップの最終実行が失敗した場合や、検出事項が修正を提案している場合に表示され、警告行には表示されません。Weaveドックがそのステップを対象にして開きます。Monitorまたはログビューアーでは、行の修正で同じ操作ができます。

プロジェクトのWeaveタブで、Weaveが見つけた問題のカードにある修正をクリックします。アシスタントは専用のウィンドウで開き、その問題が指すステップをあらかじめ指定した状態で、Weaveが現在報告している問題から始めます。修正が表示される検出事項については、AIアシスタントで検出事項を修正するを参照してください。

  1. 診断 — 失敗したステップの設定と、そのステップが扱うテーブルおよび列を読み取ります。エラーメッセージだけから推測せず、データに照らして自分の見立てを確認します。
  2. 提案 — 本当に設定ミスが見つかった場合は、変更内容をカードで示します。まずWhy it failedとして理由を1文で述べ、次に変更される設定ごとにボックスを表示します。設定名はできる限りステップのフォームでの表記に合わせ、現在の値は赤、新しい値は緑で示します。変更される部分だけが一覧に載り、列リストの場合は変更される列だけが載ります。この時点では何も保存されません。
  3. 承認 — カードでApprove N changesを選択します。ステップをそのままにする場合は今はしないを選択します。ご自身の言葉で返信することもできます。ボタンはアシスタントの返信が完了してから使用可能になり、承認は常に提案より後のメッセージで行われます。
  4. 適用 — 承認すると、ステップエディターと同じ経路でステップに変更を書き込みます。保存されるのはカードに示された変更であり、1回の承認で保存されるのは1回だけです。保存の直前に、現在のステップの設定のコピーを保持するため、修正を元に戻せます。修正を元に戻すを参照してください。
  5. 再実行と確認 — ブラウザーでは、同じ承認で再実行も行われます。WeaveはERP転記をオフにして修正したステップを再実行し、成功したか、警告付きで完了したか、再び失敗したかを伝えます。たとえば、修正して再実行しました: Allocate by Driverは4分で成功し、46,812行で、通常の範囲内です。 のように伝えます。確認できなかった場合はその理由を伝え、ステップが修正されたとは決して言いません。モバイルアプリでは、2枚目のカードでステップを再実行するかどうかを尋ねます。ステップが2分以内に完了しない場合はWeaveがその旨を伝え、結果はワークフローとログタブに表示されます。

ERPシステムへ転記するステップや別のワークフローを実行するステップ、チャットがワークフローに紐づいていない場合、またはお使いのロールでワークフローを実行できない場合、アシスタントは再実行を提案しません。こうしたステップは、ERP転記モードを選択できる元のワークフローから再実行してください。ワークフローがすでに実行中の場合は、何も実行されず、アシスタントが再試行を提案します。

各提案、承認または却下、変更そのものは、置き換えた内容と書き込んだ内容とともに、プロジェクトのWeaveのアクティビティ履歴に記録されます。承認は変更が行われる前に記録されます。記録できない場合は何も保存されず、カードにその旨が表示されるので、後でもう一度承認できます。

失敗した実行の後に待機している修正

Section titled “失敗した実行の後に待機している修正”

スケジュールまたはセンサーによって開始されたワークフローの実行が失敗すると、Weaveはすぐにその失敗を調べ、可能であれば、誰かがログを開く前に修正を用意します。手動で開始した実行については、原因がソース列の名前変更である場合に修正を用意します。

修正は、Month-End Close failed at Allocate by Driver のように失敗にちなんだタイトルのカードとして待機します。カードには、実行が失敗した理由、変更される内容、再実行する対象が示されます。たとえば、次に: Month-End CloseをAllocate by Driverから再実行し、続いてMargin Reportを実行します。これらの実行ではERP転記はオフです。 のように示されます。カードは次の場所にあります。

  • Monitor → 検出事項の、失敗した実行の行。行を開くとカードが表示されます。
  • ログエントリと、キャンバス上のステップのマーク。
  • ドックのWaiting for youの行。

カードの所有者には、Month-End Closeが失敗しました。確認が必要な修正をWeaveが用意しています。 のようにPlaidCloudで通知され、モバイルアプリを使用している場合は電話にも通知されます。Apply and re-runをクリックすると、修正を保存し、失敗したステップから再実行します。その後、Weaveが実行が成功したかどうかを伝えます。

  • 失敗したステップを編集できるロールのユーザーと、カードの所有者が、Webで承認できます。
  • Weaveは原因ごとに1枚のカードを用意します。修正が見つからなかった場合やカードが却下された場合、変更されていないステップの同じ失敗を再び調べることはありません。
  • ERPに転記するステップや、PlaidCloudの外部に書き込むステップにはカードは用意されません。

複数のステップをまとめて修正する

Section titled “複数のステップをまとめて修正する”

6つのマッピングで使われている列の名前が変更された場合など、同じ問題が複数のステップに影響しているときは、Weaveはすべての変更を1枚のカードで提案します。カードには、ステップごとに番号付きのセクション、再実行する対象、そしてお使いのロールで編集できないステップなど含められなかったものが示されます。1回のApprove 6 changesですべての変更が適用され、Weaveは修正した各ステップをERP転記をオフにして1回ずつ再実行し、問題が解消したかどうかを伝えます。承認後にステップが変更された場合、Weaveはそのステップに変更を適用せずに処理を停止し、適用した件数を伝えます。1回の元に戻すで、修正したすべてのステップが元に戻ります。不在の間にWeaveがカードを準備した場合、そのカードはドックのその会話で待機し、Waiting for youの行を開いて承認します。あなたを待っているカードを参照してください。

修正のカードには、その修正を元に戻せる場合にその旨が表示されます。Weaveはステップの現在の設定のコピーを保持しているため、ステップが再度変更されない限り、一定期間はこの修正を元に戻せます。 この行がないカードは元に戻せません。Weaveがコピーを保持できない場合は、何も保存せずにその旨を伝えるので、もう一度依頼できます。

修正が保存されると、カードに元に戻すが表示されます。プロジェクトのWeaveのアクティビティ履歴にある、その修正のエントリにも同じボタンがあるため、チャットを閉じた後でも修正を元に戻せます。プロジェクトでステップを変更できるロールのユーザーなら、承認した本人でなくても修正を元に戻せます。

元に戻すをクリックすると、元に戻すことで復元される内容を示すウィンドウが開きます。修正で変更された各設定が、現在の値と元に戻した後の値で表示されます。次の中から選択します。

  • 元に戻す — ステップの設定を、修正の直前の状態に戻します。
  • 元に戻して実行 — 設定を戻した後、ステップを実行します。お使いのロールでワークフローを実行でき、ステップが修正を行ったワークフロー(それがない場合は唯一のワークフロー)にまだ存在し、そのワークフローを開くことができ、さらにステップがERPシステムへの転記や別のワークフローの実行を行わない場合に提案されます。実行そのものは元に戻せません。
  • キャンセル — ステップをそのままにします。

元に戻す操作で変わるのはステップの設定だけです。ステップの実行によってすでに書き込まれたデータはそのまま残るため、再構築するにはステップを再実行してください。

次の場合、Weaveは修正を元に戻さず、何も変更しません。

  • 修正後にステップが変更された場合。 元に戻すと古い設定が復元されてしまうため、ウィンドウにはステップの現在の状態とWeaveによる変更前の設定が並べて表示され、ご自身で変更できます。
  • ステップがすでに修正前と同じ設定になっている場合。
  • コピーが保持されなくなった場合。 コピーは一定期間だけ保持されます。
  • お使いのロールでステップを変更できない場合、またはプロジェクトがロックされている場合。
  • Weaveが元に戻す操作を記録できなかった場合。 しばらくしてからもう一度お試しください。

元に戻す操作は、アクティビティ履歴に独立した変更として記録されます。たとえば、Done as approved: undo Weave’s change to a step’s settings. のように記録されます。

ステップがこれらのよくあるエラーで失敗した場合、最初の返信は、その種類のエラーについてPlaidCloudがすでに用意している説明となるため、すぐに表示されます。

あらゆる種類のステップで次のようなエラーが対象です。

  • ステップが読み取るテーブルに存在しない列を使う式
  • ソース列がステップの読み取るテーブルに存在しない列マッピング
  • ソーステーブルが設定と一致しないため、何も書き込む前に停止したステップ(使用する列や結合キーがテーブルにない、ステップが一覧に載せていない結合キーがある、ソーステーブルが構築されていない)
  • ステップに必要な設定が空のままになっている場合(使用する接続や読み取るテーブルなど)
  • ステップが実行するワークフローが失敗した場合(原因はそのワークフローのいずれかのステップにある可能性が高いため、そのワークフローのログを確認します)
  • ステップが指定したテーブルが見つからない場合
  • SnowflakeまたはDatabricksのウェアハウスが、PlaidCloudのアドレスをブロックしている、サインインを拒否している、クォータを使い切っている、見つからないか使用できない、またはPlaidCloudのロールに必要な権限が不足している場合

SQL抽出ステップでは次のようなエラーが対象です。

  • 読み取れないSQL(キーワードのつづりミスや閉じられていない括弧など)
  • データベースが認識しない関数
  • 存在しないテーブル
  • 扱えない型の値が渡された関数(テキスト列の合計など。Databendの場合)
  • SQLが要求した型に変換できない値(数値や日付が必要な箇所にテキストがあるなど。Databendの場合)

Table Extractステップでは、SQLではなくステップ自体のタブとフィールドを示す修正で、次のようなエラーが対象です。

  • ソーステーブルがまだ存在しない、またはすでに存在しない場合(Databendの場合)
  • データベースが認識しない関数を使う式(Databendの場合)
  • 扱えない型の値が渡された関数(式の中、または集計でのテキスト列の合計など。Databendの場合)
  • 出力列がないステップ(すべての列が削除されたステップなど)

説明では、そのエラーの一般的な原因、エラーメッセージのどの語句に注目すべきか、修正方法を示します。これは一般的な内容であり、ステップを調べたり何かを変更したりすることはありません。アシスタントにステップ自体を確認させるには、返信してください。以降は、動作のしくみで説明するとおりに動作し、会話の一部として説明が残ります。

それ以外のエラーは、アシスタント自身による診断に直接進みます。上記のデータベースエラーが他の種類のステップで発生した場合も同様です。

アシスタントが修復するのは、エラーの原因となった1つのステップの設定です。たとえば、列名や関数名の入力ミス、無効な式、誤ったデータ型やキャスト、不正な形式のSQLなどです。エラーを解消できる最小限の変更にとどめます。1つの失敗に対して的を絞った1つの変更を行い、それ以外の設定はそのまま残します。

列、フィルター、having句などで失敗した式は、エラーとソーステーブルの列とともに、式エディターの横にある式のスペシャリストと同じものに渡されます。返された修正後の式は、提案される前にチェックされます。提案はあくまでそのステップの1つのフィールドに対する変更であり、他の変更と同じ方法で承認します。

アシスタントが操作できるのは、そのステップの設定だけです。問題が別の場所にある場合は、編集で解決したように見せかけることなく、その旨を率直に伝えます。

  • 編集するのは1つのステップの設定だけです。ステップの作成、削除、並べ替え、テーブルの作成、別のステップの編集、データの変更は行いません。
  • 失敗の多くは設定の問題ではありません。たとえば、ソースデータの欠落や不正な形式、先に失敗した上流のステップ、一時的なエラーやインフラのエラー、権限の問題、UDFやユーザーコードのステップでのPythonの不具合、ドキュメントアカウントにあるファイルの欠落、リソースやタイムアウトの上限などです。これらの場合は、見つけた内容を説明し、実際の修正が必要な場所を案内します。
  • 警告は無害で変更が不要なことも多く、その場合は、編集をでっち上げるのではなく、そのとおりに伝えます。
  • 変更で解決できるかどうか確信が持てない場合は、推測を断定として示すのではなく、その旨と不確かな点を伝えます。
  • 診断は、ステップの設定とテーブルのメタデータをライブで参照して行われるため、キャッシュされた形状や想定した形状ではなく、現在のプロジェクトの状態が反映されます。
  • 修正が適用された後は、アシスタントがステップの再実行を提案したら承諾するか、ご自身で再実行して、エラーが解消されたことを確認してください。
  • 原因がステップの設定の外(不正なデータ、上流の失敗、権限の問題)にあるとアシスタントが伝えた場合、それが答えです。アシスタントにステップを無理に編集させるのではなく、実際の原因がある場所で修正してください。