이 페이지에서는 Vertex에서 사용되는 논리의 기본 요소인 타입스크립트 함수를 설명합니다. 객체 내의 함수에서 라이브 배포 모델을 호출하는 방법은 모델에서의 함수를 참조하십시오.
함수는 입력값을 기반으로 출력값을 추정하는 모델 내의 논리인 모델 함수를 작성하는 데 사용할 수 있습니다. 이 ModelFunction
은 Vertex, 목표, 시나리오 및 나머지 Foundry 플랫폼에서 사용할 수 있습니다.
모델 함수는 입력값을 기반으로 값 세트를 추정하는 데 사용됩니다. 이러한 함수는 순수 함수로서, 동일한 입력값으로 여러 번 모델 함수를 평가하면 항상 동일한 출력값이 생성됩니다. 모델 함수는 데이터를 로드하지 않으며 입력값 세트를 기반으로 계산이 완전히 수행됩니다.
다음은 모델 함수를 사용할 때 특정 의미를 가진 몇 가지 용어입니다:
모델 함수는 Foundry에서 다음과 같은 용도로 사용됩니다:
모델 함수는 표준 함수와 다음 두 가지 주요 방법으로 다릅니다:
@foundry/functions-api
에서 가져온 @ModelFunction()
로 장식됩니다 (대신 @Function()
)표준 함수에서 수행할 수 있는 모든 작업은 모델 함수에서 수행할 수 있습니다. 예를 들어, Live Preview
에서 테스트하거나 태그 및 게시합니다. 모델 함수는 표준 함수가 사용될 수 있는 모든 맥락에서 사용할 수 있습니다.
모델 함수는 사용 가능한 함수 유형의 부분 집합만 지원합니다. 허용되는 유형은 모든 스칼라, 옵셔널 및 컬렉션과 같은 기본 유형입니다. 컬렉션 유형의 경우 컬렉션 내의 모든 객체는 허용되는 유형 중 하나여야 합니다. 주목할 만한 것은, 모델 함수는 집계, 온톨로지 유형 또는 알림을 지원하지 않습니다. 모델 함수 내의 객체에서 값을 사용하려면 사용하려는 각 속성에 대한 입력 파라미터가 있어야 합니다. 이 모델 함수를 다른 Foundry 앱 내에서 사용할 때 객체의 각 파라미터와 일치하는 속성을 지정할 수 있습니다. 이에 대해서는 아래 튜토리얼에서 자세히 다룰 예정입니다.
모델 함수는 위에서 설명한 지원되는 기본 유형 중 하나인 각 필드를 가진 익명의 사용자 정의 유형을 출력해야 합니다.
허용되지 않는 유형을 사용하여 모델 함수가 작성되면 오류가 발생하고 함수가 게시되지 않습니다:
이 튜토리얼에서 Modelling Objective에 모델을 제출하는 방법에 대해 설명합니다.
이 튜토리얼에서 Vertex에서 사용할 모델을 구성하는 방법에 대해 설명합니다.