컴포넌트 이해하기

Langflow에서 플로우의 알맹이는 컴포넌트예요. 컴포넌트는 애플리케이션의 클래스처럼, 각자 하나의 용도나 통합을 담당하는 조각이에요. 화면 왼쪽의 Core components나 Bundles 메뉴에서 원하는 컴포넌트를 캔버스로 끌어다 놓으면 시작돼요.

출처: https://docs.langflow.org/components-data

컴포넌트 하나가 실행되는 방식

플로우 전체를 돌리는 것과 달리, 단일 컴포넌트를 실행하면 build_vertex 함수가 호출돼요. 이 함수는 비주얼 에디터에서 직접 넘겨준 입력(이른바 inputs_dict 파라미터)으로 컴포넌트 하나만 빌드하고 실행해요. 그래서 단일 컴포넌트 실행은 앞쪽의 업스트림 의존성을 자동으로 실행하지 않아요.

# (개념) build_vertex 가 호출되고, VertexBuildResult 데이터가
# build_and_run 메서드로 전달되어 컴포넌트의 build 메서드를 실행해요.

데이터 타입과 포트 연결

컴포넌트끼리는 포트(port)로 연결해요. 예를 들어 System Message 필드는 메시지 데이터를 받는데, 이건 파란 포트 아이콘으로 표시돼요. 플로우를 만들 때는 출력 포트에서 입력 포트로, 같은 타입(색)끼리 이어야 그 사이의 데이터가 올바르게 전달돼요.

포트 위에 마우스를 올리면 연결 정보가 보이고, 포트를 클릭하면 호환되는 컴포넌트를 검색할 수 있어요.
Prompt Template 컴포넌트는 Template 필드에서 중괄호로 감싼 값을 감지해, 그 값마다 새 입력 포트를 열어줘요.
모든 컴포넌트는 출력을 만들어내고, 그 출력은 다음 컴포넌트로 보내거나 플로우의 최종 결과로 반환돼요.
여러 타입의 출력을 한 번에 내보내는 컴포넌트는 비주얼 에디터에서 출력 포트가 여러 개로 보여요.

컴포넌트가 제공하는 것들

통합 범위가 아주 넓어요. LLM(OpenAI, Anthropic 등), 임베딩, 벡터 스토어(Astra DB, Chroma, Pinecone, Milvus, Weaviate, Qdrant, pgvector), 문서 로더, 출력 파서, 에이전트, 도구까지 수백 개의 사전 제작 컴포넌트가 준비돼 있어요. 자체 파이썬 커스텀 컴포넌트도 넣을 수 있고, 컴포넌트에 inputs, outputs, build 메서드를 정의하면 Langflow가 UI를 자동으로 생성해줘요.

워크스페이스의 단축키는 헤더의 프로필 아이콘 → Settings → Shortcuts에서 확인할 수 있어요.

더 알아보기

플로우 전체를 실행하려면 «Langflow 시작하기»를 보세요.
완성한 플로우를 REST API로 호출하는 방법은 «REST API로 플로 실행하기»에서 다뤄요.