다크 모드
워크플로우 편집기
워크플로우 편집기는 노드를 배치하고 연결해 자동화 흐름을 만드는 상세 화면입니다. 워크플로우 목록에서 항목을 선택하면 편집기로 이동합니다.
화면 예시
캔버스에서 노드를 연결하고, 선택한 노드의 설정 패널에서 입력 필드, 다음 노드, 실행 옵션을 조정합니다.
화면 구성
| 영역 | 설명 |
|---|---|
| 캔버스 | 노드를 배치하고 연결하는 작업 영역입니다. |
| 왼쪽 도구 모음 | 노드와 Note 추가, 포인터·드래그 모드 전환, 자동 레이아웃을 수행합니다. |
| 노드 설정 패널 | 선택한 노드의 입력값, 출력 스키마, 실행 옵션을 설정합니다. |
| 상단 액션 | 워크플로우 정보, 내보내기, 실행, 저장, 게시와 공유 범위를 관리합니다. |
| 실행 패널 | 워크플로우를 테스트하고 노드별 실행 결과를 확인합니다. |
편집 흐름
- Input 노드에서 채팅이 제공할 입력 필드를 정의합니다.
- 필요한 처리 단계에 맞게 LLM, Tool, HTTP, Code, Transform, Condition, Iteration, Loop 노드를 추가합니다.
- 노드 사이를 연결해 데이터 흐름을 만듭니다.
- 각 노드에서 이전 노드의 출력 변수를 참조합니다.
- Output 노드에서 최종 응답을 조립합니다.
- 실행으로 테스트합니다.
- 검증이 끝나면 게시합니다.
왼쪽 도구 모음
| 도구 | 설명 |
|---|---|
| 노드 추가 | 실행 노드를 캔버스 중앙에 추가합니다. Note는 이 메뉴에 포함되지 않습니다. |
| 메모 추가 | 실행에 영향을 주지 않는 Note를 추가합니다. |
| 포인터 모드 | 노드를 선택하고 영역 선택으로 여러 노드를 선택합니다. |
| 드래그 모드 | 캔버스를 이동합니다. 이 모드에서도 노드 이동·추가·연결이 가능합니다. |
| 자동 레이아웃 | 루트 노드와 Loop·Iteration 내부 노드를 겹치지 않게 정렬하고 화면에 맞춥니다. |
상단 액션
| 액션 | 설명 |
|---|---|
| 정보 수정 | 워크플로우 이름, 아이콘과 설명을 변경합니다. |
| 내보내기 | 워크플로우를 JSON 파일로 저장합니다. |
| 실행 | 테스트 입력값으로 워크플로우를 실행합니다. |
| 저장 | 현재 초안 상태를 저장합니다. |
| 게시 | 채팅에서 도구로 사용할 수 있도록 게시합니다. |
| 편집 | 게시된 워크플로우를 다시 초안 상태로 전환해 수정합니다. |
| 공유 범위 변경 | 비공개, 읽기 전용, 공개 범위를 변경합니다. |
노드 설정 패널
노드를 선택하면 오른쪽 또는 하단 설정 패널에서 세부 값을 편집할 수 있습니다.
| 노드 | 주요 설정 |
|---|---|
| Input | 필드명, 타입, 필수 여부, 기본값, 설명 |
| LLM | 메시지, 모델, 추론 강도, 구조화된 출력 |
| Tool | 호출할 도구, 모델, 도구 입력 생성 지침 |
| Retriever | Knowledge Base, 컬렉션, 검색 방식, Top K, Rerank |
| HTTP | URL, 메서드, 헤더, 쿼리, 바디, 타임아웃 |
| Code | 언어, 코드, 입력 소스, 환경 변수, 결과 스키마 |
| Transform | 소스 필드와 대상 필드 매핑 |
| Template | 템플릿 내용과 변수 참조 |
| Condition | if, else-if, else 조건과 AND·OR 조합 |
| Iteration | 입력 배열, 내부 흐름, 결과 필드, 병렬 처리와 오류 정책 |
| Loop | 루프 변수, 종료 조건, 최대 루프 횟수, 내부 흐름 |
| Variable Assigner | Loop 변수와 타입별 갱신 연산 |
| Exit Loop | 현재 Loop의 즉시 종료 지점 |
| Note | Markdown 설명과 주석 |
| Output | 최종 출력 키와 소스 변수 |
변수 참조 방식
노드 설정에서 /를 입력하면 이전 노드의 출력값을 선택할 수 있습니다. 변수 참조는 다음과 같은 상황에 사용합니다.
- LLM 노드에서 검색 결과를 요약할 때
- HTTP 노드 URL이나 바디에 이전 입력값을 넣을 때
- Tool 노드의 입력값을 이전 노드 결과로 채울 때
- Output 노드에서 여러 노드의 결과를 합쳐 반환할 때
실행과 디버깅
워크플로우가 예상대로 동작하지 않으면 실행 패널에서 노드별 결과를 확인합니다.
| 확인 항목 | 설명 |
|---|---|
| 입력값 | Input 노드에 들어온 값이 예상과 일치하는지 확인합니다. |
| 중간 결과 | 각 노드의 출력이 다음 노드에서 사용할 수 있는 구조인지 확인합니다. |
| 오류 노드 | 실패한 노드의 오류 메시지와 입력값을 확인합니다. |
| 최종 출력 | Output 노드가 사용자에게 보여줄 값을 제대로 조립했는지 확인합니다. |
게시 전 검증
게시 시 유효하지 않은 노드가 있으면 게시가 제한될 수 있습니다.
| 검증 항목 | 예시 |
|---|---|
| 필수 설정 | Tool 노드에 도구가 선택되어 있는지 확인합니다. |
| 연결 상태 | 실행 흐름에서 고립된 필수 노드가 없는지 확인합니다. |
| 출력 스키마 | 구조화된 출력을 사용하는 노드의 스키마가 유효한지 확인합니다. |
| 민감 값 | 환경 변수나 헤더에 들어간 민감 정보가 공유/내보내기에 안전한지 확인합니다. |