노드와 연결

작업이 일어나는 곳에서 노드를 추가합니다

Canvas는 현재 작업에서 멀어지지 않고 그래프를 만들 수 있도록 여러 노드 생성 경로를 제공합니다.

• 상단의 Add node 선택
• 마우스 오른쪽 클릭 또는 Space로 Add 메뉴 열기
• /로 Search nodes 실행
• 빈 Canvas를 더블클릭해 Quick Add 열기
• 와이어를 빈 Canvas로 끌어 호환되는 입력을 가진 노드만 보고, 고른 노드를 자동 연결
• Paste node, Add note, Create backdrop으로 재사용·정리

Quick Add는 호환성을 알고 있습니다. Image나 Video 와이어에서 시작한 뒤 아무 관계 없는 긴 노드 목록을 보여 주지 않습니다.

노드는 실제로 구성된 Capability입니다

Video, Generate Image, Audio, Assistant, Inpaint, Multi-view, Asset, List, Viewer 같은 일반 노드 패밀리는 카탈로그를 통해 구체적인 기능이 됩니다.

작업·모델 Variant를 고르면 Canvas가 다음 선언을 실제 노드로 구성합니다.

• 입력·출력 포트
• 설정과 허용 값
• 기본값과 UI 라벨
• 레퍼런스 수용량과 미디어 타입
• 프롬프트 또는 Direction 경계
• 실행·가격 메타데이터

Canvas는 임의의 프로바이더 설정을 추측하지 않습니다. 현재 Variant 계약에 없는 설정이나 레퍼런스 포트를 UI가 만들어 내지 않습니다.

타입 포트와 연결 규칙

눈에 보이는 플러그는 Image, Video, Audio, Image set, Prompt, Text, Number를 구분합니다. 연결이 그래프에 들어가기 전에 다음을 거부합니다.

• 자기 자신으로 돌아오는 연결
• 알 수 없거나 더 이상 유효하지 않은 포트
• 호환되지 않는 소스·대상 타입
• 중복 와이어
• 대상 포트가 선언한 수용량을 넘는 연결

단일 입력 포트에 새 소스를 연결하면 이전 연결을 하나의 undo 가능한 작업으로 교체합니다. 다중 입력 포트는 그래프가 선언한 순서가 있는 컬렉션을 유지합니다.

Variant를 바꾼 뒤 수리합니다

모델 변경은 라벨만 바꾸는 일이 아닙니다. 새 Variant가 포트를 추가·이름 변경·종료할 수 있습니다. 종료된 포트에 와이어가 남아 있으면 Canvas는 예전 핸들을 수리 상태로 계속 보여 줍니다.

연결은 사용자가 제거하거나 다시 연결할 때까지 명시적으로 남습니다. 소스를 조용히 버리거나 Image를 다른 레퍼런스 역할로 재해석하거나 새 모델에서 그래프가 유효하다고 가장하지 않습니다.

Variant를 바꾼 뒤 Validate를 사용합니다. 노드 오류는 빠졌거나 호환되지 않는 정확한 입력을 알려 줍니다.

Asset node와 고정 레퍼런스

파일을 Canvas로 끌면 Asset node를 만들기 전에 먼저 등록합니다. Choose from Library를 사용할 수도 있습니다.

Asset node에는 서로 다른 두 계약이 있습니다.

• latest resolves at run start — 실행 구성 시점의 가장 최신 Revision을 의도적으로 사용
• Pin a revision — Flow를 정확한 rN에 연결

Assistant에 연결한 레퍼런스만 그 Assistant가 언급할 수 있습니다. @asset 칩은 편집기에 읽기 쉬운 이름을 보여 주면서도 고정 Kref를 유지합니다. 에이전트가 관련 없는 Project 미디어를 조용히 가져오는 것을 막습니다.

List와 컬렉션 동작

List node는 prompt, image, video, audio의 순서가 있는 컬렉션을 만듭니다. 행을 포함·제외하고 순서를 바꿀 수 있습니다.

다음 동작은 소비 노드의 계약이 정합니다.

• singleton은 호환되는 반복 입력 전체에 broadcast될 수 있습니다.
• 호환되는 여러 List는 위치 순서대로 zip될 수 있습니다.
• each 소비자는 항목을 순서대로 실행합니다.
• 영상 레퍼런스 컬렉션은 Together와 Each image를 구분할 수 있습니다.

List 실행은 범위가 보이는 작업이며 제한 없는 무인 fan-out 시스템이 아닙니다. 완전한 시각 for_each 자식 그래프 저작 화면은 현재 Canvas에 포함되어 있지 않습니다.

Viewer와 출력 화면

Viewer는 생성 없이 연결된 Asset을 살펴봅니다. 노드 출력 본문은 이미지, 영상, 오디오, 텍스트, 여러 Take의 갤러리를 표시할 수 있습니다.

컬렉션은 계속 컬렉션입니다. 현재 캐러셀에 보이는 항목 하나로 Take 목록을 조용히 줄이지 않습니다. 명시적인 호환 선택이 없다면 단일 Asset만 받는 다음 노드는 순서가 있는 출력 세트를 거부할 수 있습니다.

읽기 쉬운 Flow로 정리합니다

Drag, Select, Arrange, 미니맵, Note, Backdrop을 사용해 Flow를 읽기 쉽게 만듭니다.

Backdrop은 레이아웃 전용입니다. 배치 범위, 실행 컨테이너, 자식 그래프를 만들지 않습니다. 시각 그룹은 실행 의미를 바꾸지 않고 워크플로우를 설명합니다.

주요 단축키와 그래프 동작은 undo할 수 있습니다. 이름 있는 Template을 불러오면 두 그래프를 애매하게 병합하지 않고 Canvas 전체를 하나의 undo 가능한 동작으로 교체합니다.