接続されたアプリでデータが変更されたときにワークフローが自動的に実行されるように構成できます。
イベント トリガーは、ポーリングを使用して、新しいメール、更新されたカレンダーの予定、接続されたデータストア内の新しいファイルなどの変更を検出します。変更が検出されると、構成されたワークフローが実行されます。
始める前に
この機能を使用する前に、次の手順を完了してください。
- 必要なデータソースが接続されたウェブアプリがあることを確認します。詳しくは、アプリを作成する、Google データソースを接続する、サードパーティのデータソースを接続するをご覧ください。
- Gemini Enterprise 管理者が、アプリの機能管理設定で Workflow Builder 機能の切り替えを有効にしていることを確認します。詳しくは、ウェブアプリの機能を管理するをご覧ください。
- トリガーソースとして使用するアプリが、Gemini Enterprise アプリでデータストアとして接続されていることを確認します。詳しくは、サードパーティのデータソースを接続するをご覧ください。
サポートされるアプリ
次のアプリはイベント トリガーをサポートしています。
- Confluence
- Gmail
- Google カレンダー
- Google ドライブ
- Jira Cloud
- OneDrive
- Outlook
- ServiceNow
- SharePoint
- チーム
イベント トリガーを構成する
アプリ
- ブラウザで Gemini Enterprise ウェブアプリを開きます。
- ナビゲーション メニューで [エージェント] をクリックします。
- [Create agent] をクリックします。
- [Start manually] をクリックします。
- [What should trigger your agent?] ページで、[App event] をクリックします。
- 詳細パネルの [App event - Choose an app to start with] で、使用するアプリを参照または検索します。アプリ名をクリックして選択します。
- ワークフローをトリガーするイベントを選択します。イベントはカテゴリ別に整理されています。
- イベントを選択すると、フロービルダーのワークフローの上部にトリガーが追加されます。
- [ステップを追加] をクリックして、トリガーが起動したときに実行されるワークフロー ステップを追加します。
イベント トリガーを使用してエージェントをテストする
ワークフロー エージェントを有効にする前に、トリガー イベントをプレビューし、サンプル イベントデータを使用してシミュレーションを実行して、その機能をテストできます。
イベント トリガーの結果をプレビューする
アプリ
- ワークフロー エージェントのキャンバスで、ワークフローの上部にあるイベント トリガーノードをクリックします。
- 右側の構成パネルで、[プレビュー結果] をクリックします。
- Gemini Enterprise は、接続されたアプリから最近のイベントを取得します。各アイテムには、イベントのタイトルとタイムスタンプが表示されます。Google カレンダーのプレビュー結果は、最近更新されたイベントに基づいており、最近のイベントが反映されていない場合があります。
- プレビュー結果をクリックすると、イベントの詳細が表示されます。
エージェント ワークフローをテストする
アプリ
- ワークフロー エージェントのキャンバスで [テスト] タブに切り替えます。
- トリガー入力セクションで、[入力の選択] セレクタを使用して、プレビューされたイベントのリストからサンプル イベントを選択します。
- [Start manually] をクリックして、サンプル イベントデータを使用してワークフロー エージェントのシミュレーションを実行します。
- 実行が完了したら、シミュレーションの概要を展開して出力を確認し、各ステップでトリガー ペイロードが正しく処理されたことを確認します。
イベント トリガーを管理する
イベント トリガーを管理するには、構成を編集する、ワークフロー エージェントをオンまたはオフにする、トリガーを削除します。
注: イベントが表示されるまでに最大 10 分かかることがあります。
- イベント トリガーを編集する: エージェントを編集モードで開き、キャンバス上のトリガーノードをクリックして、構成パネルで設定またはフィルタ条件を更新します。
- イベント トリガーを有効にする: トリガーを有効にしてイベントのポーリングを開始するには、ワークフロー エージェントを有効にします。詳しくは、ワークフロー エージェントをオンまたはオフにするをご覧ください。
- イベント トリガーを無効にする: イベント ポーリングを一時停止または無効にするには、ワークフロー エージェントを無効にします。
既知の問題と制限事項
イベント トリガーを使用する際の既知の問題と制限事項は次のとおりです。
- コネクタのリンク解除: 管理者がエンジンまたはアプリからコネクタのリンクを解除すると、イベント トリガーは自動的に一時停止します。ただし、ユーザーに通知は送信されず、ユーザーはギャラリーで一時停止したエージェントを表示できません。
- セッションの再試行の失敗: イベント トリガーで関連付けられたコネクタからデータを取得する際のエラーが原因でエージェントの実行が失敗すると、ステータスが失敗したセッションが作成されます。失敗したセッションの手動再試行は現在サポートされていません。
- フィルタ: 最も重要なイベントでエージェントがタイムリーに実行されるように、イベント トリガーには常にフィルタを追加してください。
- Gmail トリガー:
- メールの量が多いユーザーの場合、エージェントの開始が遅くなることがあります。
- Gmail は、[メールが送信されたとき] と [メールが受信されたとき] の 2 つのトリガーをサポートしています。メールを送信してエージェントをトリガーする場合は、[メールが送信されたとき] を使用します。[When an email is received] を使用しても、エージェントはトリガーされません。
システム制約の一覧については、Workflow Builder の割り当てと 上限をご覧ください。
次のステップ
- コネクタ アクションの使用方法を学習する。
- フィルタを使用して検索する方法を学習する。
- エージェントの実行ログを表示する方法を学習する。
- ワークフロー エージェントをオンまたはオフにする方法を学習する。