LlamaAgents 개요 — 에이전트 워크플로를 만드는 가장 진보된 방법

LlamaAgents 개요 — 에이전트 워크플로를 만드는 가장 진보된 방법

문서를 읽고 추출하고 분류하는 작업을 여러 단계로 묶어 자동화하고 싶다면, 그 단계들을 하나의 실행 흐름으로 엮는 것이 핵심이에요. LlamaAgents는 이런 '에이전트 워크플로'를 만들고, 직접 운영하거나 LlamaCloud에 배포하기까지 한 번에 잡아 주는 프레임워크예요. 오픈소스인데다 바닥은 진짜 파이썬이라, 필요하면 원하는 대로 뜯어 고칠 수 있어요.

출처: 공식문서

LlamaAgents는 무엇을 해주나요

Parse, Extract, Split, Classify 같은 문서 처리 기본기와 우리가 직접 작성한 작업을 이어 붙여, 문서를 대상으로 한 지식 작업을 수행하는 Workflow를 만들 수 있어요. 이벤트 기반으로 실행을 조율하면서 분기·병렬 처리·사람 중간 개입·내구성·관측성을 기본으로 갖추고 있어요.

시작하는 길은 크게 세 갈래로 나뉘어요.

  • 로컬에서 개발하기 — llamactl CLI로 스타터 템플릿에서 프로젝트를 만들고, 내 컴퓨터에서 개발·서빙한 뒤 LlamaCloud나 자체 서버에 배포해요.
  • 스타터 템플릿 배포하기 — 명령줄 없이도 LlamaCloud에서 템플릿을 골라 바로 배포할 수 있어요.
  • 더 깊게 들어가기 — 로컬 개발과 클라우드 서비스를 함께 써요. 오케스트레이션에는 Agent Workflows, 실제 호출에는 WorkflowClient(또는 REST·타입드 파이썬 클라이언트)를 둘 겁니다.

구성 요소

  • llamactl CLI — 로컬 워크플로 앱의 개발과 배포를 담당해요. 스타터 템플릿에서 초기화하고, 로컬에서 서빙하며, LlamaCloud 배포나 자체 호스팅용 내보내기를 지원해요.
  • Agent Workflows — 핵심이 되는 이벤트 기반 오케스트레이션 프레임워크예요. 내 코드에서 비동기 라이브러리로 쓰거나, llamactl에게 서빙을 맡길 수 있어요. 내구성과 관측성이 내장되어 있어요.
  • llama-cloud-services — LlamaCloud의 문서 기본 기능(Parse·Extract·Classify), 구조화 저장을 위한 Agent Data, 벡터 인덱스를 제공해요. 클라우드 배포 시 인증은 llamactl이 처리해요.
  • @llamaindex/ui — 워크플로 기반 프론트엔드를 만들기 위한 React 훅이에요. 백엔드와 함께 llamactl로 배포할 수 있어요.
  • Workflows Client — 배포된 워크플로를 REST API나 타입드 파이썬 클라이언트로 호출해요.

더 알아보기