에이전트의 권한 범위와 인증

코드 기반 에이전트는 범위가 제한된 권한(Scoped permissions)으로 Ontology SDK(OSDK), Ontology MCP(OMCP)와 Palantir MCP에 인증합니다.

플랫폼이 관리하는 연결

에이전트 템플릿으로 저장소를 만들면 Foundry가 필요한 인증정보를 준비합니다. 에이전트 라이브러리의 도우미 함수는 실행 시 서비스 주소와 인증 헤더를 해석하여 사용할 수 있는 연결을 반환합니다.

에이전트 코드에서 클라이언트 ID와 비밀값, Foundry 토큰을 직접 전달하거나 OAuth 클라이언트를 수동으로 설정할 필요는 없습니다.

외부 서비스가 별도의 API 키를 요구하면 외부 소스 연결로 관리합니다.

접근 범위를 정하는 요소

접근 범위는 게시할 때 선택한 온톨로지 바인딩과 기반 클라이언트의 애플리케이션 제한으로 정해집니다. 애플리케이션 제한은 사용할 수 있는 리소스와 작업을 한정합니다.

업무 목적에 맞게 온톨로지와 SDK 및 OMCP에 포함할 리소스, 클라이언트의 접근 제한을 설정합니다. 프롬프트에 적은 지시와 별도로 실제 권한을 구성해야 합니다.

OMCP 연결 가져오기

@palantir/agent-templates-bundle은 URL과 인증 헤더가 해석된 OMCP 연결을 반환하는 도우미를 제공합니다. 사용하는 SDK에 맞는 가져오기 경로에서 getOntologyMcpConfiguration을 호출하고 결과를 기다린 뒤 에이전트에 전달합니다.

각 프레임워크가 기대하는 연결 타입이 다르므로 템플릿의 MCP 설정 함수를 사용합니다.

OSDK 클라이언트 가져오기

같은 라이브러리에서 선택한 온톨로지에 연결된 클라이언트를 만들 수 있습니다. 먼저 에이전트에 Ontology SDK를 추가하고 필요한 리소스를 포함하여 생성합니다.

import { getOntologySdkClient } from "@palantir/agent-templates-bundle";
import { $ontologyRid } from "@ontology/sdk";

const client = await getOntologySdkClient($ontologyRid);

$ontologyRid는 생성된 SDK가 제공하는 온톨로지 식별자입니다. 클라이언트와 도구 구성이 끝나면 게시와 호출 절차로 에이전트를 업무에 연결합니다.