Click-to-Deploy: LlamaCloud에서 클릭 한 번으로 에이전트 배포

Click-to-Deploy: LlamaCloud에서 클릭 한 번으로 에이전트 배포

LlamaCloud의 클라우드 배포는 강력한 문서 워크플로우 에이전트를 명령줄 없이, LlamaCloud UI에서 클릭 한 번으로 띄울 수 있어요. 사전 제작된 스타터 템플릿을 고르고, 시크릿을 설정하고, 배포하면 끝이에요.

출처: 공식문서

주의: LlamaAgents의 클라우드 배포는 현재 베타 프리뷰 상태고 피드백을 받기 위해 널리 공개되어 있어요. 로컬로 시도하거나 LlamaCloud에 배포해 인앱 버튼으로 피드백을 보낼 수 있어요.

스타터 템플릿으로 시작하기

LlamaCloud 대시보드에서 프로젝트의 Agents로 이동해요. 배포가 없으면 이용 가능한 스타터 템플릿을 보여주는 "Jumpstart your Agent" 섹션이 보여요.

각 스타터 템플릿은 LlamaCloud의 문서 프리미티브 — Parse, Extract, Classify — 를 다단계 파이프라인으로 결합하는 방법을 보여주는 완전한 동작 문서 워크플로우 앱이에요.

이용 가능한 스타터

템플릿 설명 핵심 기능
SEC Insights 금융 PDF 분류 및 구조화 인사이트 추출 SEC 제출물용 Parse → Classify → Extract 파이프라인
Invoice + Contract Matching 인보이스 파싱 후 계약과 매칭, 불일치 식별 다중 문서 조정 워크플로우

스타터 배포하기

  1. 스타터 템플릿 카드를 눌러 배포 다이얼로그를 열어요.
  2. 배포 이름을 입력해요 (문자·숫자·대시만 허용).
  3. 스타터가 API 키를 요구하면(OPENAI_API_KEY 등) Required secrets 섹션에 입력해요.
  4. Deploy를 눌러요.

LlamaCloud가 템플릿 저장소를 복제하고 애플리케이션을 빌드·배포해요. 보통 1–3분 걸리고, 배포가 완료되면 에이전트가 상태와 함께 배포 목록에 나타나요.

에이전트 보기

배포 상태가 Running이 되면 Visit를 눌러 에이전트 UI를 열어요. 대부분 스타터에 웹 인터페이스가 포함되어 있어요.

  • 처리할 문서 업로드
  • 추출된 데이터·분류 결과 보기
  • 결과 검토·수정 (extraction-review 워크플로우용)

대부분 스타터는 샘플 데이터 파일도 포함해요. 배포 카드의 Example Data를 눌러 테스트 문서를 내려 받을 수 있어요.

배포 커스터마이즈

스타터 템플릿은 완전히 커스터마이즈 가능해요. 워크플로우 로직·UI·구성을 바꾸려면:

Fork해서 편집

  1. 배포 카드의 Customize를 누르거나 드롭다운 메뉴에서 Edit을 선택해요.
  2. 링크를 따라가 GitHub에서 저장소를 fork해요.
  3. fork한 저장소에서 변경해요.
  4. 배포의 Repository URL을 fork로 바꿔요.
  5. Update를 눌러 변경분으로 재배포해요.

커스터마이즈할 수 있는 것

모든 LlamaAgents 배포는 표준 Python 프로젝트로 구성돼요.

  • Workflows (src/): Parse·Extract·Classify 및 기타 LlamaCloud 서비스를 쓰는 LlamaIndex Workflow 정의
  • UI (ui/): @llamaindex/ui 훅을 쓰는 React 프론트엔드
  • Configuration (pyproject.toml): 워크플로우 등록, 환경 설정, 빌드 구성

프로젝트 구조는 Configuration Reference 참고.

배포 관리

배포 후 LlamaCloud UI에서 에이전트를 관리할 수 있어요.

  • 최신 버전으로 업데이트: 배포 카드의 메뉴 → Update Version → 구성 브랜치의 최신 커밋을 풀·배포.
  • 롤백: 메뉴 → Rollback → 지난 릴리스를 골라 복원.
  • 설정 편집: 배포 메뉴에서 EditRepository URL·Branch 변경 → Update. 비공개 저장소는 배포 카드에서 LlamaAgents GitHub App 설치가 필요해요.
  • 삭제: 배포 메뉴에서 Delete → 확인. 삭제는 영구적이고 모든 리소스·데이터가 제거돼요.

다음 단계

코드로 들어가 보고 싶다면 Serving your Workflows에서 워크플로우 작성·구성법을 배울 수 있어요.

더 알아보기