코드 기반 에이전트
코드 기반 에이전트(Pro-code agent)는 Code Repositories에서 작성하여 Foundry 함수로 게시하는 LLM 기반 로직입니다. 모델이 입력을 해석하고 도구를 호출하여 온톨로지 데이터나 플랫폼 리소스를 읽고 변경할 수 있습니다.
Claude Agent SDK, OpenAI Agents SDK와 Google ADK용 템플릿이 제공됩니다. 이 템플릿으로 만든 에이전트는 비동기 Foundry 함수로 게시합니다.
이 기능은 베타 단계이며 인스턴스에 제공되지 않을 수 있고 동작이 바뀔 수 있습니다.
구성 요소
| 구성 | 역할 |
|---|---|
| Ontology SDK(OSDK) 클라이언트 | 선택한 온톨로지의 데이터를 코드로 읽고 변경 |
| Ontology MCP(OMCP) | 온톨로지 리소스를 모델이 호출할 수 있는 MCP 도구로 제공 |
| Palantir MCP | 저장소와 변환 등 플랫폼 리소스를 다루는 도구 제공 |
| 에이전트 로직 | 프롬프트, 사용할 도구와 모델, 응답 스트림 처리 정의 |
플랫폼 연결은 템플릿에서 제공하는 설정을 사용합니다. 저장소 구조와 SDK별 구성 방법은 에이전트 템플릿에서 확인할 수 있습니다.
권한과 인증
OSDK, OMCP와 Palantir MCP에는 플랫폼이 관리하는 제한된 권한 범위로 인증합니다. 이 플랫폼 도구를 사용하기 위해 클라이언트 ID와 비밀값이나 Foundry 토큰을 코드에 직접 전달할 필요는 없습니다.
접근할 수 있는 리소스는 게시할 때 선택한 온톨로지와 클라이언트의 접근 제한에 따라 정해집니다. 권한 범위와 인증을 먼저 확인합니다.
게시와 실행
에이전트는 온톨로지 바인딩(Ontology binding)과 에이전트 API 이름으로 게시됩니다. 이 값으로 Workshop과 OSDK 등에서 호출할 함수를 식별합니다.
Automate의 함수 효과로 실행하는 방식이 권장됩니다. 비동기 함수를 호출할 수 있는 Workshop, OSDK와 온톨로지 액션에서도 사용할 수 있습니다.
에이전트 함수는 Void를 반환합니다. 결과나 대화 기록을 온톨로지 객체에 저장하고, 호출자가 그 객체를 읽도록 구성합니다. 질의 함수로 반환값을 받는 방식과 스트리밍 또는 배치 호출은 지원하지 않습니다. 세부 계약은 게시와 호출을 따릅니다.
개발 도구
- 생성 안내: 템플릿 선택, 설정, 시험과 게시 순서를 따라 개발합니다.
- 전역 브랜치: 분기된 데이터와 애플리케이션 변경에 맞춰 개발합니다. 모든 API가 브랜치를 따르는 것은 아니므로 지원 범위를 구분합니다.
- Continue 연동: 편집기에서 자연어로 로직과 OSDK 및 OMCP의 범위를 관리합니다.
- 외부 소스: 플랫폼 밖의 API와 비밀정보가 필요한 경우 연결합니다.
온톨로지 데이터 처리, 빌드 복구와 기존 시스템 이전 등의 활용 사례를 참고하여 필요한 도구와 검토 지점을 정할 수 있습니다.