エージェント ワークフローを管理する

[ワークフローの管理] ユーザーページでは、作成した会話型分析エージェントの ワークフロー や、受信者として追加された会話型分析エージェントのワークフローの有効 / 無効を管理し、情報を確認できます。

[ワークフローの管理] ユーザーページに移動するには、[プロフィール] メニューを選択し、[ワークフロー] を選択します。このページは、Looker 管理者から create_alerts 権限と see_alerts 権限が付与されている場合にのみ、プロフィール メニューに表示されます。

ワークフロー情報

[ワークフローの管理] ユーザーページには、所有しているワークフローや受信者として登録されているワークフローに関する情報が表示されます。

列 定義
ワークフロー名 ワークフローのタイトル。ワークフローの開始時にエージェントによって設定されます。エージェントは、会話の内容に基づいてデフォルトのワークフロー タイトルを生成します。ワークフロー名をクリックすると、そのワークフローの [**詳細**] ページが開きます。
オーナー ワークフローを作成したユーザーの名前。
平均実行時間 ワークフロー クエリの実行時間（秒単位）。
条件が満たされました ワークフロー クエリが最後に実行されたときにワークフローの条件が満たされたかどうかを示す [Yes] または [No]。ワークフロー クエリがまだ実行されていない場合、またはワークフロー クエリが実行されたがワークフローの条件が満たされたかどうかを判断できない場合は、-- 記号が表示されます。この列には、ワークフロー クエリの実行またはワークフロー通知の配信時に表示される警告またはエラーに関連する警告アイコンまたはエラーアイコンが表示されます。警告アイコンまたはエラーアイコンにカーソルを合わせると、関連するエラー メッセージが表示されます（該当する場合）。

最新でないワークフロー警告の警告アイコンは、ダッシュボード タイルのデータが直近の 2 つのワークフロー クエリ間で変更されなかったことを示します。このメッセージの詳細については、このページのアラートエラーと警告メッセージ セクションをご覧ください。
頻度 条件が満たされたかどうか、条件が超過されたかどうかを確認するためにワークフローが実行される頻度。
ステータス この列は、ワークフローが有効か無効かを示します。

ユーザーがユーザーページから自分のワークフローを無効にした場合、または Looker 管理者がワークフローを無効にした場合、ワークフローは [無効] とマークされます。 ワークフローを無効にすると、ワークフローの受信者への通知は一時停止されます。
アクティビティ ワークフローの [アクティビティ] ページに移動するリンク。
オプション メニュー ワークフローに対して追加の操作を実行できるメニュー。詳しくは、このページのワークフロー管理のオプションをご覧ください。

Looker インスタンスのワークフローを管理する

ワークフローの管理には、次のタスクが含まれる場合があります。

各ワークフローの横には、次の選択肢を含む [オプション] メニューがあります。

  • [ワークフローを表示]
  • [ワークフローを編集]
  • [ワークフローを無効にする]（ワークフローが有効な場合）
  • [ワークフローを有効にする]（ワークフローが無効な場合）

[**ワークフローを表示**] をクリックすると、[**詳細**] ページが開きます。

[ワークフローを編集] をクリックすると、ワークフローの設定を開いて変更できます。変更を保存するには [ワークフローを保存] をクリックし、保存せずに編集ウィンドウを閉じるには [キャンセル] をクリックします。

ワークフローのステータスを管理する

ワークフローを完全に削除することはできませんが、ワークフローが有効かどうかを制御できます。ワークフローの [ステータス] が [有効] の場合、ワークフローの条件が満たされたかどうかを確認するために、ワークフローで指定された頻度でワークフロー クエリが実行されます。条件が満たされた場合、ワークフローの受信者に、ワークフローで指定された通知方法で通知が送信されます。ワークフローの [ステータス]が [無効]の場合、ワークフロー クエリは実行されず、通知は送信されません。無効なワークフローの [詳細] ページには、ワークフローのビジュアリゼーションの結果は表示されません。

ワークフローのオーナーまたは Looker 管理者は、次のような状況でワークフローを手動で無効にする必要がある場合があります。

  • ワークフローの条件を再構成するために、ワークフロー通知を一時的に一時停止する
  • エラー メッセージまたは警告のトラブルシューティング
  • 通知配信エラーの解決

ワークフローを無効にする手順は次のとおりです。

  1. [ワークフローの管理] ユーザーページで、無効にするワークフローを見つけます。
  2. ワークフローの [オプション] メニューを選択します。
  3. [ワークフローを無効にする] を選択します。

次の手順に沿って [ワークフローを有効にする] を選択すると、いつでもワークフローを再度有効にできます。

ワークフローの詳細を表示する

[詳細] ページは、ワークフロー情報の概要を示すダイアログです。次の情報を確認できます。

  • ワークフローをトリガーする条件や、ワークフローがトリガーされる状況についての説明。
  • ワークフロー クエリの結果のビジュアリゼーション。
  • ワークフローのビジュアリゼーションの [その他] メニュー。このメニューには、[ここから探索] オプションがあります。このオプションを選択すると、ワークフロー クエリが事前に設定された Explore が開きます。
  • [今すぐテスト] ボタン。即時ワークフロー クエリを実行します。

[ワークフローの管理] ユーザーページで、所有しているワークフローまたは受信者であるワークフローの [詳細] ページを表示するには、次のいずれかの方法を使用します。

  1. ワークフローの [オプション] メニューを選択し、[ワークフローを表示] を選択します。
  2. ワークフロー名をクリックします。

[詳細] ページでは、次の操作を行えます。

  1. テキスト フィールドを選択して、ワークフローに関するコンテキストを追加します。
  2. [その他] メニューを選択し、[ここから探索] オプションを選択して、ワークフロー クエリが事前に設定された Explore を開きます。
  3. [今すぐテスト] を選択すると、ワークフローで指定された頻度を待たずに、ワークフロー クエリをすぐに実行できます。ワークフローの条件が満たされると、そのオーナーと追加の受信者に通知が送信されます。

[完了] をクリックして [詳細] ページを閉じます。

ワークフロー アクティビティをモニタリングする

Looker は指定された頻度でワークフロー クエリを実行して、条件が満たされたかどうかを確認します。こうしたチェックの結果はワークフローの履歴になり、[アクティビティ] ページで確認できます。

[アクティビティ] ページのテーブルには、各ワークフロー クエリジョブに関する次の情報が表示されます。

見出し 定義 設定可能な値
Ran At ワークフロー クエリが開始された時刻のタイムスタンプ DD/MM HH:MM 形式の任意のタイムスタンプ

例: 05/30 18:25
Run Time ワークフロー クエリの実行にかかった時間 0.81s 形式の任意の時間
Fresh 最新の 2 つのワークフロー クエリの間で変更されたデータがワークフロー クエリによってチェックされたかどうかを示すブール値
  • Yes（データが変更された場合）
  • No（データが変更されなかった場合）
ソース ワークフロー クエリによって、ワークフローの条件で示されたしきい値がチェックされたデータの生成元
  • query
  • cache
  • stale cache
  • query、cache、stale cache が適用されない場合、[Source] の値は空白になります。
Source Time ワークフロー クエリによってしきい値がチェックされたデータベース行のタイムスタンプ DD/MM HH:MM 形式の任意のタイムスタンプ

例: 05/25 16:01
条件が満たされました ワークフローの条件が満たされたかどうかを示すブール値
  • Yes（条件が満たされました）
  • No（条件が満たされていません）
きっかけ 満たされたか、超過した場合にワークフローをトリガーするしきい値 任意の数値
Observed ワークフローの条件を満たしたか超過し、ワークフローをトリガーした観測値 任意の数値
ステータス ワークフロー クエリのステータス
  • Complete
  • Running
  • Not Started

[アクティビティ] ページでは、次の操作を行えます。

  1. ワークフロー クエリが条件をチェックする頻度を表示します。
  2. ワークフローの履歴を表示します。
  3. [今すぐテスト] ボタンを使用して、即時ワークフロー クエリを実行します。ワークフローがトリガーされると、そのオーナーと追加の受信者に通知が送信されます。

[完了] をクリックして [アクティビティ] ページを閉じます。

ワークフローの条件を変更する

ワークフローのオーナーまたは Looker 管理者は、次のような状況でワークフロー構成を手動で変更する必要がある場合があります。

  • 通知に表示される Gemini を活用した主要因分析 を有効または無効にする
  • 組織のニーズの変化に合わせて、ワークフローをトリガーする指標のしきい値と条件を調整する
  • 通知先を更新する
  • キャッシュ ポリシーに合わせてワークフローの頻度を更新する

ワークフローの設定を変更する手順は次のとおりです。

  1. [ワークフローの管理] ページで、変更するワークフローの [オプション] メニューを選択します。
  2. [**ワークフローを編集**] を選択すると、ワークフロー編集ダイアログが開きます。
  3. ワークフローの設定を変更します。
  4. [アラートを保存] を選択して変更を保存します。

エージェント、会話、Explore、ダッシュボードの削除がワークフローに与える影響

データ エージェントまたは会話を削除すると、関連するワークフローに次のような影響があります。

  • ユーザーがワークフローを生成するエージェントとの会話を削除した場合、そのワークフローは有効なままになります。 ワークフローの条件が満たされると、ワークフロー通知の受信者に通知が送信されます。
  • ユーザーがワークフローを生成するエージェントを削除した場合、そのワークフローは有効なままになります。 ワークフローの条件が満たされると、ワークフロー通知の受信者に通知が送信されます。
  • ユーザーがワークフローでモニタリングしているデータを含む Explore またはダッシュボードを削除した場合、そのワークフローは有効なままになります。 __ワークフローの条件が満たされると、ワークフロー通知の受信者に通知が送信されます。

ワークフローのエラーと警告のメッセージ

[ワークフローの管理] ユーザーページには、ワークフローの実行時またはワークフロー通知の配信時に表示されるエラーまたは警告が表示されます。[条件が満たされました] 列の警告アイコンまたはエラーアイコンにカーソルを合わせると、エラー メッセージが表示されます（該当する場合）。

既存の構成で通知を配信できませんでした

Slack または Looker モバイルアプリに通知を配信するように設定されているワークフローの場合、ワークフローの条件は満たされたものの通知を配信できなかったとワークフローで判断されると、エラーメッセージ Notification delivery failed with existing configuration が表示されます。この障害は、ワークフローの作成後に Slack 構成に関する変更が加えられた場合に発生することがあります。たとえば、ワークフローの配信先の Slack ワークスペースが Looker インスタンスから切断された場合、ワークフローの配信先の Slack チャンネルが削除された場合、Looker が統合に接続できない場合などです。

警告: 最新データのクエリ

[条件が満たされました] 列の警告アイコンは、ワークフローのベースとなっているデータが、最新の 2 つのワークフロー クエリ間で変更されなかったことを示します。このアイコンにカーソルを合わせると、[Stale Alert Warning] というメッセージが表示されます。

クエリ間でデータが変更されなかった理由には、いくつかの説明が考えられます。この警告が続く場合は、Looker デベロッパーに相談して、エージェントの Explore に定義されている キャッシュ ポリシーがワークフロー頻度の設定と一致しているかどうか確認してください。