워크플로우 에이전트
워크플로우 에이전트는 노드를 연결해 조건·반복·병렬 처리와 사람 입력을 구성합니다. 에이전트 만들기에서 워크플로우 모드를 선택한 뒤 시작 입력에서 종료 출력까지 실행 경로를 만듭니다.
스크린샷 TODO
영역: 시작·조건 분기·도구 호출·종료 노드와 오른쪽 속성 패널이 표시된 워크플로우 빌더.
기본 작업 흐름
- 시작 노드에서 입력 변수의 이름·종류·필수 여부·기본값·설명을 정의합니다.
- 팔레트에서 노드를 끌어다 놓거나 출력 연결점을 빈 캔버스에 놓아 다음 노드를 고릅니다.
- 노드를 선택하고 오른쪽 속성 패널에서 입력·출력과 실행 옵션을 설정합니다.
- 종료 노드에서 반환할 출력 이름·종류·값을 매핑합니다.
- 저장한 뒤 배포를 누릅니다.
노드 출력은 노드이름.필드 형식의 값 참조로 다음 노드 입력에 매핑합니다. 속성 패널의 출력 선택기를 사용해 오타를 줄입니다.
노드별 주요 설정
| 노드 | 설정과 결과 |
|---|---|
| 시작 | 실행 입력 변수를 선언합니다. |
| 종료 | 최종 출력 이름·종류·값을 매핑합니다. |
| 에이전트 | 지시문, 등록 모델, 도구·액터, 최대 반복을 설정합니다. |
| LLM | 모델, 추론 강도, 프롬프트·시스템 프롬프트와 출력 변수를 설정합니다. |
| 코드 | Python 또는 JavaScript 소스, 입력 매핑과 타임아웃을 설정합니다. 데이터 연결·RAG 코드 삽입을 사용할 수 있습니다. |
| 템플릿 | 템플릿 본문을 렌더링해 출력 변수에 저장합니다. |
| 변수 | set, append, merge, increment, decrement, delete 연산을 순서대로 적용합니다. |
| 도구 호출 | 도구, 입력 매핑과 타임아웃을 설정합니다. |
| 액터 호출 | 액터, 입력 매핑·타임아웃과 auto / confirm / deny 확인 정책을 설정합니다. |
| 조건 분기 | 조건식을 평가해 참·거짓 연결점으로 나눕니다. |
| 반복 | 목록 또는 횟수 모드, 소스·반복자 또는 횟수·카운터, 최대 반복을 설정합니다. |
| 병렬 실행 | 분기 목록, all / any 조인 방식과 타임아웃을 설정합니다. |
| 사용자 입력 | 안내 문구, 입력 필드와 타임아웃을 설정합니다. 타임아웃 결과는 승인·거부·오류 중에서 고릅니다. |
| 오류 처리 | 대상 노드, 재시도 횟수·간격, 고정/지수 백오프와 대체·건너뛰기·중단을 설정합니다. |
분기와 종료 조건
- 조건 분기의 참·거짓 연결점에 각각 다음 노드를 연결합니다.
- 반복의 본문 경로에는 반복할 노드를, 다음 경로에는 반복을 마친 뒤 실행할 노드를 연결합니다. 최대 반복으로 무한 실행을 막습니다.
- 병렬 실행에서
all은 모든 분기를 기다리고any는 한 분기의 완료로 다음 단계에 합류합니다. 타임아웃을 함께 설정합니다. - 오류 처리의 성공·대체 경로를 구분합니다. 대체 실행이 없으면 건너뛰기 또는 전체 중단 결과를 확인합니다.
연결 제약
다음 연결은 만들 수 없습니다.
- 노드가 자기 자신으로 돌아가는 연결
- 시작 노드로 들어가는 연결
- 종료 노드에서 나가는 연결
- 같은 출발·도착·연결점의 중복 연결
- 순환 경로를 만드는 연결
시작과 종료 노드는 삭제하거나 복제할 수 없습니다. 다른 노드는 마우스 오른쪽 버튼 메뉴에서 편집·복제·연결 해제·삭제합니다. 여러 노드를 선택해 정렬하거나 간격을 맞추고 자동 정렬로 전체 배치를 정리할 수 있습니다.
저장·배포·재배포
저장은 편집한 그래프를 보관합니다. 배포하려면 시작과 종료 노드가 모두 있어야 합니다. 둘 중 하나가 없으면 누락된 노드를 알리는 오류가 표시됩니다.
실행 중인 에이전트에서 노드 구조나 설정, 연결한 시맨틱 자산을 바꾸면 재배포 필요가 표시됩니다. 노드 위치만 옮긴 경우에는 실행 구성이 바뀌지 않으므로 재배포 대상으로 계산하지 않습니다.
워크플로우 에이전트는 채팅이 아니라 이벤트로 실행합니다. 실행 방식은 에이전트 배포에서 확인합니다.