管理者設定 - ワークフロー

[ワークフローの管理] 管理ページでは、Looker 管理者が、インスタンス全体のユーザーが作成した会話型分析エージェントのワークフローを管理できます。管理ページには、[管理者] パネルの [アラートとスケジュール] セクションからアクセスできます。[ワークフローの管理] 管理ページには、アクティブと非アクティブのワークフローすべての情報が一覧表示されます。

ユーザーは、自分が作成したワークフロー、または受信者としてリストに記載されているワークフローに関する情報を、ユーザー プロファイル メニューからアクセスできる [ワークフローの管理] ユーザー ページで確認できます。

ワークフロー情報

[ワークフローの管理] 管理ページには、Looker インスタンス上のすべてのワークフローに関する次の情報が表示されます。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

[詳細] ページは、ワークフローのオーナーとワークフローの受信者が確認できるワークフロー情報の概要を示すダイアログです。次の情報が表示されます。

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

[ワークフローの管理] 管理ページから、Looker 管理者は次のいずれかの方法で、インスタンス上の任意のワークフローの [詳細] ページを表示できます。

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

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

  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

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

  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 に定義されている キャッシュ ポリシーがワークフロー頻度の設定と一致しているかどうか確認してください。