개발자 가이드

워크플로를 확장하는 개발자를 위한 참고 자료 - 생태계의 핵심 요소, 정의 언어, 컴파일러와 실행 엔진, 종류, 그리고 자체 블록을 작성하는 방법.

이 섹션은 다음과 같은 사람들을 위한 것입니다 확장하는 Roboflow Workflows를 단순히 사용하는 데 그치지 않고 확장하는 사람들: 블록 작성자, 플러그인 유지 관리자, 그리고 Workflows Execution Engine을 자신의 애플리케이션에 통합하는 모든 사람.

브라우저에서 Workflow를 만들고 실행하기만 원한다면, 대신 다음부터 시작하세요 워크플로 생성 및 Workflow 만들기 대신.

Workflows의 핵심 요소

여러 구성 요소가 함께 작동하여 Workflow를 구동합니다. 일부는 매일 직접 다루고, 다른 일부는 보이지 않는 곳에서 실행됩니다.

• Workflows UI — Workflows를 설계하고 관리하는 시각적 편집기입니다. 반드시 필요한 것은 아니지만, 아이디어를 작동하는 Workflow로 가장 빠르게 만드는 방법입니다. 설계 과정이 끝나면 Compiler와 Execution Engine이 사용하는 Workflow Definition을 생성합니다.

• Workflow Definition — Workflows 언어로 작성된 프로그램처럼 동작하는 교체 가능한 JSON 문서입니다. Workflow의 설계와 실행을 분리합니다: 한 번 작성한 뒤 어떤 환경에서든 실행할 수 있습니다. 이것은 다음을 선언합니다 inputs (이미지 또는 구성 매개변수), steps (입력이나 다른 단계의 출력에 연결된 블록 인스턴스), 그리고 outputs (단계 출력을 참조하는 이름 있는 필드).

• Workflow 블록 — 특정 작업을 수행하는 모듈형 구성 요소입니다. Workflow 작성자에게는 선언된 입력, 구성 속성, 출력이 있는 블랙박스입니다. 블록은 다음으로 그룹화됩니다 플러그인 , 일반적인 Python 라이브러리입니다. Roboflow는 자체 플러그인을 제공하며 커뮤니티도 자신의 플러그인을 배포할 수 있습니다.

• Compiler 및 Execution Engine — Definition을 계산 그래프로 변환한 다음 실행하는 시스템입니다. 전통적인 언어의 컴파일러처럼, 먼저 올바름을 검사한 뒤 런타임에서 무거운 작업을 처리합니다. 이들은 다음과 함께 제공됩니다 추론 서버 그리고 inference Python 패키지.

핵심 개념

• Workflow Definition 문법 — JSON 언어: 버전 표시, 입력, 단계, 선택자, 출력

• 워크플로 실행 — 배치 중심 데이터, 스칼라, 차원 수준, 조건부 실행, 그리고 출력이 구성되는 방식

• Kinds — 블록 간 연결을 컴파일 시 검증 가능하게 만드는 Workflows 타입 시스템

• 데이터 표현 — 블록이 실제로 받는 Python 타입: 배치, WorkflowImageData, VideoMetadata

내부 구조

• Workflows Compiler — 블록 로딩, 파싱, 그래프 구성, 데이터 계보 추적, 단계 초기화

• 실행 엔진 — 런타임 입력 검증, 실행 순서, 단계 입력 조립, 흐름 제어

• 내부 Workflow — 하나의 Workflow Definition을 다른 Workflow 안에 포함시키기

• Execution Engine 변경 로그 — 각 Execution Engine 버전에서 무엇이 변경되었는지

• 버전 관리 — Definition, 블록, Engine 간의 호환성 약속

빌딩 블록

• Workflow 블록 만들기 — 전체 가이드: 매니페스트, 입력, 출력, 배치 처리, 흐름 제어, 차원성

• 블록을 플러그인으로 묶기 — 플러그인 구조, 필수 인터페이스, 종류, 초기화기, 직렬화기

• 동적 Python 블록 — Workflow Definition 안에서 블록을 그 자리에서 정의하기

• 블록 테스트 — 단위 및 통합 테스트 접근 방식

• 커뮤니티 플러그인 — 커뮤니티가 게시한 플러그인

Workflows 운영

• Workflows Schema API — Workflow의 입력, 출력, 타입 힌트를 프로그래밍 방식으로 설명하기

• Workflow 프로파일링 — 단계 소요 시간을 측정하고 병목 지점 찾기

• 벤치마크 — 직접 모델 추론과 비교한 Workflow 오버헤드

• 비디오 처리 — 비디오 프레임과 스트림에서 Workflows 실행