에이전트플로우 V2

에이전트플로우 V2

Agentflow V2는 Flowise의 워크플로 오케스트레이션을 한 단계 끌어올린 버전이에요. V1이 외부 프레임워크에 의존해 에이전트 그래프 로직을 만들었다면, V2는 세분화된 전용 노드들로 전체 워크플로를 직접 설계하는 방식으로 바뀌었어요.

출처: https://docs.flowiseai.com/using-flowise/agentflowv2

노드 하나 = 독립 실행 단위

V2에서 각 노드는 독립적인 단위로, 자기 설계에 맞는 하나의 연산을 수행해요. 캔버스 위의 노드 연결이 곧 워크플로의 경로와 제어 흐름이 되고, 데이터는 앞서 실행된 어느 노드의 출력을 참조해서 전달돼요. 그리고 Flow State가 전체 워크플로의 데이터 공유 메커니즘을 담당해요.

주요 노드들

  • LLM 노드: 설정된 모델(Messages 기반)으로 요청을 보내 텍스트 생성·요약·번역·분석에 쓰고, JSON 스키마 기반 구조화 출력도 가능해요.
  • Agent 노드: 도구를 가진 에이전트로, LLM이 도구를 골라 호출하게 해요.
  • Tool 노드: 외부 API나 서비스를 도구로 노출해요.
  • HTTP 노드: GET, POST, PUT, DELETE, PATCH 등으로 외부 웹 서비스에 직접 요청을 보내요. 인증 방식, 커스텀 헤더, 쿼리 파라미터, 여러 요청 본문 타입을 설정할 수 있어요.
  • Condition Agent 노드: 조건 분기로 흐름을 나눠요.
  • Human Input 노드: 사람의 승인이나 피드백을 받아 흐름을 재개해요.
  • Custom Function 노드: 커스텀 코드로 자유롭게 처리해요.
  • Execute Flow 노드: 현재 워크플로 안에서 다른 Chatflow/Agentflow를 호출하는 서브워크플로 호출자예요. 이름이나 ID로 대상 플로우를 고르고, Input을 넘기고, overrideConfig로 대상 설정을 일시 변경할 수 있어요.

Flow State 이해하기

Flow State는 워크플로 전반의 공유 상태 저장소예요.

  1. 초기화: Start 노드의 Flow State 파라미터에서 앞으로 쓸 키들을 기본값과 함께 선언해요. 이게 $flow.state의 스키마가 돼요.
  2. 갱신: LLM, Agent, Tool, HTTP, Retriever, Custom Function 같은 노드의 Update Flow State 파라미터로 기존 키 값을 바꿔요. 운영 노드는 새 키를 만들 수 없고, 미리 정의된 키만 갱신할 수 있어요.
  3. 읽기: {{ $flow.state.yourKey }} 문법으로 값을 읽어요. 예를 들어 LLM 노드 프롬프트에 사용자 상태를 넣을 수 있어요.

타입 {{를 입력하면 사용 가능한 변수 목록이 뜨니까, 동적 값을 쉽게 참조할 수 있어요.

더 알아보기

  • 기본 플로우 작성은 «채팅플로우 만들기»에서 시작하세요.
  • Agentflow를 외부에서 호출하는 법은 «Prediction API로 연동하기»를 보세요.