문제 해결

이 페이지에서는 Model Armor 관련 문제를 해결하는 방법을 보여줍니다.

이 섹션에는 Model Armor 사용 시 문제가 발생할 경우 도움이 될 수 있는 문제 해결 단계가 포함되어 있습니다.

Model Armor에 대한 모든 API 호출이 404 Not Found 오류를 반환함

Model Armor API에 Private Service Connect를 설정합니다. 이 오류는 일반적으로 비공개 Google 액세스를 사용하거나 Private Service Connect 없이 Model Armor 리전 엔드포인트 (REP)에 액세스할 때 발생합니다. 자세한 내용은 Private Service Connect 엔드포인트를 통한 리전 엔드포인트 액세스 정보를 참조하세요.

Sensitive Data Protection 필터에 오류가 발생하거나 필터가 건너뛰어짐

다음 사항을 확인하세요.

  • Sensitive Data Protection 템플릿이 호출되는 Model Armor 엔드포인트와 동일한 리전에 있습니다.
  • Model Armor 요청을 하는 서비스 에이전트에는 Sensitive Data Protection 템플릿이 포함된 프로젝트의 dlp.User 및 dlp.Reader 역할이 있습니다.

이 오류는 SanitizeUserPrompt 또는 SanitizeModelResponse 요청의 클라이언트 오류 또는 Sensitive Data Protection 템플릿의 문제로 인해 발생합니다.

Model Armor 전역 엔드포인트 오류

전역 엔드포인트가 아닌 적절한 리전 엔드포인트에 API 요청을 하고 있는지 확인합니다.

Model Armor는 리전 엔드포인트에서만 다음 작업을 지원합니다.

  • 템플릿에 대한 생성, 읽기, 업데이트, 삭제, 나열 작업
  • SanitizeUserPrompt 및 SanitizeModelResponse API 요청

이러한 작업에 대한 API 요청을 전역 엔드포인트에 전송하면 다음 오류가 표시됩니다.

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

Model Armor 리전 엔드포인트에 액세스할 때 인증서 오류

이 오류는 일반적으로 비공개 Google 액세스 또는 VPC 서비스 제어를 사용하여 VPC 네트워크 내에서 Model Armor 리전 엔드포인트에 액세스하고 인증서 확인이 실패할 때 발생합니다.

예를 들어 다음과 유사한 오류 메시지가 표시될 수 있습니다.

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

이 문제를 해결하려면 Model Armor API에 대한 Private Service Connect 엔드포인트를 만듭니다. 자세한 내용은 Private Service Connect 엔드포인트를 통한 리전 엔드포인트 액세스 정보를 참조하세요.

리전에서 요청된 기능을 지원하지 않음

다음과 유사한 오류 메시지가 표시될 수 있습니다.

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

이 오류는 기능 제한이 있는 리전에서 템플릿을 만들거나 업데이트하려고 시도하고 요청이 해당 리전에서 지원되지 않는 기능을 사용 설정하는 경우에 발생합니다.

이 문제를 해결하려면 다음 안내를 따르세요.

  1. 오류 메시지에 표시된 지원되지 않는 기능을 식별합니다.
  2. 리전별 기능 사용 가능 여부를 검토하여 대상 리전에서 사용할 수 없는 기능을 확인합니다.
  3. 만들거나 업데이트하는 템플릿에서 지원되지 않는 기능을 삭제합니다.

또는 데이터 레지던시 요구사항에서 허용하는 경우 해당 기능을 지원하는 다른 Model Armor 리전을 사용합니다.

템플릿 데이터 레지던시 규정 준수가 필요합니다.

다음과 유사한 400 (FAILED_PRECONDITION) 오류 메시지가 표시될 수 있습니다.

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

이 오류는 Model Armor 템플릿 데이터 레지던시 규정 준수 필요(constraints/modelarmor.managed.requireTemplateDataResidencyCompliance) 관리형 조직 정책 서비스 제약 조건이 적용되고 데이터 레지던시 규정 준수가 사용 중지된 상태에서 Model Armor 템플릿을 만들거나 업데이트할 때 발생합니다. data_residency_compliant를 false로 설정하거나 데이터 상주 적용 옵션을 선택 해제하면 데이터 레지던시 규정 준수가 사용 중지됩니다. 이 제약 조건은 기본적으로 적용되므로 data_residency_compliant가 이미 false로 설정된 기존 템플릿에서 필터와 같은 설정을 수정해도 이 오류가 트리거됩니다. 템플릿을 업데이트하지 않는 한 기존 템플릿과 프롬프트 및 응답을 정리하라는 요청은 영향을 받지 않습니다.

이 문제를 해결하려면 다음 중 한 가지를 따르세요.

  • data_residency_compliant를 true로 설정하거나 데이터 레지던시 적용 옵션을 선택하여 템플릿에서 데이터 레지던시 규정 준수를 사용 설정합니다.
  • 템플릿에 데이터 레지던시 규정 준수를 사용 중지해야 하는 경우 데이터 레지던시에 대한 조직 정책 제약조건 사용 중지의 단계에 따라 조직 정책 관리자가 제약조건을 사용 중지하도록 합니다.