이 페이지에서는 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및SanitizeModelResponseAPI 요청
이러한 작업에 대한 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'
이 문제를 해결하려면 Private Service Connect 엔드포인트를 Model Armor API에 만드세요. 자세한 내용은 Private Service Connect 엔드포인트를 통한 리전 엔드포인트 액세스 정보를 참조하세요.
리전에서 요청된 기능을 지원하지 않음
다음과 유사한 오류 메시지가 표시될 수 있습니다.
Region '<var>REGION</var>' does not support the requested capabilities: '<var>CAPABILITIES</var>'
이 오류는 기능 제한이 있는 리전에서 템플릿을 만들거나 업데이트하려고 시도하고 요청에서 해당 리전에서 지원되지 않는 기능을 사용 설정할 때 발생합니다.
템플릿 구성에는 지원되지 않는 기능이 있는 일부 리전에서 사용할 수 없는 악성 URL 및 CSAM과 같은 감지기가 포함되어 있습니다.
이 문제를 해결하려면 다음 안내를 따르세요.
- 오류 메시지에 나열된 지원되지 않는 기능을 식별합니다.
- 리전별 기능 지원 여부 를 검토하여 대상 리전에서 사용할 수 없는 기능을 확인합니다.
- 만들거나 업데이트하는 템플릿에서 지원되지 않는 기능을 삭제합니다.
또는 데이터 상주 요구사항이 허용하는 경우 기능을 지원하는 다른 Model Armor 리전을 사용합니다.