다크 모드
Input 노드
Input은 워크플로우를 호출할 때 전달받을 값의 이름, 타입, 필수 여부를 정의하는 시작 노드입니다. 여기서 만든 필드는 다음 노드가 사용할 수 있는 입력 스키마이자 Input의 출력이 됩니다.
언제 사용하나요?
- 채팅이나 다른 호출자가 워크플로우에 전달해야 할 값을 정할 때
- 질문, 문서, 옵션처럼 실행마다 달라지는 값을 이름과 타입으로 구분할 때
- 필수 입력과 선택 입력을 나누고 각 필드의 의미를 설명할 때
입력
다른 노드의 값을 입력으로 받지 않습니다. 워크플로우가 호출될 때 전달된 매개변수 객체가 Input의 입력입니다.
예를 들어 question과 language 필드를 정의했다면 호출자는 다음과 같은 값을 전달할 수 있습니다.
json
{
"question": "환불 정책을 알려주세요.",
"language": "ko"
}주요 설정
| 설정 | 설명 |
|---|---|
| 이름 | 캔버스와 변수 선택 목록에 표시할 노드 이름입니다. 워크플로우 안에서 고유해야 합니다. |
| 설명 | 이 워크플로우가 어떤 입력을 기대하는지 설명합니다. 호출자가 값을 구성할 때 이해하기 쉽게 작성하세요. |
| 변수 이름 | 다음 노드에서 참조할 필드 이름입니다. 공백과 사용할 수 없는 특수문자는 입력 중 제거됩니다. |
| 필드 타입 | 새 필드는 String, Number, Boolean, Enum 중에서 선택할 수 있습니다. Enum은 허용할 문자열 목록을 함께 정의합니다. |
| 필드 설명 | 값의 목적과 기대 형식을 설명하는 선택 항목입니다. |
| 기본값 | 스키마에 기록할 선택 기본값입니다. String, Number, Boolean, Enum 타입에 맞게 지정합니다. |
| 필수 | 켜면 해당 필드가 Input 스키마의 필수 항목으로 표시됩니다. |
기존 필드의 이름은 바로 바꿀 수 없습니다. 이름을 변경해야 한다면 기존 필드를 삭제하고 새 필드를 추가한 뒤 참조를 다시 연결하세요.
출력
Input의 출력은 설정한 필드로 구성된 객체입니다. 다음 노드의 메시지나 설정 입력란에서 /를 입력해 각 필드를 참조할 수 있습니다.
| 정의한 필드 | 다음 노드에서 보이는 출력 |
|---|---|
question: String | INPUT.question |
language: Enum | INPUT.language |
필드의 타입, 설명, 기본값, 필수 여부가 출력 스키마에 함께 저장됩니다.
연결과 배치 제약
- 루트 워크플로우에는 Input 노드가 정확히 하나 있어야 합니다.
- Input에는 들어오는 연결 핸들이 없으며, 하나 이상의 다음 노드와 연결되어야 합니다.
- Input은 삭제할 수 없고 Loop나 Iteration 내부에 배치할 수 없습니다.
- Input에서 시작한 실행 경로가 최종 Output까지 이어져야 합니다.
- 다른 노드는 실제로 도달 가능한 이전 실행 경로에 있는 Input 필드만 참조할 수 있습니다.
예시
문서 요약 워크플로우라면 다음과 같이 구성할 수 있습니다.
- Input에 필수 String 필드
document를 추가합니다. - 필드 설명에 “요약할 문서, 회의록 또는 대화 내용”이라고 적습니다.
- Input을 LLM에 연결합니다.
- LLM의 USER 메시지에서
/를 입력해INPUT.document를 선택합니다. - LLM 결과를 Output에 연결합니다.
주의사항
- 필드 이름을 삭제하거나 바꾸면 해당 필드를 참조하던 노드의 변수가 유효하지 않게 됩니다.
- 필수 여부만으로 값의 업무 규칙까지 검증되지는 않습니다. 허용 값이 정해져 있다면 자유 입력 String보다 Enum을 사용하세요.
- 호출자가 값을 정확히 구성할 수 있도록 필드 설명에 단위, 형식, 예시를 적으세요.
- 단순 필드 편집기에서 새로 추가할 수 있는 타입은 String, Number, Boolean, Enum입니다. 복잡한 객체가 필요하면 문자열 입력을 받은 뒤 Code나 Transform에서 구조를 만드세요.