새 Ontology SDK 애플리케이션 생성
이 페이지에서는 새 SDK 애플리케이션을 만드는 과정, SDK 애플리케이션에 Ontology 오브젝트 유형과 액션 유형을 추가하는 과정, 그리고 TypeScript 또는 Python SDK 패키지를 애플리케이션에 생성하는 과정을 안내합니다.
Developer Console을 사용해 Ontology SDK 애플리케이션 생성
Foundry 인스턴스에서 Developer Console로 이동하고, + 생성하기를 선택합니다.
+ 생성하기 버튼이 보이지 않는 경우, 추가 권한이 필요할 수 있습니다. 자세한 내용은 권한 관련 문서를 참조하세요.
다음으로, 나타나는 생성 마법사의 단계를 따라 다음의 내용을 입력합니다:
- 기본 정보 페이지에서 애플리케이션에 아이콘을 추가합니다; 이 아이콘은 사용자에게 동의 화면이 제시될 때 애플리케이션을 식별하는 데 사용됩니다.
- 애플리케이션 유형 페이지에서 Client-facing application을 선택합니다.
- 권한 페이지의 Authorization code grant 섹션에서 리디렉션 URL을
http://localhost:8080/auth/callback으로 설정합니다.
Configure CORS의 지침을 따라 Control Panel에서 CORS 정책에 http://localhost:8080을 추가합니다.
CORS를 구성하는 권한이 없고 Foundry 관리자가 대신 CORS를 구성할 수 없는 경우, 리디렉션 URL을 https://localhost:8080/auth/callback으로 설정합니다.
온톨로지 및 범위
- 온톨로지 및 범위 페이지에서 사용할 온톨로지를 선택합니다. 그리고, Ontology SDK 패키지에 포함시키려는 오브젝트 유형과 액션 유형을 선택합니다. 이 연습에서는 사용 가능한 어떤 오브젝트 유형이든 선택하십시오.
선택한 데이터 엔티티는 애플리케이션의 두 가지 측면을 제어합니다:
- 생성된 유형: 선택한 엔티티를 기반으로 언어 특정 바인딩이 생성됩니다. 또한, 선택한 항목을 기반으로 통합 API 문서가 생성됩니다.
- 애플리케이션 토큰: OAuth 2.0 플로우를 거치는 결과로 받은 토큰은 기본적으로 선택한 엔티티 집합에 스코프가 설정됩니다. 자세한 내용은 리소스 접근 범위를 참조하세요.
- 입력한 정보를 검토하고 확인한 후, 애플리케이션 생성하기를 선택하여 애플리케이션을 생성합니다.
- 마지막으로, 생성된 패키지의 첫 버전을 얻기 위해 첫 버전 생성하기를 선택해야 합니다.
온톨로지 특정 문서
Developer Console은 선택한 온톨로지 엔티티를 기반으로 문서를 생성합니다. 이 문서는 TypeScript, Python, 그리고 cURL 용으로 제공되며; Console의 오른쪽 상단에 있는 드롭다운 메뉴를 사용하여 다른 언어로 전환할 수 있습니다.
위의 예시에서, 각 오브젝트 유형, 액션 유형, 그리고 function은 문서화되어 있습니다. 문서에는 특정 속성이 반환되는 방법이나 파라미터가 사용될 수 있는 방법에 대한 코드 예시가 포함되어 있습니다; 이 예시들을 직접 코드에 복사하여 붙여넣을 수 있습니다.