Create Ontology Node
설명
Create Ontology 노드는 업스트림 노드의 구조화된 데이터를 새로운 또는 기존의 Ontology 객체에 새 레코드로 저장합니다. 이전 노드의 출력 스키마 필드를 객체 속성에 자동으로 매핑합니다.
사용 시점
워크플로우 실행이 완료된 이후에도 데이터가 플랫폼의 다른 영역(대시보드, 다른 Workflow, AI 채팅 인터페이스)에서 접근 가능해야 할 때 사용합니다. 수집한 가격 데이터를 객체로 저장하거나, 스크래핑한 정보로 상품 레코드를 생성하거나, 분석 결과를 이후 참조를 위해 보존하는 용도로 활용합니다.
설정
| 필드 | 필수 | 설명 |
|---|---|---|
| Name | Yes | 워크플로우 내에서 노드를 고유하게 식별하는 이름입니다. |
| Description | No | 노드의 역할을 간략하게 설명하는 텍스트입니다. |
| Object Type | Yes | Tab-toggle 결과 데이터를 위한 새로운 Ontology 객체를 생성할지, 기존 Ontology 객체에 매핑할지 선택합니다. |
| Ontology Name | 새로운 온톨로지 생성 시 | 결과 데이터를 담을 Ontology 객체의 고유 식별자입니다. |
| Description | No | 생성될 Ontology 객체에 대한 간략한 설명입니다. |
| Ontology Object | 기존 온톨로지에 저장 시 | Dropdown 결과 데이터를 매핑하고 저장할 기존 Ontology 객체를 선택합니다. |
업스트림 데이터 구조와 기존 Ontology 필드 값(있는 경우)을 기반으로 필드가 자동으로 도출되고 매핑됩니다.
사용 팁
- 워크플로우를 구축하기 전에 대상 Ontology 객체 유형과 속성이 정의되어 있는지 확인하세요. Create Ontology 노드는 기존 구조에 데이터를 쓰는 노드이기에 새로운 객체 유형을 생성하지 않습니다. (기존 온톨로지 사용시)
- 업스트림 데이터를 매핑할 때는 Structured 출력과 명확하게 정의된 JSON Schema를 가진 Agent 노드를 사용하세요. 워크플로우 출력 데이터 타입이 Ontology 속성과 일치해야 합니다.
✅ Examples:
경쟁사 분석 저장:
Agent A가
{ brand, score, summary }출력Create Ontology가
competitive_actions라는 새로운 객체 생성→ Agent A 의 출력 값이 새로 생성된 온톨로지 객체인
competitive_actions에 매핑되어 저장됩니다
가격 이력 구축:
Agent B 가
{ product_id, price, date }추출Create Ontology가
price_history에 데이터 추가→ Agent B의 출력 값이 기존 온톨로지 객체인
price_history에 새 행으로 추가됩니다
자주 발생하는 오류
- 워크플로우 데이터와 Ontology 속성 정의 간의 타입 불일치(예: 숫자 필드에 문자열 전달)는 쓰기 실패를 일으킵니다.
- 이 노드는 레코드를 생성합니다 — 기존 레코드를 업데이트하지 않습니다. Upsert가 필요한 경우 Pipeline Builder를 사용하세요.
Last updated on