Ontology Query Node

Ontology Query 노드는 필터 표현식을 사용하여 Ontology 객체를 쿼리하고 일치하는 레코드를 배열로 반환합니다. 기존 구조화된 데이터를 워크플로우로 가져오는 데 사용합니다.

워크플로우의 목적에 맞게 데이터를 읽고 정제해야 할 때 사용하세요. Agent에게 컨텍스트 제공, 중복 여부 확인, 과거 레코드 조회, 또는 데이터 중심 워크플로우 구축할 때 적합합니다.

설정

필드	필수	설명
Name	Yes	워크플로우 내에서 노드를 고유하게 식별하는 이름입니다.
Description	No	노드의 역할을 간략하게 설명하는 텍스트입니다.
Ontology Object	Yes	`Dropdown` 쿼리할 Ontology 객체를 선택합니다.
Query	Yes	객체 속성을 대상으로 하는 SQL 스타일 쿼리입니다. 쿼리 결과가 노드의 출력이 되어 다운스트림 노드에서 사용됩니다.

워크플로우에서 실제로 필요한 데이터만 가져오는 집중적인 쿼리를 작성하세요. 결과가 많은 광범위한 쿼리는 워크플로우의 실행 속도를 저하시킬 수 있습니다.
워크플로우 노드에 삽입하기 전에 Ontology에서 독립적으로 쿼리를 테스트하세요. 이를 통해 쿼리 자체의 문제와 워크플로가 결과를 처리하는 방식의 문제를 더 쉽게 구분할 수 있습니다.

✅ Examples:

최근 가격 조회:

Object: price_history

Expression: date >= "2026-01-01"

Row Limit: 50

→ Code node formats for report

브랜드 데이터를 Agent에 전달:

Object: brands

Expression: name == "ACME"

→ Agent receives brand record as context

SQL 구문 오류가 가장 흔한 실패 원인입니다. 쿼리 구문, 객체 유형 이름, 속성 참조가 올바른지 확인하세요.
결과가 없는 쿼리 자체는 오류를 발생시키지 않지만, 데이터를 기대하는 다운스트림 노드가 예상치 못한 동작을 할 수 있습니다. Condition 노드 등으로 빈 결과 집합에 대한 처리를 추가하세요.