イベント トリガーを設定する

コネクタのデータが変更されたときに自動的に実行されるようにワークフローを構成できます。

イベント トリガーは、ポーリングを使用して、新しいメール、更新されたカレンダーの予定、接続されたデータストア内の新しいファイルなどの変更を検出します。変更が検出されると、構成されたワークフローが実行されます。

始める前に

この機能を使用する前に、次の手順を完了します。

サポートされているコネクタ

イベント トリガーをサポートするコネクタは次のとおりです。

  • Confluence
  • Gmail
  • Google カレンダー
  • Google ドライブ
  • Jira Cloud
  • OneDrive
  • Outlook
  • ServiceNow
  • SharePoint
  • チーム

イベント トリガーを構成する

アプリ

  1. ブラウザで Gemini Enterprise ウェブアプリを開きます。
  2. ナビゲーション メニューで [エージェント] をクリックします。
  3. [Create agent] をクリックします。
  4. [手動で開始] をクリックします。
  5. [エージェントをトリガーする条件] ページで、[アプリのイベント] をクリックします。
  6. 詳細パネルの [アプリ イベント - 開始するアプリを選択] で、使用するコネクタを参照または検索します。コネクタ名をクリックして選択します。
  7. ワークフローをトリガーするイベントを選択します。イベントはカテゴリ別に整理されています。
  8. イベントを選択すると、フロービルダーのワークフローの上部にトリガーが追加されます。
  9. [ステップを追加] をクリックして、トリガーが起動したときに実行されるワークフロー ステップを追加します。

イベント トリガーを使用してエージェントをテストする

ワークフローを有効にする前に、トリガー イベントをプレビューし、サンプル イベントデータを使用してシミュレーションを実行することで、ワークフローの機能をテストできます。

イベント トリガーの結果をプレビューする

アプリ

  1. ワークフロー キャンバスで、ワークフローの上部にあるイベント トリガーノードをクリックします。
  2. 右側の構成パネルで、[結果をプレビュー] をクリックします。
  3. Gemini Enterprise は、コネクタから最近のイベントを取得します。各項目には、イベントのタイトルとタイムスタンプが表示されます。Google カレンダーのプレビューの結果は最近更新されたイベントに基づいており、最近のイベントが反映されていない場合があります。
  4. プレビュー結果をクリックすると、イベントの詳細が表示されます。

エージェントのワークフローをテストする

アプリ

  1. ワークフロー キャンバスの [テスト] タブに切り替えます。
  2. トリガー入力セクションで、[入力の選択] セレクタを使用して、プレビューされたイベントのリストからサンプル イベントを選択します。
  3. [手動で開始] をクリックして、サンプル イベント データを使用してワークフロー シミュレーションを実行します。
  4. 実行が完了したら、シミュレーションの概要を開いて出力を調べ、各ステップでトリガー ペイロードが正しく処理されたことを確認します。

イベント トリガーを管理する

イベント トリガーは、構成の編集、ワークフローのオン / オフの切り替え、トリガーの削除によって管理できます。

注: イベントが表示されるまでに最大 10 分かかることがあります。

  • イベント トリガーを編集する: エージェントを編集モードで開き、キャンバスでトリガーノードをクリックして、構成パネルで設定またはフィルタ条件を更新します。
  • イベント トリガーをオンにする: トリガーを有効にしてイベントのポーリングを開始するには、ワークフローをオンにします。詳細については、ワークフローを有効または無効にするをご覧ください。
  • イベント トリガーをオフにする: イベント ポーリングを一時停止または無効にするには、ワークフローをオフにします。

既知の問題と制限事項

イベント トリガーを使用する際の既知の問題と制限事項は次のとおりです。

  • コネクタのリンク解除: 管理者がエンジンまたはアプリからコネクタのリンクを解除すると、イベント トリガーは自動的に一時停止されます。ただし、ユーザーに通知は送信されず、ユーザーはギャラリーで一時停止したエージェントを表示できません。
  • セッションの失敗のリトライ: イベント トリガーで関連付けられたコネクタからデータを取得する際にエラーが発生してエージェントの実行が失敗した場合、失敗ステータスのセッションが作成されます。失敗したセッションの手動再試行は現在サポートされていません。
  • フィルタ: 最も重要なイベントでエージェントが迅速に実行されるように、イベント トリガーには常にフィルタを追加してください。
  • Gmail トリガー:
    • メールの量が多いユーザーの場合、エージェントの開始が遅くなることがあります。
    • Gmail は、[メールが送信されたとき] と [メールが受信されたとき] の 2 つのトリガーをサポートしています。自分宛てにメールを送信してエージェントをトリガーする場合は、[メールが送信されたとき] を使用します。メールを受信したときを使用しても、エージェントはトリガーされません。

システム制約の一覧については、Workflow Builder の割り当てと上限をご覧ください。

次のステップ