1-2. 개발 워크플로우

개발 워크플로우

플러그인이 제작되어 실행 결과가 회수되기까지의 전체 흐름을 이해합니다.

플러그인이 만들어져 결과가 나오기까지는 다섯 단계입니다.

flowchart LR
    A["① 제작<br/>규격에 맞춰 작성"]
    B["② 등록<br/>Backend에 게시"]
    C["③ 준비<br/>Agent가 내려받아 보관"]
    D["④ 실행<br/>알맞은 컴퓨터에서 계산"]
    E["⑤ 회수<br/>결과·진행률 전달"]
    A --> B --> C --> D --> E

단계별 흐름

플러그인은 제작, 등록, 준비, 실행, 회수 단계를 거쳐 사용자에게 결과를 전달합니다.

단계	하는 일	설명
① 제작	SDK 규격에 맞춰 작성	개발자가 플러그인이 어떤 입력을 받아 무엇을 하는지 작성합니다.
② 등록	Backend에 퍼블리시	완성된 플러그인을 Backend에 퍼블리시하면 양식 검사 후 보관됩니다.
③ 준비	Agent가 플러그인 준비	작업이 주문되면 Agent가 해당 플러그인을 내려받아 실행 준비를 합니다.
④ 실행	작업 성격에 맞게 계산	Agent가 작업 성격에 맞는 방식으로 실제 계산을 돌립니다.
⑤ 회수	결과와 진행률 전달	진행률과 결과가 Backend를 거쳐 사용자에게 전달됩니다.

실행 중 확인할 수 있는 정보

플러그인을 실행하면 작업(Job) 이 만들어집니다.

작업이 생성되면 진행률과 로그를 실시간으로 확인할 수 있습니다. 대용량 작업은 백그라운드로 실행되므로, 사용자가 화면을 떠나도 작업은 계속 진행됩니다.

사용자가 보는 진행률과 로그는 개발자가 코드에서 set_progress와 log_message로 보고한 값입니다. 이 내용은 2.2에서 더 자세히 다룹니다.

항목	설명
작업(Job)	플러그인 실행 단위입니다. 실행 상태와 결과가 Job 기준으로 추적됩니다.
진행률	`set_progress`로 보고한 값이 사용자 화면에 표시됩니다.
로그	`log_message`로 보고한 메시지가 실행 로그에 표시됩니다.
결과	작업 완료 후 처리 건수, 산출 경로, 실패 항목 등을 확인합니다.

📘
실행 방식 참고
Agent는 작업 성격에 맞는 실행 방식을 선택해 계산을 수행합니다.
개발·테스트처럼 즉시 결과가 필요한 작업은 Local, 짧고 반복적인 작업은 Task, 학습·대량 처리처럼 오래 걸리는 작업은 Job, 실시간 추론 요청은 Serve 방식으로 실행됩니다.
실행 방식의 자세한 차이는 1.1의 실행 방식과 구현 영향에서 확인할 수 있습니다.