CX Agent Studio の VPC Service Controls を構成する

VPC Service Controls を使用すると、CX Agent Studio からデータの引き出しのリスクを軽減できます。VPC Service Controls を使用して、指定したリソースとデータを保護するサービス境界を作成します。たとえば、VPC Service Controls を使用して CX Agent Studio を保護する場合、次のアーティファクトはサービス境界を離れることができません。

  • エージェント アプリケーション データ
  • runSession のリクエストとレスポンス

CX Agent Studio では、DLP 編集テンプレート、会話エクスポート用の BigQuery、データストアなどの他のGoogle Cloud リソースを操作できます。これらのリソースはユーザーが管理するものであり、エージェント アプリケーションと同じ VPC-SC 境界内で使用できる必要があります。

制限事項

次の制限が適用されます。

  • VPC Service Controls が有効になっている場合、ツールとコールバックは任意の HTTP または HTTPS エンドポイントにリクエストを送信できません。これは、VPC Service Controls の境界外にデータが漏洩するリスクがあるためです。アウトバウンド リクエストを許可するには、プライベート VPC ターゲットにプライベート ネットワーク アクセス用の Service Directory を構成するか、プロジェクトのロケーション設定の許可されたオリジンに外部ドメインを追加する必要があります。
  • 音声録音は、境界外の Cloud Storage バケットに書き込むことはできません。
  • 会話を境界外の BigQuery データセットに書き込むことはできません。
  • 境界外の Sensitive Data Protection 秘匿化テンプレートを使用すると、会話コンテンツの秘匿化に失敗します。
  • OpenAPI ツールは、境界外の Secret を使用して認証キーを参照できません。
  • 境界外のデータストアを指定するデータストア ツールは実行できません。
  • 境界外のエージェント リソースを指定するフローベースのエージェントは、呼び出されると失敗します。
  • 境界外の Cloud Storage バケットからエージェント アプリケーションをインポートしようとすると失敗します。
  • 境界外の Cloud Storage バケットにエージェント アプリケーションをエクスポートしようとすると失敗します。

サービス境界の作成

サービス境界を作成する場合は、保護されるサービスとして CX Agent Studio(ces.googleapis.com)と CX Insights(contactcenterinsights.googleapis.com)の両方を含めます。制限するサービス(storage.googleapis.com、bigquery.googleapis.com など)を [制限付きサービス] ペインに含めます。

サービス境界の作成方法については、VPC Service Controls のドキュメントでサービス境界の作成をご覧ください。

オプションの依存関係に関する VPC Service Controls のドキュメント:

許可された送信元を使用して外部エンドポイントを許可する

VPC Service Controls が有効になっている場合、Service Directory を使用せずに外部 HTTP または HTTPS URL を呼び出すツールとコールバックは、各外部オリジン(外部 OAuth トークン エンドポイントを含む)をプロジェクトとロケーションの許可されたオリジンに追加しない限り、403 エラーでブロックされます。

許可されたオリジンを表示して更新するには、Gemini Enterprise for Customer Experience Security Settings Editor の事前定義された Identity and Access Management ロール(roles/ces.securitySettingsEditor)、または ces.securitySettings.get と ces.securitySettings.update(roles/ces.admin にも含まれる)を持つカスタムロールを付与します。スキーム、ドメイン、オプションのポート(https://api.example.com や https://api.example.com:8443 など)を含む正確なオリジンを入力します。URL パス、末尾のスラッシュ、ワイルドカードは使用しないでください。

許可されたオリジンは、コンソールまたは REST API を使用して構成できます。

サービス ディレクトリを使用したプライベート ネットワーク アクセス

CX Agent Studio は Service Directory プライベート ネットワーク アクセスと統合されているため、VPC ネットワーク内の OpenAPI ツール ターゲットに接続できます。これにより、トラフィックが Google Cloud ネットワーク内に保持され、Identity and Access Management と VPC Service Controls が適用されます。

プライベート ネットワークをターゲットとするツールを設定するには、次のようにします。

  1. サービス ディレクトリのプライベート ネットワーク構成に従って、VPC ネットワークとサービス ディレクトリ エンドポイントを構成します。

  2. 次のアドレスを含む Customer Engagement Suite サービス エージェントのサービス アカウントが、エージェント プロジェクト用に存在している必要があります。

    service-agent-project-number@gcp-sa-ces.iam.gserviceaccount.com

    Service Directory が配置されているプロジェクトの Customer Engagement Suite サービス エージェント サービス アカウントに、次のロールを付与します。

    • servicedirectory.viewer
    • servicedirectory.pscAuthorizedService

    また、Service Directory がエージェント アプリケーションとは異なるプロジェクトにある場合は、エージェント アプリケーションをホストするプロジェクトの Customer Engagement Suite サービス エージェント アカウントに servicedirectory.viewer ロールを付与する必要があります。

  3. ツールの作成時に、Service Directory サービスと URL、オプションの認証情報を指定します。このフィールドは、ツールの詳細設定で使用できます。

問題のトラブルシューティングを行う場合、非公開稼働時間チェックを設定することで Service Directory が正しく構成されていることを確認できます。