Code Node

워크플로우 안에서 커스텀 Python 코드를 실행하는 노드입니다. AI 추론 대신 정확하고 결정론적인 로직이 필요한 단계에서 프로그래밍 방식으로 처리할 수 있습니다.

자연어 지시보다 코드로 표현하는 것이 더 적합한 작업에 사용합니다. 데이터 변환, 수식 계산, 문자열 파싱, API 응답 포매팅처럼 정확하고 재현 가능한 결과가 필요한 경우가 해당됩니다. 노드 간 데이터 형식을 맞춰주는 용도로도 유용합니다.

설정

현재 Code 노드는 Python만 지원합니다. 향후 다른 언어도 지원될 수 있습니다.

노드당 하나의 변환 또는 작업에 집중하는 것을 권장합니다. 코드가 복잡해지면 명확성과 디버깅 편의를 위해 여러 노드로 분리하는 것을 고려하세요.
Agent 노드 사이에 Code 노드를 두어 데이터 유효성을 검사하는 용도로 활용할 수 있습니다. 예를 들어, 다운스트림 노드에 전달하기 전에 업스트림 Agent 노드의 출력에 예상 필드가 포함되어 있는지 확인할 수 있습니다.

Code 필드가 비어 있으면 “1 required” 경고가 표시됩니다. 코드가 없으면 해당 노드를 실행할 수 없습니다.
런타임 Python 오류(구문 오류, 정의되지 않은 변수, 타입 오류 등)가 발생하면 노드가 실패합니다. 오타, 누락된 import, 잘못된 데이터 타입 순으로 점검하세요.