Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

에이전트 스택

에이전트 스택(Agent Stack)은 에이전트를 만들고 실행하며 관측하기 위한 Palantir의 공통 기반과 제품 모음입니다. 코드 기반의 Palantir Agent SDK나 외부 SDK를 사용할 수도 있고, Agent Builder의 시각적 인터페이스로 구성할 수도 있습니다.

에이전트는 정보를 모으다가 사람의 검토를 기다리고, 다른 참여자의 입력을 받은 뒤 다른 애플리케이션에서 작업을 이어 갈 수 있습니다. 에이전트 스택은 세션, 문맥 항목, 이벤트와 상태 전이로 작업의 진행 상태를 유지합니다.

세션: 하나의 작업을 이어 가는 단위

세션(Session)은 특정 작업에 관한 에이전트의 상태, 문맥 항목과 이벤트 이력을 함께 보관합니다. 여러 참여자가 서로 다른 애플리케이션을 통해 같은 세션에 참여할 수 있습니다.

세션은 정해진 종료 기한 없이 유지할 수 있습니다. 새로운 정보나 다른 참여자의 입력을 기다리는 동안 문맥과 진행 상태를 보관하고, 입력이 도착하면 작업을 재개합니다.

문맥 항목: 형식이 있는 공유 정보

문맥 항목(Context item)은 세션 참여자가 다루는 메시지, 도구 결과, 구조화된 권고안이나 결정 등의 정보입니다. 작업이 진행되면서 에이전트가 수집하고 생성한 정보가 쌓입니다.

문맥 항목은 자료형이 명확하게 정의됩니다. 같은 정보라도 자동화 시스템은 구조화된 값으로 사용하고, 판단하는 사람은 대화형 화면으로 검토하고, 개발자는 실행 상세를 조사하는 데 활용할 수 있습니다.

이벤트와 상태 전이

이벤트(Event)는 사람의 메시지, 도구 결과나 다른 애플리케이션의 갱신처럼 세션에 들어오는 입력입니다.

상태 기계(State machine)는 현재 작업 단계에서 입력에 어떻게 반응할지 정의합니다. 이벤트 처리기(Event handler)는 현재 세션 상태와 들어온 이벤트를 함께 보고 다음 동작을 결정합니다.

이벤트를 처리하면서 문맥 항목을 갱신하거나 추가 작업을 시작하고, 검토 대기 같은 새 상태로 전이할 수 있습니다. 이벤트와 상태 전이 이력으로 여러 참여자가 관여한 작업의 진행 과정을 추적합니다.

send-user-message는 사용자의 메시지를 세션에 전달하는 이벤트의 예입니다. Agent Manager에서는 이벤트의 페이로드와 세션에서 일어난 반응을 함께 살펴볼 수 있습니다.

에이전트 만들기

도구구성 방식
Agent Builder시각적 화면에서 지시문과 도구를 구성하고 동작을 미리 확인한 뒤 게시
Palantir Agent SDK도구를 가진 단순한 에이전트부터 사용자 지정 상태 기계, 문맥 항목과 이벤트 처리기까지 코드로 구성
외부 SDK지원 SDK의 통합 템플릿을 사용하거나 자체 통합 구현

게시한 에이전트는 플랫폼 워크플로에 참여할 수 있으며, 실행 세션은 Agent Manager에서 조사할 수 있습니다.

Agent Manager에서 관측하고 참여

에이전트는 Compass 리소스로 게시됩니다. 프로젝트와 폴더에 정리하고 리소스 권한으로 접근을 관리할 수 있습니다.

Agent Manager는 게시된 에이전트와 그 세션을 함께 보여줍니다. 세션을 시작하고 입력을 제공하거나 실행 중인 세션에 이벤트를 보낼 수 있습니다. 문맥 항목, 이벤트 이력과 상태 갱신을 추적 기록 및 로그와 함께 검토하면 에이전트가 무엇을 보고 어떤 작업을 했는지 조사할 수 있습니다.

Workshop, Automate, Agent Manager 등 여러 애플리케이션에서 시작된 세션을 한곳에서 볼 수 있습니다. 세션을 조회하려면 해당 세션의 강제적 접근 통제와 재량적 접근 통제 요건을 모두 충족해야 합니다.

업무 흐름에 연결

새 세션을 만들어 작업을 시작하거나 기존 세션에 이벤트를 보내 진행 중인 작업에 참여할 수 있습니다.

연결 지점사용 방법제공 상태
Workshop애플리케이션에 세션을 넣어 결과 검토, 입력 제공과 새 작업 시작제공
Automate트리거 조건이 충족되면 세션 생성 또는 이벤트 전송제공
Agent platform APIs사용자 지정 애플리케이션, 서비스와 함수에서 세션 생성 및 이벤트 전송제공
OSDK의 에이전트 기능형식이 지정된 SDK 인터페이스로 사용자 지정 앱과 함수에 통합제공 예정
AIP LogicLogic 함수의 일부로 세션을 만들거나 이벤트 전송제공 예정

객체 수정을 트리거로 지정한 이 예시에서는 Automate가 기존 세션에 이벤트를 보냅니다.