Files
2nd/10_Wiki/Topics/Domain_Design/Comfyui/위키 Subgraph blueprints - ComfyUI 2026-05-20.md
T
Antigravity Agent c24165b8bc refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조
에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-11 11:05:56 +09:00

4.0 KiB

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_rypt_history, tags, raw_sources, applied_in, github_commit
id title category status verification_status canonical_id aliases duplicate_of source_trust_level confidence_score created_at updated_at review_reason merge_rypt_history tags raw_sources applied_in github_commit
subgraph-blueprints---comfyui Subgraph blueprints - ComfyUI 10_Wiki/Topics draft conceptual
B 0.8 2026-05-20 2026-05-20
web
wikify
https://docs.comfy.org/custom-nodes/subgraph_blueprints

Subgraph blueprints - ComfyUI

🎯 한 줄 통찰 (One-line insight)

ComfyUI에서 커스텀 노드 개발자가 재사용 가능한 서브그래프 컴포넌트를 글로벌 블루프린트로 제공하여 사용자가 워크플로우에 즉시 추가할 수 있게 하는 기능입니다.

🧠 핵심 개념 (Core concepts)

  • Global Subgraph Blueprints: 커스텀 노드와 연관된 재사용 가능한 subgraph 컴포ned를 전역 블루프린트로 가용화하는 기능입니다.
  • Automated Scanning: ComfyUI는 모든 커스텀 노드 디렉토리를 스캔하여 subgraph 파일을 자동으로 찾아냅니다.
  • API Delivery: 스캔된 서브그래프 파일은 /global_subgraphs API 엔드포인트를 통해 서비스됩니다.

🧩 추출된 패턴 (Extracted patterns)

  • 개발자 워크플로우: 커스텀 노드 디렉토리 내 subgraphs/ 폴더 생성 \rightarrow .json 파일 배치 \rightarrow ComfyUI 자동 스캔 및 API 제공.
  • 서브그래프 생성 절차: ComfyUI에서 서브그래프 구축 \rightarrow 노드 선택 및 변환 \rightarrow JSON으로 내보내기 \rightarrow subgraphs/ 폴더에 저장.

📖 세부 내용 (Details)

🛠️ 구현 방법 (Implementation)

노드 개발자는 다음과 같은 방식으로 블루프린트를 배포할 수 있습니다:

  1. 커스텀 노드 디렉토리 내에 subgraphs/ 폴더를 생성합니다.
  2. 해당 폴더 안에 .json 형식의 서브그래프 파일을 배치합니다.

📂 파일 구조 예시 (Example Structure)

ComfyUI-MyCustomNodeModule/subgraphs/ 경로 내에 다음과 같은 파일이 포함될 수 있습니다:

  • My_upscale_subgraph.json
  • My_effects_subgraph.json 위와 같이 구성된 경우, ComfyUI의 서브그래프 브라우저에서 해당 블루프린트들을 확인할 수 있습니다.

📝 JSON 파일 생성 프로세스 (Creation Process)

서브그래프 JSON 파일은 워크플로우 JSON 파일과 동일한 형식을 사용하며, 가장 쉬운 생성 단계는 다음과 같습니다:

  1. ComfyUI 내에서 서브그래프를 구축합니다.
  2. 포함할 노드들을 선택합니다.
  3. 해당 노드들을 서브그래프로 변환합니다.
  4. 서브그래프를 JSON으로 내보내기(Export) 합니다.
  5. 생성된 JSON 파일을 subgraphs/ 폴더에 저장합니다.

⚖️ 모순 및 업데이트 (Contradictions & updates)

본문에서 확인되지 않음.

🛠️ 적용 사례 (Applied in summary)

  • 커스텀 노드 배포: ComfyUI-MyCustomNodeModule과 같은 커스텀 노드 모듈에서 사용자가 워크플로우에 즉시 추가할 수 있는 사전 구축된 노드 그룹(pre-built node groups)을 제공하는 사례로 활용됩니다.

검증 상태 및 신뢰도

  • 상태: draft
  • 검증 단계: conceptual
  • 출처 신뢰도: B (Primary Source — 웹사이트 본문 직접 추출)
  • 중복 검사 결과: 신규 생성 (New discovery)
  • subgraph: 사용자가 서브그래프와 상호작용하는 방식에 대한 기본 개념입니다.
  • ComfyUI API Reference: /global_subgraphs 엔드포인트와 관련된 기술적 명세입니다.
  • Custom Nodes: 커스텀 노드 개발 및 배포를 위한 가이드라인입니다.
  • Workflow JSON: 서브그래프 파일의 기반이 되는 데이터 형식입니다.

📝 변경 이력 (Change history)