TypeScript v1 리소스 가져오기

Code Repositories의 Resource imports 사이드바는 함수 저장소가 사용하는 온톨로지 유형, 언어 모델, 모델 라이브 배포와 외부 시스템을 관리합니다. 이 장의 resources.json 및 functions.json 설정은 TSv1 템플릿에 적용합니다.

온톨로지와 리소스 선택

Add > Ontology로 객체와 링크를 선택합니다. 선택된 온톨로지가 없다면 선택 창이 열리고, 이미 유형을 가져왔다면 그 온톨로지를 사용합니다. 이름 옆 Edit로 온톨로지를 바꿀 수 있습니다.

저장소의 가져온 리소스는 같은 온톨로지에 속해야 합니다. 온톨로지를 바꾼 뒤 리소스를 가져오면 다른 온톨로지에서 가져온 기존 항목을 덮어씁니다.

다른 유형도 Add에서 선택한 뒤 검색과 필터를 사용합니다. 리소스를 선택하면 미리보기에서 세부 정보를 볼 수 있으며 Select로 장바구니에 추가합니다. 장바구니를 펼쳐 선택을 검토하고 Confirm selection을 선택합니다.

확정 후 Code Assist를 다시 시작하여 코드 생성 작업을 실행합니다. 생성 리소스는 파일 상대 경로가 아니라 생성 패키지 경로에서 가져옵니다. 예를 들어 온톨로지는 @foundry/ontology-api를 사용합니다.

온톨로지 유형과 외부 소스 및 웹훅은 각 준비 조건을 따릅니다. 모델 라이브 배포도 같은 선택기에서 가져오되 해당 기능 플래그를 활성화해야 합니다. TSv2와 Python의 언어 모델 호출은 별도의 모델 별칭과 프록시 경로를 사용합니다.

일반 외부 JavaScript 라이브러리는 이 리소스 선택기 대신 npm 의존성 추가의 Libraries 또는 package.json 절차를 사용합니다.

필터, 세부 정보와 제거

Ontology는 객체, 인터페이스와 링크를, Models는 언어 모델과 라이브 배포를, Sources는 외부 시스템을 표시합니다. 위쪽 유형 아이콘이나 이름 검색으로 목록을 좁힙니다.

항목을 선택하면 미리보기가 열립니다. 마우스를 올리고 Remove를 선택하면 제거하며 여러 항목은 선택 대화 상자에서 함께 추가하거나 제거합니다. 링크가 객체 유형에 종속되는 경우처럼 의존 항목이 있으면 (1 link type) 형태의 표시가 나타납니다. 아이콘 위에 마우스를 올리고 펼침 표시를 선택해 확인합니다.

API 이름과 값 유형 충돌

코드에서 참조할 리소스에는 API 이름이 필요합니다. 경고에 마우스를 올리면 원인을 볼 수 있고 Add API name으로 설정하거나 Learn more로 해당 유형의 설정을 확인합니다.

함수 인터페이스처럼 값 유형에 의존하는 리소스는 필요한 값 유형도 자동으로 가져옵니다. 두 리소스가 같은 값 유형의 서로 다른 버전에 의존하면 한 저장소에서 두 버전을 함께 가져올 수 없어 컴파일 오류가 발생합니다. 사이드바 경고에서 충돌하는 리소스를 확인하고 의존 버전을 맞춰야 합니다.

resources.json

새 TSv1 템플릿은 리소스 가져오기 상태를 커밋된 resources.json에 저장합니다. 사이드바는 이 파일을 수정하므로 Git에서 변경 검토, 브랜치 분리와 되돌리기를 할 수 있습니다.

해석할 수 없다는 경고가 나오면 파일이 JSON 객체 하나인지, 필드와 배열 항목의 형식이 맞는지 확인합니다. 커밋 이력에서 정상 버전을 찾아 복구할 수도 있습니다.

version: 0은 이전 저장소 전체 가져오기 방식에서 이전해야 한다는 표시입니다. 이 상태로 커밋하면 자동 패치로 이전을 수행합니다. 일반적으로 편집하는 형식 버전은 1이며 함수 버전과는 다릅니다.

functions.json 기능 플래그

전형적인 설정은 다음과 같습니다. 기존 파일의 관련 항목을 수정하며, 다른 설정을 없애기 위해 파일 전체를 교체하지 않습니다.

{
  "useOntologyApiNames" : true,
  "enableModelFunctions" : false,
  "enableModelGraphFunctions" : false,
  "enableDiscoverImproperOntologyAccess": false,
  "enableQueries": false,
  "enableModelMetadata": false,
  "useDeploymentApiNames": true,
  "enableVectorProperties": true,
  "enableTimeSeriesProperties": false,
  "enableExternalSystems": false,
  "enableMediaReferenceProperties": false
}

라이브 배포를 사용하려면 enableModelFunctions, 외부 소스를 사용하려면 enableExternalSystems를 true로 설정합니다. 리소스를 가져오기만 하고 필요한 플래그를 켜지 않으면 저장소 검사가 실패할 수 있습니다.