Mit VPC Service Controls können Sie das Risiko einer Daten-Exfiltration aus CX Agent Studio reduzieren. Verwenden Sie VPC Service Controls, um einen Dienstperimeter zu erstellen, der die von Ihnen angegebenen Ressourcen und Daten schützt. Wenn Sie beispielsweise VPC Service Controls zum Schutz von CX Agent Studio verwenden, können die folgenden Artefakte Ihren Dienstperimeter nicht verlassen:
- Anwendungsdaten des KI-Agenten
- runSession-Anfragen und -Antworten
Mit CX Agent Studio können Sie mit anderenGoogle Cloud -Ressourcen wie DLP-Redaktionsvorlagen, BigQuery für den Export von Unterhaltungen und Datenspeichern interagieren. Diese Ressourcen unterliegen Ihrer Kontrolle und müssen im selben VPC-SC-Perimeter wie die Agent-Anwendung verfügbar sein.
Beschränkungen
Es gelten folgende Einschränkungen:
- Tools und Callbacks können keine Anfragen an beliebige HTTP- oder HTTPS-Endpunkte senden, wenn VPC Service Controls aktiviert ist, da dies das Risiko birgt, dass Daten außerhalb des VPC Service Controls-Perimeters exfiltriert werden. Wenn Sie ausgehende Anfragen zulassen möchten, müssen Sie entweder Service Directory für den Zugriff auf private Netzwerke für private VPC-Ziele konfigurieren oder externe Domains zu Zulässige Ursprünge in den Standorteinstellungen Ihres Projekts hinzufügen.
- Audioaufnahmen können nicht in Cloud Storage-Buckets außerhalb des Perimeters geschrieben werden.
- Unterhaltungen können nicht in BigQuery-Datasets außerhalb des Perimeters geschrieben werden.
- Sensitive Data Protection-Vorlagen für die Datenentfernung außerhalb des Perimeters führen zu Fehlern beim Entfernen von Unterhaltungsinhalten.
- OpenAPI-Tools können nicht auf Authentifizierungsschlüssel verweisen, die Secrets außerhalb des Perimeters verwenden.
- Datenspeichertools, die einen Datenspeicher außerhalb des Perimeters angeben, können nicht ausgeführt werden.
- Auf Abläufen basierende Agenten, die eine Agentenressource außerhalb des Perimeters angeben, schlagen beim Aufruf fehl.
- Der Versuch, eine KI-Agentenanwendung aus einem Cloud Storage-Bucket außerhalb des Perimeters zu importieren, schlägt fehl.
- Der Versuch, eine KI-Agentenanwendung in einen Cloud Storage-Bucket außerhalb des Perimeters zu exportieren, schlägt fehl.
Dienstperimeter erstellen
Fügen Sie beim Erstellen eines Dienstperimeters sowohl CX Agent Studio (ces.googleapis.com) als auch CX Insights (contactcenterinsights.googleapis.com) als geschützte Dienste hinzu.
Fügen Sie im Bereich Eingeschränkte Dienste alle Dienste hinzu, die Sie einschränken möchten (z. B. storage.googleapis.com, bigquery.googleapis.com).
Weitere Informationen zum Erstellen eines Dienstperimeters finden Sie unter Dienstperimeter erstellen in der Dokumentation zu VPC Service Controls.
VPC Service Controls-Dokumentation für optionale Abhängigkeiten:
Externe Endpunkte über zulässige Ursprünge zulassen
Wenn VPC Service Controls aktiviert ist, werden Tools und Callbacks, die externe HTTP- oder HTTPS-URLs ohne Verwendung von Service Directory aufrufen, mit dem Fehler 403 blockiert, es sei denn, Sie fügen jeden externen Ursprung (einschließlich aller externen OAuth-Token-Endpunkte) zu den Zulässigen Ursprüngen für Ihr Projekt und Ihren Standort hinzu.
Wenn Sie zulässige Ursprünge ansehen und aktualisieren möchten, weisen Sie die vordefinierte IAM-Rolle (Identity and Access Management) Gemini Enterprise for Customer Experience Security Settings Editor (roles/ces.securitySettingsEditor) oder eine benutzerdefinierte Rolle mit ces.securitySettings.get und ces.securitySettings.update (auch in roles/ces.admin enthalten) zu. Geben Sie genaue Ursprünge mit Schema, Domain und optionalem Port (z. B. https://api.example.com oder https://api.example.com:8443) ohne URL-Pfade, abschließende Schrägstriche oder Platzhalter an.
Sie können zulässige Ursprünge in der Console oder mit der REST API konfigurieren:
- Konsole: Öffnen Sie die CX Agent Studio-Konsole, wählen Sie Ihr Projekt und Ihren Standort aus, klicken Sie auf das Einstellungssymbol , fügen Sie jeden Ursprung unter Zulässige Ursprünge hinzu und klicken Sie auf Speichern (siehe Einstellungen für den Projektstandort).
- REST API: Rufen Sie
projects.locations.updateSecuritySettingsauf, umendpointControlPolicy.allowedOriginsfür die RessourceSecuritySettingsdes Projektstandorts zu aktualisieren.
Service Directory für den privaten Netzwerkzugriff verwenden
CX Agent Studio ist in den Zugriff auf private Netzwerke von Service Directory eingebunden, sodass es eine Verbindung zu OpenAPI-Toolzielen in Ihrem VPC-Netzwerk herstellen kann. Dadurch bleibt der Traffic im Netzwerk von Google Cloud und es werden Identity and Access Management und VPC Service Controls erzwungen.
So richten Sie ein Tool ein, das auf ein privates Netzwerk ausgerichtet ist:
Folgen Sie der Anleitung unter Private Netzwerkkonfiguration für Service Directory, um Ihr VPC-Netzwerk und Ihren Service Directory-Endpunkt zu konfigurieren.
Das Dienstkonto des Customer Engagement Suite-Dienst-Agents mit der folgenden Adresse muss für Ihr Agent-Projekt vorhanden sein:
service-agent-project-number@gcp-sa-ces.iam.gserviceaccount.com
Weisen Sie dem Dienstkonto Customer Engagement Suite Service Agent im Projekt, in dem sich Ihr Service Directory befindet, die folgenden Rollen zu:
servicedirectory.viewerservicedirectory.pscAuthorizedService
Wenn sich Ihr Service Directory in einem anderen Projekt als Ihre Agent-Anwendung befindet, müssen Sie dem Customer Engagement Suite-Dienst-Agent-Konto im Projekt, in dem Ihre Agent-Anwendung gehostet wird, außerdem die Rolle
servicedirectory.viewerzuweisen.Geben Sie beim Erstellen des Tools den Service Directory-Dienst zusammen mit der URL und optionalen Authentifizierungsinformationen an. Dieses Feld ist in den erweiterten Einstellungen des Tools verfügbar.
Zur Fehlerbehebung können Sie eine private Verfügbarkeitsdiagnose einrichten, um zu prüfen, ob Ihr Service Directory richtig konfiguriert ist.