문제 해결

이 페이지에서는 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"
  }
}