모든 글

Langflow: 한 가지 작업 따라 하기

Langflow는 시각적 작성, Python 소스 코드 접근, 대화형 플레이그라운드, API 및 MCP 서버 지원을 제공하는 AI 에이전트 및 워크플로우 구축 플랫폼입니다.

마지막 업데이트

메뉴나 지원 기능이 달라졌다면 아래 자료 확인일과 현재 앱 버전을 함께 봐주세요.

앱 · APP
공식 자료를 읽고 정리했어요 · 직접 실행한 후기는 아직 없어요 자료 확인일:

Langflow 따라 하기: Simple Agent 템플릿으로 계산기 도구 실행하기

이 글은 Langflow v1.12.5 공식 릴리스를 다뤄요. 공식 릴리스 기록의 공개일은 2026-10-06(UTC)이고, 자료 확인일은 2026-10-18이에요. 아직 소개하지 않은 제품 중 공식 자료와 화면의 재사용 조건을 확인할 수 있는 릴리스를 찾기 위해 최근 30일로 범위를 넓혀 선정했어요.

Langflow는 시각적 인터페이스를 통해 AI 에이전트와 워크플로우를 손쉽게 구축할 수 있도록 돕는 강력한 플랫폼이에요 F1. 개발자는 화면에서 구성요소를 직접 연결하면서도, 필요할 때 파이썬 소스 코드를 열어 세부 사항을 수정할 수 있죠 F7. 이번 글에서는 공식 문서를 기반으로, Simple Agent 템플릿을 불러와 계산기(Calculator) 도구를 에이전트에 연결하고 실제로 실행해 보는 과정을 차근차근 살펴볼게요.

이 가이드는 공식 문서 내용을 바탕으로 정리한 튜토리얼이며, 실제 기기에서의 직접 테스트를 거치지 않은 문서 기반 안내서예요. 따라서 사용 환경에 따라 세부적인 화면 구성이나 동작에 차이가 있을 수 있다는 점을 미리 알려드려요.

한 가지 완성 목표

이번 실습의 목표는 Langflow에서 제공하는 기본 템플릿 중 하나인 Simple Agent를 실행하고, 그 안에 포함된 계산기 도구에 자연어로 질문을 던져 에이전트가 올바른 도구를 선택해 답을 내놓는지 확인하는 거예요. 에이전트는 사용자의 입력 맥락을 스스로 분석한 뒤, 수학 계산이 필요할 때 계산기 도구를 호출하도록 설계되어 있어요 F4, F5.

준비물 및 버전 안내

이 기능을 원활하게 다루려면 몇 가지 기본 준비물이 필요해요.

  • Langflow 설치: 로컬 환경에 파이썬(3.10~3.14)과 패키지 관리 도구(uv)를 사용해 설치하거나, 윈도우 및 맥OS용 Langflow Desktop 애플리케이션을 준비해 주세요 D2, D3. (참고로 Langflow Desktop의 맥 버전은 macOS 13 이상이 필요해요 F3.)
  • API 키: 답변을 생성할 언어 모델 제공자(예: OpenAI)의 API 키가 필요해요 D4.
  • Langflow API 키: 외부에서 에이전트를 호출하거나 API 기능을 테스트할 때 필요하며, 설정 화면의 ‘Langflow API Keys’ 메뉴에서 직접 생성할 수 있어요 D4.

비용 측면에서 주의할 점이 있어요. Langflow 자체 플랫폼이나 오픈소스 패키지는 무료로 내려받아 쓸 수 있지만, 에이전트가 호출하는 대규모 언어 모델(LLM)의 사용량이나 토큰 비용은 해당 모델 제공자(OpenAI 등)의 정책에 따라 별도로 부과된다는 점을 기억해 주세요.

단계별 입력과 화면

공식 문서에 안내된 절차에 따라 Simple Agent 템플릿을 실행해 보세요.

  1. 템플릿 불러오기: Langflow 화면에서 New Flow를 누른 뒤 Simple Agent 템플릿을 선택해요 F4. 이 템플릿은 에이전트(Agent) 컴포넌트가 챗 입력(Chat Input), 챗 출력(Chat Output), 계산기(Calculator), 그리고 URL 컴포넌트들과 서로 연결되어 있는 구조를 가지고 있어요 F4.
  2. 언어 모델 연결하기: 에이전트 컴포넌트 안에서 ‘Setup Provider’를 클릭해 원하는 언어 모델 제공자를 선택하고, 언어 모델 드롭다운에서 사용할 모델을 지정해 주세요 D4.
  3. 플레이그라운드 열기: 화면 상단이나 인터페이스에 있는 Playground 아이콘을 클릭해 대화형 테스트 창을 열어줘요 D4.
  4. 계산기 도구 테스트하기: 프롬프트 입력창에 간단한 수학 질문을 적어보세요. 예를 들어 I want to add 4 and 4. 같은 문장을 입력할 수 있어요 F5. 플레이그라운드는 에이전트가 사용자의 프롬프트를 분석하고, 어떤 과정을 거쳐 계산기 도구(evaluate_expression 등의 액션)를 골라 실행하는지 그 추론 과정을 실시간으로 보여줘요 F5.

결과 확인

질문을 입력하고 나면, 플레이그라운드 화면에서 에이전트가 단계를 나누어 생각하는 과정이 나타나요 F5. 문서가 설명하는 예상 흐름은 계산기 도구를 선택하고 챗 출력으로 답을 반환하는 거예요. 직접 따라 할 때는 도구 실행 단계와 최종 메시지를 함께 확인하고, 이 예제의 예상값인 8과 일치하는지 살펴봐요. 답만 맞는 것과 계산기 도구를 실제로 선택한 것은 서로 다른 확인 항목이에요 F4, F5.

만약 외부 프로그램에서 이 흐름을 직접 호출하고 싶다면, 편집 화면의 ‘Share’ 메뉴에서 API access를 열어 파이썬이나 자바스크립트, cURL 형태의 샘플 코드를 복사해 활용할 수 있어요 D4. 예를 들어 파이썬 환경에서는 requests 라이브러리를 이용해 지정된 /run 엔드포인트로 POST 요청을 보내고 결과를 받아올 수 있답니다 D4.

오류 해결

에이전트를 실행하거나 API를 호출할 때 마주할 수 있는 대표적인 문제와 해결 방법이에요.

  • API 키 오류: API 요청 시 “An API key must be passed as query or header”라는 메시지가 뜬다면, LANGFLOW_API_KEY 환경 변수가 제대로 설정되었는지 혹은 요청 헤더에 x-api-key가 올바르게 포함되었는지 확인해 주세요 D4.
  • 윈도우 데스크톱 컴파일 오류: 윈도우 환경에서 Langflow Desktop을 설치할 때 C++ Build Tools Required! 오류가 발생한다면, 화면의 안내에 따라 Microsoft C++ Build Tools나 Visual Studio를 함께 설치해 주어야 해요 D3.
  • 공유 플레이그라운드 제한: 편집 화면에서 제공하는 Shareable Playground 기능은 어디까지나 테스트 용도로만 만들어진 기능이에요. 애플리케이션 내부에 플로우를 영구적으로 임베드하는 용도로는 적합하지 않으니 실제 서비스 배포 시에는 API 호출 방식을 사용하는 것이 안전해요 F6.

이처럼 Langflow의 Simple Agent 템플릿을 활용하면 복잡한 코드 작성 없이도 도구를 능숙하게 다루는 AI 에이전트를 시각적으로 만들고 테스트할 수 있어요. 직접 플로우를 열어 다양한 도구를 붙여보며 나만의 워크플로우를 확장해 보세요!

Langflow documentation reading guide

BumbleV가 만든 자료 안내 그림이며 실제 앱 화면이나 실행 결과가 아니에요. 그림의 근거가 된 공식 발표 · CC BY 4.0 · 2026-10-18

소개

한 가지 작업 따라 하기

공식 문서로 비교하기

Langflow developer interface example
개발자 저장소에 공개된 실제 화면 예시예요. 본문의 작업을 직접 실행한 결과는 아니며 현재 버전과 화면이 다를 수 있어요. 원본·출처 및 재사용 조건 · 52622284d3bb · MIT · 2026-10-18 · Copyright (c) 2024 Langflow The above copyright notice and this permission notice shall be included in all AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
Langflow developer interface example
개발자 저장소에 공개된 실제 화면 예시예요. 본문의 작업을 직접 실행한 결과는 아니며 현재 버전과 화면이 다를 수 있어요. 원본·출처 및 재사용 조건 · 52622284d3bb · MIT · 2026-10-18 · Copyright (c) 2024 Langflow The above copyright notice and this permission notice shall be included in all AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

참고 자료