Google Machine Learning Engine 확장 프로그램

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

버전 1.2.1

Cloud Machine Learning Engine에서 예측을 요청합니다. predict 작업을 통해 기존의 학습된 모델에 예측을 요청하고 제공할 수 있습니다.

Google Cloud 프로젝트 ID 및 사용자 인증 정보로 이 확장 프로그램을 구성한 후 Extension콜아웃 정책을 사용하여 API 프록시에서 호출할 수 있습니다. 정책 구성에서 사용할 모델 및 모델 버전과 모델이 예측에 사용할 인스턴스 데이터를 지정합니다.

Cloud ML Engine을 시작하려면 Cloud ML Engine 소개를 참조하세요.

기본 요건

이 콘텐츠는 이 확장 프로그램을 구성하고 사용하기 위한 참조를 제공합니다. Extension콜아웃 정책을 사용하여 API 프록시의 확장 프로그램을 사용하려면 다음 요건을 충족해야 합니다.

  1. 모델이 있는지 확인합니다.

    Cloud ML Engine 모델 및 기타 개념에 대한 자세한 내용은 프로젝트, 모델, 버전, 작업을 참조하세요.

  2. GCP 콘솔을 사용하여 서비스 계정의 키를 생성합니다.

  3. 구성 참조를 사용하여 확장 프로그램을 추가 및 구성할 때 결과 키 JSON 파일의 콘텐츠를 사용합니다.

Google Cloud Machine Learning Engine 정보

Cloud Machine Learning Engine의 경우 Google Cloud Platform의 리소스를 사용하여 머신러닝 모델을 학습시킬 수 있습니다. 학습된 모델을 Cloud ML Engine에서 호스팅하여 GCP 서비스를 사용해 예측 요청을 보내고 모델과 작업을 관리할 수 있습니다.

작업

predict

지정된 모델을 사용하여 지정된 인스턴스 데이터에 대한 예측을 수행합니다.

문법

<Action>predict</Action>
<Input><![CDATA[{
  "model" : model-for-prediction,
  "version" : model-version,
  "instances" : data-to-use-for-making-prediction
}]]></Input>

<Action>predict</Action>
<Input><![CDATA[{
  "model" : mymodel,
  "version" : version4,
  "instances" : {"instances": ["the quick brown fox", "la bruja le dio"]}
}]]></Input>

요청 매개변수

매개변수 설명 유형 기본 계정 필수
model 예측에 사용할 모델입니다. 문자열 없음 예.
버전 예측에 사용할 ML 솔루션의 버전입니다. 문자열 없음 예.
인스턴스 예측을 가져올 인스턴스입니다. 이 값의 항목 모양은 예측에 사용하는 모델의 기대치에 따라 달라집니다. 자세한 내용은 예측 요청 세부정보를 참조하세요. 배열 없음 예.

응답

ExtensionCall 정책 구성에 지정된 모델에서 반환한 예상 검색어 데이터가 포함된 predictions 배열입니다.

{
  "predictions": [
    {
      "probabilities": [
        0.9435398578643799,
        0.05646015331149101
      ],
      "logits": [
        -2.816103458404541
      ],
      "classes": [
        "0"
      ],
      "class_ids": [
        0
      ],
      "logistic": [
        0.056460149586200714
      ]
    },
    {
      "probabilities": [
        0.9271764755249023,
        0.07282354682683945
      ],
      "logits": [
        -2.54410457611084
      ],
      "classes": [
        "0"
      ],
      "class_ids": [
        0
      ],
      "logistic": [
        0.07282353937625885
      ]
    }
  ]
}

구성 참조

API 프록시에서 사용할 이 확장 프로그램을 구성하고 배포할 때 다음을 사용하세요. Apigee 콘솔을 사용하여 확장 프로그램을 구성하는 단계는 확장 프로그램 추가 및 구성을 참조하세요.

일반적인 확장 속성

모든 확장 프로그램에는 다음과 같은 속성이 있습니다.

속성 설명 기본 필수
name 확장 프로그램의 구성에 지정할 이름입니다. 없음 지원됨
packageName Apigee Edge에서 제공하는 확장 프로그램 패키지 이름입니다. 없음 지원됨
version 확장 프로그램을 구성하는 확장 프로그램 패키지의 버전 번호입니다. 없음 지원됨
configuration 추가하는 확장 프로그램 관련 구성 값입니다. 이 확장 프로그램 속성의 속성을 참조하세요. 없음 지원됨

이 확장 프로그램 패키지의 속성

이 확장 프로그램에 해당하는 다음 구성 속성의 값을 지정합니다.

속성 설명 기본 계정 필수
projectId 이 확장 프로그램에서 사용하는 학습된 모델이 포함된 GCP 프로젝트의 ID입니다. 없음 예.
사용자 인증 정보 Apigee Edge 콘솔에 입력하면 서비스 계정 키 파일의 콘텐츠가 됩니다. 관리 API를 통해 전송되는 경우 서비스 계정 키 파일에서 생성된 base64로 인코딩된 값입니다. 없음 예.