Proactive Agent の結果に基づいてアクションを自動化する

Eventarc を使用すると、Gemini Cloud Assist のプロアクティブ モードのアクティビティを自動的にモニタリングして対応できます。

エージェントが根本原因の調査や費用の異常分析などのバックグラウンド タスクを完了すると、Webhook、スクリプト、ワークフローにルーティングできるイベントが公開されます。

始める前に

自動化トリガーを作成する

Gemini Cloud Assist は、バックグラウンド調査または最適化タスクが完了するたびに google.cloud.geminicloudassist.task.v1.completed イベントを生成します。

これらのイベントを サポートされている宛先 （Cloud Run、Cloud Run 関数、Workflows など）にルーティングして、 Slack 通知、PagerDuty インシデント、自動修復をトリガーできます。

たとえば、これらのイベントをサブスクライブして Cloud Run にルーティングするには、次のコマンドを使用します。

gcloud eventarc triggers create TRIGGER_NAME \
    --location=global \
    --destination-run-service=DESTINATION_SERVICE \
    --event-filters="type=google.cloud.geminicloudassist.task.v1.completed" \
    --event-filters="proactive=true" \
    --service-account=SERVICE_ACCOUNT

次のように置き換えます。

  • <var>TRIGGER_NAME</var>: トリガーの一意の名前。
  • <var>DESTINATION_SERVICE</var>: プロアクティブ エージェント イベントを処理する Cloud Run サービスの名前。
  • <var>SERVICE_ACCOUNT</var>: 宛先の呼び出しに使用される IAM サービス アカウントのメールアドレス。

このコマンドの使用方法の詳細については、 Eventarc でトリガーを作成するをご覧ください。

イベント ペイロード

配信されたイベントのペイロードは、Cloud Events または JSON でラップされた Protobuf 形式です。次のキーフィールドが含まれています。

  • title: タスクの概要（「費用の異常調査」 や「高レイテンシの調査」など）。
  • result_object_reference: 作成されたアーティファクトを示す URI。

特定のエージェントのフィルタリング

プロアクティブ モードでは同じイベントタイプが使用されるため、Eventarc 属性だけでは特定のエージェントを分離できません。

イベントを特定のチャネルにルーティングするには、宛先サービス（Cloud Functions など）でイベント ペイロードを解析し、title フィールドに基づいてフィルタする必要があります。

  • 費用のアラートをモニタリングするには、「費用の異常」または「費用の最適化」を含むタイトルでフィルタします。
  • トラブルシューティングをモニタリングするには、「調査」を含むタイトルでフィルタします。

次のステップ

  • プロアクティブ モードを使用して費用を最適化する方法を学習する。
  • プロアクティブ モードを使用してトラブルシューティングを行う方法を学習する。
  • エージェントの IAM 要件 を確認する。