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

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

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

始める前に

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

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

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

  • 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 の割り当てと上限をご覧ください。

次のステップ