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

[ワークフローの管理] ユーザーページでは、作成した、または受信者として追加された、アクティブな会話分析エージェントのワークフローに関する情報を管理および表示できます。

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

ワークフロー情報

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

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

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

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

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

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

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

  • ワークフローを表示
  • ワークフローの編集
  • Disable Workflow（ワークフローが有効な場合）
  • Enable Workflow（ワークフローが無効になっている場合）

[View Workflow] をクリックして、[Details] ページを開きます。

[Edit Workflow] をクリックして、ワークフローの設定を開いて変更します。変更を保存するには [Save Workflow] をクリックし、保存せずに編集ウィンドウを閉じるには [Cancel] をクリックします。

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

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

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

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

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

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

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

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

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

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

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

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

[詳細] ページでは、次の操作を行うことができます。

  1. ワークフローのコンテキストを追加するテキスト フィールドを選択します。
  2. [その他] メニューを選択し、[Explore from here] オプションを選択して、ワークフロー クエリが事前に設定された 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
Condition Met ワークフローの条件が満たされたかどうかを示すブール値
  • Yes（条件が満たされました）
  • No（条件が満たされていません）
きっかけ 満たされたか、超過した場合にワークフローをトリガーするしきい値 任意の数値
Observed ワークフロー条件を満たしたか超過し、ワークフローをトリガーした観測値 任意の数値
ステータス ワークフロー クエリのステータス
  • Complete
  • Running
  • Not Started

[アクティビティ] ページでは、次の操作を行うことができます。

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

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

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

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

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

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

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

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

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

  • ユーザーがワークフローを生成したエージェントとの会話を削除しても、そのワークフローは有効なままです。ワークフローの条件が満たされると、ワークフローの通知の受信者は引き続き通知を受け取ります。
  • ワークフローを生成するエージェントが削除されても、そのワークフローは有効なままです。ワークフローの条件が満たされると、ワークフローの通知の受信者は引き続き通知を受け取ります。
  • ワークフローがモニタリングしているデータを含むデータ探索またはダッシュボードが削除されても、そのワークフローはアクティブなままです。ワークフローの条件が満たされると、ワークフローの通知の受信者は引き続き通知を受け取ります。

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

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

既存の構成で通知の配信に失敗しました

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

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

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

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