모델 함수 API (V2)

ModelFunction은 모델을 온톨로지 함수로 호출하도록 연결한 함수입니다. 온라인 모델 배포에서 추론을 수행하고 모델의 입출력을 함수 자료형으로 표현합니다. 배포와 게시의 준비 조건은 모델 함수 게시를 따릅니다.

생성, 조회와 교체

Create Model Function은 새 함수를 만들며 이미 함수가 있으면 갱신합니다. Get Model Function은 연결된 함수의 RID와 버전 및 설정을 반환합니다. Replace Model Function은 기존 구성을 교체합니다.

생성 요청에는 displayName이 필요하지만 교체 요청 본문에는 이 필드가 없습니다. 두 쓰기 작업은 apiName과 isRowWise를 명시합니다. ontologyBinding의 스키마 표시는 선택형이지만 작업에는 바인딩 요구 조건이 있으므로 실제 온톨로지 RID를 제공합니다.

이 REST 요청은 modelRid로 대상을 선택하며 별도의 브랜치 입력 필드는 없습니다.

입출력과 행 단위 처리

isRowWise는 행 단위 처리 여부이며 REST 요청에서 항상 명시합니다. 행 단위 게시에는 표 입력 하나와 표 출력 하나가 필요하며 추가 Parameter나 출력이 있으면 그 조건을 만족하지 않습니다.

함수로 표현할 모델 API에는 구체적인 자료형이 필요합니다. Any나 열 선언이 없는 표는 함수 게시에 사용할 수 없으며 리스트와 맵의 원소 자료형도 지정합니다. 지원되지 않는 자료형은 오류의 fieldName과 unsupportedType으로 확인합니다.

행 단위 여부나 모델 API를 바꾸면 호출하는 앱과 함수도 변경된 호출 계약에 맞춥니다. 변경 후 반환된 functionVersion을 확인하여 소비자가 참조할 버전을 선택합니다.