Predict API

출처: 문서

본문

Predict API

ML Commons는 학습된 모델을 사용해 인덱싱된 데이터나 데이터 프레임에서 새로운 데이터를 예측할 수 있어요. Predict API를 사용하려면 model_id가 필요해요.

이 API의 사용자 접근에 대한 정보는 모델 접근 제어 고려 사항을 참고하세요.

엔드포인트

POST /_plugins/_ml/_predict/{algorithm_name}/{model_id}

요청 본문 필드

사용할 수 있는 요청 필드는 다음 표와 같아요.

외부에서 호스팅되는 모델의 경우 실제 입력 필드는 모델의 커넥터 설정에 따라 달라져요. 자세한 내용은 커넥터를 참고하세요.

요청 예시

POST /_plugins/_ml/_predict/kmeans/{model-id}
{
    "input_query": {
        "_source": ["petal_length_in_cm", "petal_width_in_cm"],
        "size": 10000
    },
    "input_index": [
        "iris_data"
    ]
}

{% include copy-curl.html %}

응답 예시

{
  "status" : "COMPLETED",
  "prediction_result" : {
    "column_metas" : [
      {
        "name" : "ClusterID",
        "column_type" : "INTEGER"
      }
    ],
    "rows" : [
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 1
          }
        ]
      },
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 1
          }
        ]
      },
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 0
          }
        ]
      },
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 0
          }
        ]
      },
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 0
          }
        ]
      },
      {
        "values" : [
          {
            "column_type" : "INTEGER",
            "value" : 0
          }
        ]
      }
    ]
  }
}

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/api/train-predict/predict/