Launch Parameters (실행 파라미터)

Data flow node (데이터 플로우 노드) 그룹

개요

실행 파라미터 (Launch Parameters) 노드는 HyperFlow Control API URL에 있는 쿼리 파라미터를 제공합니다. 예를 들어, HyperFlow 내부 자체 챗봇을 시작할 때 사용되는 파라미터들입니다. 이 노드의 출력 커넥터는 실행 URL 쿼리 파라미터 세트를 JSON 객체로 공급하며, 이 객체는 플로우 전반에서 접근할 수 있어, 제어 API URL을 통해 동적 파라미터 전달 및 플로우 구성이 가능합니다.

📘 이 기능은 사용자 또는 컨텍스트에 특정한 정보를 상용 플로우 그래프에 전달하는 데 특히 유용합니다. 예를 들어, 인터랙티브한 사용자 대면 챗봇이나 어시스턴트로 실행되는 플로우에서 사용됩니다.

설명

이 노드는 HyperFlow Control API URL 쿼리 파라미터를 추출하여 플로우 내에서 구조화된 JSON 객체로 사용할 수 있게 합니다. 이는 URL 파라미터를 통해 플로우를 구성하는 데 특히 유용하며, 플로우가 어떻게 시작되는지에 따라 동적 동작을 가능하게 하고, 애플리케이션에 초기 파라미터를 전달하는 데 사용됩니다.

사용 가이드라인

기본 파라미터
- 기본 JSON 객체 구조 설정
- 대체 값 (fallback) 정의
- 필수 파라미터 구성
파라미터 검증
- 파라미터 유형 검증
- 누락된 파라미터 처리
- 파라미터 제약 조건 설정
워크플로우 패턴
- 기본 파라미터 플로우
- 기본 대체 값 (fallback)
- 파라미터 분배

Table of Contents

주요 기능

URL 파라미터 추출
JSON 객체 변환
기본값 처리
파라미터 검증
동적 플로우 (Dynamic Flow) 구성

이럴 때 사용하세요

URL을 통한 플로우 구성
초기 사용자 파라미터 전달
동적 플로우 실행
다중 구성 배포 (Multi-configuration deployment)

이렇게 사용하세요

명확한 파라미터 구조 정의
합리적인 기본값 제공
파라미터 유형 검증
누락된 파라미터를 적절하게 처리

URL 파라미터 형식

파라미터는 표준 URL 쿼리 형식을 따라야 함
예시: ?param1=value1&param2=value2
배열은 반복된 파라미터를 사용하여 전달할 수 있음

파라미터 처리

URL 파라미터가 기본값을 덮어씀
잘못된 파라미터는 무시함

사용 예시

// Example URL:
// <https://hyperflow-ai.com/bot?fg={flowgraph_id}&count=5&tags=tag1&tags=tag2>

// Resulting JSON:
{
  "name": "test",
  "count": 5,
  "tags": ["tag1", "tag2"]
}

Data transform (데이터 변환) 노드는 개별 쿼리 파라미터 값을 쉽게 추출하고 이를 텍스트나 숫자로 변환하여 플로우 그래프의 다운스트림 노드로 전달하는 데 사용할 수 있습니다.

예를 들어, Control API URL에서 "name" 쿼리 파라미터에 접근하려면, Data transform (데이터 변환) 노드를 JSON 객체를 입력으로 받도록 구성하고 원하는 타입으로 출력을 설정한 후, Launch parameters 노드를 Input 1에 연결하고 다음과 같은 간단한 코드 라인을 추가하면 됩니다:


output = input1[”userID”]

// Default parameters should be structured as a JSON object

{
  "name": "default",
  "count": 1,
  "tags": [],
  "enabled": true
}

파라미터

Property	Type	설명	Required
`Default parameters`	`JSON`	URL 파라미터가 없을 때의 기본 JSON 객체	No

출력 형식

Property	Type	설명
`Parameters`	`JSON`	결합된 URL과 기본 파라미터를 JSON 객체로 표현