Fehler beheben

Auf dieser Seite wird beschrieben, wie Sie Probleme mit Model Armor beheben.

Dieser Abschnitt enthält Schritte zur Fehlerbehebung, die bei Problemen mit Model Armor hilfreich sein können.

Alle API-Aufrufe an Model Armor geben den Fehler „404 Nicht gefunden“ zurück

Stellen Sie eine Private Service Connect-Verbindung zu den Model Armor APIs her. Dieser Fehler tritt normalerweise auf, wenn auf regionale Endpunkte (REPs) von Model Armor über den privater Google-Zugriff oder ohne Private Service Connect zugegriffen wird. Weitere Informationen finden Sie unter Zugriff auf regionale Endpunkte über Private Service Connect-Endpunkte.

Sensitive Data Protection-Filter gibt einen Fehler aus oder wird übersprungen

Gehen Sie so vor:

  • Die Sensitive Data Protection-Vorlage befindet sich in derselben Region wie der aufgerufene Model Armor-Endpunkt.
  • Der Dienst-Agent, der die Model Armor-Anfrage stellt, hat die Rollen dlp.User und dlp.Reader im Projekt, das die Sensitive Data Protection-Vorlage enthält.

Dieser Fehler tritt aufgrund von Clientfehlern in den SanitizeUserPrompt- oder SanitizeModelResponse-Anfragen oder Problemen mit der Sensitive Data Protection-Vorlage auf.

Fehler bei globalen Model Armor-Endpunkten

Achten Sie darauf, dass Sie die API-Anfragen an den entsprechenden regionalen Endpunkt und nicht an den globalen Endpunkt senden.

Model Armor unterstützt die folgenden Vorgänge nur an seinen regionalen Endpunkten:

  • Vorgänge zum Erstellen, Lesen, Aktualisieren, Löschen und Auflisten von Vorlagen.
  • SanitizeUserPrompt- und SanitizeModelResponse-API-Anfragen.

Wenn Sie die API-Anfragen für diese Vorgänge an den globalen Endpunkt senden, wird der folgende Fehler angezeigt:

{
  "error": {
    "code": 403,
    "message": "Write access to project '<PROJECT_ID>' was denied",
    "status": "PERMISSION_DENIED"
  }
}

Zertifikatsfehler beim Zugriff auf regionale Model Armor-Endpunkte

Dieser Fehler tritt normalerweise auf, wenn auf regionale Model Armor-Endpunkte innerhalb eines VPC-Netzwerk über den privater Google-Zugriff oder VPC Service Controls zugegriffen wird und die Zertifikatsprüfung fehlschlägt.

Beispielsweise kann eine Fehlermeldung wie die folgende angezeigt werden:

curl: (60) SSL: no alternative certificate subject name matches target host name 'modelarmor.europe-west4.rep.googleapis.com'

Um dieses Problem zu beheben, erstellen Sie einen Private Service Connect-Endpunkt für die Model Armor APIs. Weitere Informationen finden Sie unter Zugriff auf regionale Endpunkte über Private Service Connect-Endpunkte.

Region unterstützt die angeforderten Funktionen nicht

Möglicherweise wird eine Fehlermeldung wie die folgende angezeigt:

Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'

Dieser Fehler tritt auf, wenn Sie versuchen, eine Vorlage in einer Region mit Funktionseinschränkungen zu erstellen oder zu aktualisieren, und die Anfrage Funktionen aktiviert, die in dieser Region nicht unterstützt werden.

So lösen Sie dieses Problem:

  1. Ermitteln Sie die nicht unterstützten Funktionen, die in der Fehlermeldung aufgeführt sind.
  2. Prüfen Sie die Verfügbarkeit von Funktionen nach Region, um festzustellen, welche Funktionen für Ihre Zielregion nicht verfügbar sind.
  3. Entfernen Sie die nicht unterstützten Funktionen aus der Vorlage, die Sie erstellen oder aktualisieren.

Alternativ können Sie eine andere Model Armor-Region verwenden, die die Funktionen unterstützt, sofern Ihre Anforderungen an den Datenstandort dies zulassen.

Die Einhaltung der Anforderungen an den Datenstandort für Vorlagen ist erforderlich

Möglicherweise wird eine Fehlermeldung vom Typ 400 (FAILED_PRECONDITION) angezeigt, die in etwa so aussieht:

Template data residency compliance is required. The 'Enforce data residency' field must not be set to false.

Dieser Fehler tritt auf, wenn die verwaltete Einschränkung des Organisationsrichtliniendienstes Require Model Armor Template Data Residency Compliance (constraints/modelarmor.managed.requireTemplateDataResidencyCompliance) erzwungen wird und Sie eine Model Armor-Vorlage mit deaktivierter Datenstandort-Compliance erstellen oder aktualisieren. Die Einhaltung des Datenstandorts ist deaktiviert, wenn Sie data_residency_compliant auf false setzen oder die Option Datenstandort erzwingen deaktivieren. Da diese Einschränkung standardmäßig erzwungen wird, wird dieser Fehler auch ausgelöst, wenn Sie eine Einstellung wie einen Filter in einer vorhandenen Vorlage bearbeiten, für die data_residency_compliant bereits auf false gesetzt ist. Vorhandene Vorlagen und Anfragen zum Bereinigen von Prompts und Antworten sind davon nicht betroffen, es sei denn, Sie aktualisieren die Vorlage.

Führen Sie einen der folgenden Schritte aus, um das Problem zu lösen:

  • Aktivieren Sie die Compliance mit dem Datenstandort in der Vorlage, indem Sie data_residency_compliant auf true setzen oder die Option Datenstandort erzwingen auswählen.
  • Wenn Sie die Einhaltung des Datenstandorts für die Vorlage deaktiviert lassen möchten, folgen Sie der Anleitung unter Einschränkung der Organisationsrichtlinie für den Datenstandort deaktivieren, damit Ihr Administrator für Organisationsrichtlinien die Einschränkung deaktiviert.