액션 노드

결정론적 워크플로 작업을 위한 비-LLM 프로그래밍 방식 노드입니다. 액션 노드는 데이터 변환, API 통합, 제어 흐름 및 자동화 로직을 처리하여 LLM 에이전트를 보완합니다.

개요

액션 노드는 LLM 에이전트 노드와 시각적으로 다릅니다 — 고유한 색상과 아이콘을 사용하여 워크플로를 쉽게 스캔할 수 있도록 합니다. 각 노드 유형은 HTTP 요청부터 데이터베이스 쿼리, 조건부 분기에 이르기까지 특정 작업 범주를 처리합니다.

모든 액션 노드는 오류 처리, 추적, 실행 제어 및 I/O 매핑을 위한 표준 속성 세트를 공유합니다. 이들은 문자열 필드에서 {{variable}} 보간을 지원하며 선행 노드 출력을 자동으로 수신합니다.

사용 가능한 노드

표준 속성

모든 액션 노드는 이러한 공유 속성들을 상속합니다:

식별자

오류 처리

추적

실행 제어

입력/출력 매핑

노드 참조

트리거 노드 🎯

워크플로우 진입점. 모든 워크플로우는 트리거 노드로 시작합니다. 자세한 내용은 전용 트리거 가이드를 참조하십시오.

HTTP Node 🌐

완전한 인증, 헤더, 본문 및 응답 처리를 통해 외부 APIs에 HTTP 요청을 수행합니다.

구성:

예시:

{
  "type": "http",
  "name": "Fetch User Data",
  "method": "GET",
  "url": "https://api.example.com/users/{{userId}}",
  "auth": {
    "type": "bearer",
    "bearer": { "token": "{{API_TOKEN}}" }
  },
  "headers": { "Accept": "application/json" },
  "body": { "type": "none" },
  "response": { "type": "json", "jsonPath": "$.data" },
  "errorHandling": { "mode": "retry", "retryCount": 3, "retryDelay": 1000 },
  "mapping": { "outputKey": "userData" }
}

Set 노드 📝

워크플로우 상태 변수를 정의하고 조작합니다. 리터럴 값, 표현식 및 시크릿을 지원합니다.

구성:

변수 유형: string, number, boolean, json, expression

isSecret: true로 표시된 변수는 로그 및 UI에서 마스킹됩니다.

변환 노드 ⚙️

표현식 또는 내장 작업을 사용하여 데이터를 변환합니다.

변환 유형:

내장 작업: pick, omit, rename, flatten, sort, unique

타입 강제 변환 대상: string, number, boolean, array, object

스위치 노드 🔀

여러 출력 포트를 가진 조건부 분기. 각 조건은 노드의 별도 출력 포트에 매핑됩니다.

구성:

조건 연산자: eq, neq, gt, lt, gte, lte, contains, startsWith, endsWith, matches, in, empty, exists

예시:

{
  "type": "switch",
  "evaluationMode": "first_match",
  "conditions": [
    { "id": "ok", "name": "Success", "field": "status", "operator": "eq", "value": "success", "outputPort": "success" },
    { "id": "err", "name": "Error", "field": "status", "operator": "eq", "value": "error", "outputPort": "error" }
  ],
  "defaultBranch": "unknown"
}

루프 노드 🔄

배열을 반복하거나, 정해진 횟수만큼 반복하거나, 조건이 유지되는 동안 루프를 실행합니다.

루프 유형:

병렬 실행: parallel.enabled을(를) 선택적 batchSize 및 delayBetween과(와) 함께 활성화하여 동시 반복을 수행합니다.

결과 집계: results.collect이(가) true일 때, 반복 결과는 results.aggregationKey 아래의 배열로 수집됩니다.

병합 노드 🔗

여러 병렬 브랜치를 단일 흐름으로 다시 결합합니다. 여러 입력 포트를 가집니다.

병합 모드:

전략 결합: array, object, first, last

선택적 타임아웃과 continue 또는 error 동작.

대기 노드 ⏱️

워크플로 실행을 일시 중지합니다.

대기 유형:

코드 노드 💻

샌드박스화된 boa_engine 런타임에서 사용자 정의 JavaScript을(를) 실행합니다. 그래프 상태는 전역 input 객체로 주입됩니다.

구성:

샌드박스 기본값:

데이터베이스 노드 🗄️

연결 풀링 및 매개변수화된 쿼리를 사용하여 데이터베이스 작업을 수행합니다.

지원되는 데이터베이스:

연결 문자열은 비밀로 취급되며 로그에서 마스킹됩니다.

이메일 노드 📧

SMTP를 통해 이메일을 보내거나 IMAP을 통해 수신 이메일을 모니터링합니다.

전송 모드 (SMTP):

• TLS/SSL 지원
• 인증
• To/CC/BCC 수신자
• HTML 또는 일반 텍스트 본문
• 제목 및 본문에서 {{variable}} 보간
• 상태에서 파일 첨부

모니터링 모드 (IMAP):

• 폴더 선택 (기본값: INBOX)
• 필터: 보낸 사람, 제목, 날짜 범위, 읽지 않음만
• 처리 후 읽음으로 표시

알림 노드 🔔

메시징 플랫폼으로 알림을 보냅니다.

채널: Slack, Discord, Microsoft Teams, custom webhook

메시지 형식: 일반 텍스트, 마크다운, 플랫폼별 블록 (Block Kit, Embeds, Adaptive Cards)

RSS 노드 📡

새 항목에 대해 RSS/Atom 피드를 모니터링합니다.

• 구성 가능한 폴링 간격
• 키워드, 작성자, 카테고리 및 날짜 필터
• 중복 방지를 위한 확인된 항목 추적
• 선택적 전체 콘텐츠 또는 요약만

파일 노드 📁

로컬 또는 클라우드 스토리지의 파일 작업.

작업: read, write, delete, list

클라우드 공급자: Amazon S3, Google Cloud Storage, Azure Blob Storage

파일 형식: JSON, CSV, XML, text, binary (구분 기호, 헤더, 따옴표 처리를 위한 CSV 파싱 옵션 포함)

---

변수 보간

액션 노드의 모든 문자열 필드는 동적 값을 위해 {{variable}} 구문을 지원합니다:

https://api.example.com/users/{{userId}}
Bearer {{API_TOKEN}}
Hello {{user.name}}, your order {{orderId}} is ready.

변수는 실행 시 워크플로 상태에서 해결됩니다. 점 표기법(user.name)은 중첩된 값에 접근합니다.

다중 포트 노드

두 가지 노드 유형은 동적 포트 수를 가집니다:

• Switch — 조건당 하나의 출력 포트와 선택적 기본 포트
• Merge — 여러 입력 포트, 들어오는 브랜치당 하나

이 포트들은 노드에 시각적으로 표현되며, 다른 다운스트림/업스트림 노드에 연결됩니다.

---

코드 생성

액션 노드는 LLM agents와 함께 프로덕션 Rust 코드로 컴파일됩니다. 종속성은 자동 감지되어 생성된 Cargo.toml에 추가됩니다.

모든 생성된 코드는 오류 처리를 위해 adk-graph FunctionNode 클로저와 함께 GraphError::NodeExecutionFailed를 사용합니다.

생성된 코드 예시 (HTTP 노드):

let http_node = FunctionNode::new("fetch_data", |ctx| async move {
    let client = reqwest::Client::new();
    let resp = client.get("https://api.example.com/data")
        .bearer_auth(&ctx.get("API_TOKEN").unwrap_or_default())
        .send().await
        .map_err(|e| GraphError::NodeExecutionFailed {
            node: "fetch_data".into(),
            message: e.to_string(),
        })?;
    let body: serde_json::Value = resp.json().await?;
    Ok(NodeOutput::new().with_update("apiData", body))
});

생성된 코드 예시 (코드 노드):

let code_node = FunctionNode::new("process", |ctx| async move {
    let mut js_ctx = boa_engine::Context::default();
    // Graph state injected as global `input` object
    // User code executed in thread-isolated sandbox
    Ok(NodeOutput::new().with_update("result", output))
});

---

이전: ← Studio | 다음: Triggers →