Ontology 소프트웨어 개발 키트(OSDK)는 개발 환경에서 Ontology의 기능을 활용하게 해주는 SDK다. TypeScript용 npm, Python용 pip 또는 Conda, Java용 Maven을 지원하며, 그 밖의 언어에서는 OpenAPI 사양을 사용할 수 있다.

Foundry를 백엔드로 사용하면 대규모 쿼리 처리와 Foundry 쓰기 작업, 세분화된 거버넌스 제어를 활용해 조직에서 사용할 애플리케이션을 안전하게 개발할 수 있다. OSDK 애플리케이션을 만들고 관리하려면 Developer Console을 이용한다. 아래 내용은 SDK 관련 참조 문서를 안내한다.

OSDK의 기능과 접근 제어

Palantir는 OSDK가 제공하는 주요 이점으로 개발 속도, 강한 타입 안정성, 중앙 집중식 유지 관리, 설계 단계부터 고려한 보안을 꼽는다. OSDK는 Foundry Ontology를 기반으로 한 앱 개발을 빠르게 시작하도록 돕고, Ontology API에 편리하게 접근해 적은 코드로 Ontology를 읽고 쓸 수 있게 한다. Ontology에서 관련 부분만 골라 함수와 타입을 생성하므로, 편집기에서 Ontology를 직접 조회하고 탐색할 수 있다. Ontology를 Foundry에서 중앙 관리하면 애플리케이션 개발에 집중하고 데이터 기반을 구축할 때 드는 일반적인 유지 관리 부담을 줄일 수 있다는 설명이다.

OSDK는 애플리케이션이 접근하도록 지정한 온톨로지 엔티티에만 범위를 제한한 토큰을 사용하며, 데이터 접근에는 사용자의 권한도 적용한다. 행과 열 수준의 접근 제어는 읽기 시점에 적용된다. 여기에는 제한된 뷰, 객체 보안 정책, 속성 보안 정책이 포함되며, 사용자가 OSDK를 통해 읽을 수 있는 데이터를 필터링한다. 권한이 없는 데이터는 읽을 수 없다.

다만 이 제어는 OSDK 응답 페이로드나 애플리케이션이 데이터를 처리하는 방식까지 이어지지 않는다. 데이터가 후속 단계로 전달되는 동안에도 보호하려면 마킹 또는 분류 기반 접근 제어를 함께 적용해야 한다. 전체 접근 제어 모델은 접근 제어 전파 문서에서 확인할 수 있다.

프런트엔드 개발용 TypeScript 바인딩을 이용하면 Foundry를 기반으로 React 애플리케이션을 빠르게 만들 수 있다. 생성된 코드는 속성 이름과 설명 등 Ontology 메타데이터를 사용하며, 이 메타데이터는 편집기에서 확인할 수 있다.

애플리케이션 시작하기

Ontology를 UI가 아니라 코드로 정의한다면 아래 절차 대신 SuperRepo를 만드는 방안을 고려할 수 있다. SuperRepo는 Ontology와 애플리케이션이 함께 발전하며 하나의 산출물로 버전 관리하고 릴리스하는 경우에 적합하다. SuperRepo에서는 객체 유형, 링크, 액션을 Ontology-as-code 방식으로 선언하고, 같은 저장소에서 함수와 프런트엔드도 관리한다. OSDK는 로컬에서 생성되며 정의가 바뀔 때마다 다시 생성된다. 따라서 SDK 버전을 변경할 때마다 다시 게시하지 않고도 Ontology를 확장하고 새 타입을 사용할 수 있으며, 편집과 미리 보기를 한 흐름에서 진행할 수 있다.

OSDK로 애플리케이션을 만들려면 Developer Console에서 새 애플리케이션을 만든다. 그런 다음 언어별 안내에 따라 애플리케이션의 기본 구성을 설정한다. TypeScript 안내를 따르거나, 기존 TypeScript 애플리케이션에 OSDK를 추가할 수 있다. Python은 Python 안내, Java는 Java 안내를 따른다. 필요하면 애플리케이션을 Foundry에서 호스팅할 수 있다.

OSDK 없이 기본 구성을 마친 기존 애플리케이션에 통합하려면 기본 구성을 마친 저장소에 OSDK 추가하기를 참고한다. 컨테이너화된 애플리케이션에서 Foundry Ontology 객체와 상호작용할 때는 컴퓨트 모듈에서도 OSDK를 사용할 수 있다.

언어별 참조 문서

언어별 API 참조 문서는 다음과 같다.

그 밖에 애플리케이션 생성과 관리 방법을 다루는 Developer Console 개요, OSDK로 React 애플리케이션을 만드는 OSDK React 애플리케이션, 개발 작업 흐름을 설정하는 개발 환경 문서가 있다. Ontology와 함수, 애플리케이션을 하나의 프로 코드 저장소에서 정의하고 코드 정의로 OSDK를 생성하는 SuperRepo 문서도 제공한다.

Foundry 환경 전반에 OSDK 애플리케이션을 패키징하고 배포하려면 Marketplace로 Developer Console 애플리케이션 설치하기를 참고할 수 있다. AI 지원 개발 도구를 이용해 IDE에서 Ontology SDK를 다루는 Palantir MCP 안내도 있다.