워크플로 가져오기, 내보내기 또는 업데이트 방법
워크플로 가져오기와 내보내기는 AI Flowi Workflow에서 워크플로 JSON을 주고받는 기능입니다. 저장된 플로의 컴포넌트 정의도 업데이트할 수 있습니다. 일반 내보내기 경로는 다운로드 전에 인증 정보 필드를 제거하지만, 일반 텍스트 필드에는 입력한 비밀 정보가 남아 있을 수 있습니다. 업데이트로 컴포넌트 구조가 바뀌면 제안된 변경 사항을 검토하고, 연결을 확인한 뒤 워크플로를 다시 테스트합니다. 수정일: 2026년 10월 9일.
작성: Ai Flowi · 기술 검토: Janice Lee, 기술 지원, Ai Flowi.
게시일 · 수정일
사전 준비
- 내보내거나 컴포넌트를 업데이트할 워크플로를 열거나, 가져올 JSON 파일을 준비합니다.
- 나중에 변경 사항을 되돌릴 수 있도록 변경 전에 워크플로 사본을 보관합니다.
- 내보낸 예시를 공유하기 전에 일반 텍스트 필드에서 실제 인증 정보를 제거합니다. 다음과 같은 자리표시자를 사용합니다:
YOUR_API_KEY_VARIABLE.
JSON 가져오기 또는 내보내기
- 내보내려면 일반 워크플로 내보내기 작업을 사용하여 JSON 파일을 다운로드합니다. 공유 전에 파일을 확인합니다. 인증 정보 제거 처리는 완전한 데이터 유출 방지 검사가 아닙니다.
- 가져오려면 유효한 워크플로 JSON 파일을 선택합니다. 가져오기 도구는 단일 플로 객체 또는 여러 플로가 담긴 컨테이너를 허용합니다.
- 가져온 컴포넌트와 연결을 검토합니다. 일부 이전 연결선 및 출력 형식에는 호환성 처리가 적용됩니다. 그 외 과거 형식은 추가 처리가 필요할 수 있으며 로드되지 않을 수도 있습니다.
- 환경에 맞게 필요한 인증 정보와 서비스를 구성한 뒤 가져온 플로를 테스트합니다.
컴포넌트 업데이트
- 업데이트가 제공되면 현재 컴포넌트 구조와 저장된 구조를 비교하여 검토합니다.
- 확인하기 전에 호환성이 깨지는 변경에 관한 경고를 읽습니다. 업데이트 경로는 입력 이름과 유형의 호환성이 유지되면 입력값을 보존할 수 있으며, 최신 컴포넌트 코드와 구조를 사용합니다.
- 업데이트 후 영향을 받는 모든 연결선을 확인합니다. 호환되지 않는 연결선은 자동으로 다시 매핑되지 않고 사라질 수 있습니다.
- 변경된 경로의 외부 연결까지 포함하여 워크플로를 다시 테스트합니다.
예상 결과
가져오기는 확인할 수 있도록 워크플로를 로드합니다. 내보내기는 인증 정보 필드를 제거하는 경로를 거쳐 워크플로 JSON을 다운로드합니다. 컴포넌트 업데이트는 가능한 경우 호환되는 값을 보존하면서 최신 컴포넌트 구조를 적용합니다. 어느 작업도 외부 인증 정보나 서비스가 런타임에 정상 작동함을 보장하지 않습니다. 다음을 참고하세요: Ask AI.
흔한 오류
- JSON 업로드가 거부됨: 파일에 유효한 JSON이 들어 있는지 확인합니다. 브라우저에서 JSON이 아닌 MIME 유형을 보고하면 표준 JSON 내보내기 파일로 다시 시도합니다.
- 가져온 컴포넌트가 없거나 다름: 컴포넌트 사용 가능 여부와 이전 형식에 대한 호환성 처리를 확인합니다. 다음을 참고하세요: 흔한 오류.
- 업데이트 후 연결이 사라짐: 호환성이 깨지는 변경에 관한 경고를 검토하고 연결선을 확인한 뒤, 해당 경로를 다시 연결하거나 수정하고 재테스트합니다.
프로젝트와 워크플로 정리
AI Flowi Workflow의 Projects(프로젝트)에서 프로젝트를 만들고 검색하며, 카드 보기와 목록 보기를 전환하고 All Projects(모든 프로젝트), Recent(최근 항목), Favorites(즐겨찾기), Archived(보관됨)를 탐색할 수 있습니다.
프로젝트의 즐겨찾기 및 보관 설정은 브라우저에 저장되므로 기기 간에 동기화되지 않습니다. 프로젝트를 보관하면 삭제하지 않고 다른 프로젝트 탭에서 숨깁니다.
프로젝트 카드에는 워크플로 수와 확인 가능한 수정 날짜가 표시됩니다. 활성 프로젝트, 라이브 워크플로, 웹훅 지표는 측정값 대신 사용 불가로 표시됩니다.
프로젝트 안에서는 Workflows(워크플로)를 사용하여 검색하고, 상태별로 필터링하고, 목록 보기와 그리드 보기를 전환하며, 최근 수정일, 이름 또는 Go Live(공개) 준비 상태로 정렬합니다. 즐겨찾기한 워크플로는 다른 워크플로보다 먼저 표시됩니다. 플로별 실행 지표가 없으면 Runs(실행 횟수) 및 Success rate(성공률) 정렬이 비활성화됩니다.
워크플로를 선택하여 일괄 다운로드하거나 확인 후 삭제합니다. 일괄 다운로드는 실행 전용 워크플로를 건너뛰고 건너뛴 항목을 알려 줍니다.
변경 사항 저장 및 캔버스 잠금 확인
Autosave(자동 저장)를 활성화하면 워크플로 변경 사항이 자동으로 저장됩니다. 저장되지 않은 것으로 감지된 변경 사항이나 빌드가 대기 중이면 페이지 이동 보호 기능이 작동하고, 브라우저는 페이지를 닫기 전에 경고할 수 있습니다.
워크플로가 잠겨 있거나, 에이전트가 작업 중이거나, 버전 미리보기가 활성화되어 있으면 캔버스 컨트롤은 노드 끌기, 연결, 선택을 차단합니다.
워크플로 버전 저장, 확인 및 복원
- Version History(버전 기록)을 열고 Current(현재 버전)을 선택하여 작업 중인 초안을 확인합니다. 나중에 확인하고 복원할 버전을 남기려면 Save(저장)을 사용합니다.
- 저장된 버전을 선택하면 읽기 전용 캔버스에서 미리 볼 수 있습니다. 저장된 버전을 명시적으로 복원하지 않은 경우, Current로 돌아가거나 Version History를 나가면 초안으로 돌아갑니다.
- 저장된 버전의 내보내기 작업으로 워크플로 JSON을 다운로드하거나, 삭제 작업으로 확인 후 선택한 기록 항목을 제거합니다.
- 현재 캔버스를 교체하려면 Restore(복원)을 선택하고 버전을 확인합니다. Save current draft before restoring(복원 전에 현재 초안 저장)은 기본으로 선택되어 있습니다. 교체 전에 초안을 보존하려면 선택된 상태로 둡니다.
Version History에는 저장된 항목이 표시되며, 서비스에서 보존 한도를 반환하면 해당 한도도 표시됩니다.
공유 워크플로 가져오기 또는 보기 열기
공유 워크플로 가져오기 링크는 공유 토큰을 사용해 워크플로를 비공개 사본으로 가져온 뒤 해당 사본의 캔버스를 엽니다. 링크가 유효하지 않거나 만료되었거나 더 이상 공개되지 않은 경우 가져오기 화면에 오류가 표시됩니다.
사본을 실행하기 전에 가져온 컴포넌트, 일반 텍스트 필드, 인증 정보를 검토합니다. 가져오기는 외부 연결을 검증하지 않습니다.
별도의 워크플로 보기는 계정에서 이용할 수 있는 워크플로의 캔버스를 열며, 구독에 따른 접근 권한 검사가 계속 적용됩니다. 방문자용 애플리케이션을 게시하려면 다음을 따르세요: 게시 가이드.