이 페이지는 Cloud Translation API를 통해 번역되었습니다.

설명 보기

이 가이드에서는 Vertex AI의 Model 리소스에서 설명을 확인하는 방법을 설명합니다. 다음 두 가지 방법으로 설명을 확인할 수 있습니다.

온라인 설명: Vertex AI API에 대한 동기식 요청으로, 특징 기여 분석이 포함된 추론을 반환하는 온라인 추론과 유사합니다.
일괄 설명: 특성 기여 분석이 포함된 추론을 반환하는 Vertex AI API에 대한 비동기식 요청입니다. 일괄 설명은 일괄 추론 요청의 선택사항 부분입니다.

시작하기 전에

설명을 보기 전에 다음을 수행해야 합니다.

이 단계는 사용하는 머신러닝 모델의 유형에 따라 달라집니다.
- 커스텀 학습 모델에서 설명을 확인하려면 예시 기반 설명 구성 또는 특성 기반 설명 구성에 따라 Vertex Explainable AI를 지원하는 Model을 만듭니다.
- AutoML 테이블 분류 또는 회귀 모델에서 설명을 가져오려면 테이블 형식 데이터 세트에서 AutoML 모델을 학습시킵니다. Vertex Explainable AI를 사용하는 데는 특별한 구성이 필요하지 않습니다. 예측 모델에 대한 설명은 지원되지 않습니다.
- AutoML 이미지 분류 모델에서 설명을 가져오려면 이미지 데이터 세트에서 AutoML 모델을 학습시키고 모델을 배포할 때 설명을 사용 설정합니다. Vertex Explainable AI를 사용하는 데는 특별한 구성이 필요하지 않습니다. 객체 감지 모델에 대한 설명은 지원되지 않습니다.
온라인 설명을 확인하려면 이전 단계에서 만든 Model을 Endpoint 리소스에 배포합니다.

온라인 설명을 확인하려면 온라인 추론을 수행하는 것과 동일한 단계의 대부분을 실행합니다. 하지만 Vertex AI API에 projects.locations.endpoints.predict 요청을 전송하는 대신 projects.locations.endpoints.explain 요청을 전송합니다.

다음 가이드에서는 온라인 설명 요청 준비 및 전송에 대한 자세한 안내를 제공합니다.

특성 기반 일괄 설명만 지원되며, 예시 기반 일괄 설명은 가져올 수 없습니다.

일괄 설명을 확인하려면 일괄 추론 작업을 만들 때 generateExplanation 필드를 true로 설정합니다.

일괄 예측 작업 준비 및 만들기에 대한 자세한 안내는 일괄 추론 가져오기를 참고하세요.

Explainable AI는 동시 설명을 지원합니다. 동시 설명을 사용하면 각 설명 메서드에 모델을 별도로 배포할 필요 없이 동일한 배포된 모델 엔드포인트에서 특성 기반 설명 및 예시 기반 설명을 모두 요청할 수 있습니다.

동시 설명을 가져오려면 모델을 업로드하고 예시 기반 또는 특성 기반 설명을 구성합니다. 그런 다음 평소와 같이 모델을 배포합니다.

모델이 배포된 후에는 평소와 같이 구성된 설명을 요청할 수 있습니다. 또한 concurrent_explanation_spec_override를 지정하여 동시 설명을 요청할 수 있습니다.

동시 설명을 사용할 때는 다음 사항에 유의하세요.

v1beta1 API 버전에서만 동시 설명이 가능합니다. Vertex python SDK를 사용 중인 경우 동시 설명을 사용하려면 preview 모델을 사용해야 합니다.
특성 기반 설명으로 배포한 후에는 예시 기반 설명을 요청할 수 없습니다. 예시 기반 설명과 특성 기반 설명을 모두 사용하려면 예시 기반 설명을 사용하여 모델을 배포하고 동시 설명 필드를 사용하여 특성 기반을 요청합니다.
동시 설명에서는 일괄 설명이 지원되지 않습니다. 온라인 설명은 이 기능을 사용할 수 있는 유일한 방법입니다.

이 섹션에서는 설명을 확인하는 동안 문제가 발생할 경우 도움이 될 수 있는 문제 해결 단계를 설명합니다.

설명을 요청할 때 다음과 같은 오류 메시지가 표시되면 다음을 수행합니다.

"error": "Explainability failed with exception: listindex out of range"

객체 배열이 필요한 필드에 빈 배열을 전달하지 않았는지 확인합니다. 예를 들어 field1에서 객체 배열을 허용하는 경우 다음 요청 본문으로 인해 오류가 발생할 수 있습니다.

{
  "instances": [
    {
      "field1": [],
    }
  ]
}

대신 배열이 비어 있지 않은지 확인합니다. 예를 들면 다음과 같습니다.

{
  "instances": [
    {
      "field1": [
        {}
      ],
    }
  ]
}