워크플로 연결과 작동 원리
워크플로 연결은 컴포넌트 사이에 데이터를 전달하며, 워크플로는 타입이 지정된 연결로 이어진 컴포넌트의 집합입니다. 컴포넌트에는 텍스트, 선택 항목, 인증 정보 등의 설정 필드도 있을 수 있습니다. 일반적인 연결선에는 일치하는 포트 타입이 하나 이상 필요하지만, 연결 자체가 설정이나 런타임 성공을 검증하지는 않습니다. AI Flowi Workflow를 참고하세요.
작성: Ai Flowi · 기술 검토: Janice Lee, Ai Flowi 기술 지원.
게시일 · 업데이트
워크플로란 무엇인가요? 예시로 알아보기
워크플로는 타입이 지정된 연결을 통해 컴포넌트를 이어 줍니다. 예를 들어 Playground 채팅 워크플로는 Chat Input의 Message를 호환되는 AI 모델에 보내고, 모델의 Message 응답을 Chat Output으로 보냅니다. 설정 필드에는 인증 정보 등의 설정을 저장합니다. 연결 입력과 출력은 컴포넌트 사이에서 전달할 수 있는 데이터 타입을 결정합니다.
| 용어 | 확인할 사항 |
|---|---|
| 컴포넌트 | 용도, 필수 설정, 연결 입력, 출력. |
| 설정 입력 | 일치시킬 문구나 인증 정보처럼 직접 입력하거나 선택하는 값. |
| 연결 입력 | 다른 컴포넌트의 출력에서 받을 수 있는 타입. |
| 출력 | 후속 컴포넌트에 제공하는 데이터의 타입. |
자주 선언되는 타입에는 Message, JSON, Table, Data, LanguageModel, Tool이 있습니다. 일반적인 타입 지정 연결선에서는 소스 출력 타입 중 적어도 하나가 대상 입력이 받는 타입과 일치해야 합니다. 컴포넌트 카탈로그에 문서화된 인터페이스가 나와 있습니다.
연결 확인
- 소스 컴포넌트의 출력 이름과 선언된 타입을 찾으세요.
- 대상 컴포넌트의 연결 입력과 허용 타입을 찾으세요.
- 공통 타입이 있으면 포트를 연결하세요. 필수 필드와 인증 정보는 별도로 설정하세요.
- 작은 테스트를 실행하고 예상 데이터를 생성하지 못하는 첫 번째 컴포넌트를 확인하세요.
예를 들어 첫 Playground 워크플로는 Chat Input의 Message를 호환되는 모델로 전달한 다음, Message 응답을 Chat Output으로 전달합니다. 웹훅 튜토리얼은 Structured Output에 전달하기 전에 JSON 웹훅 출력을 Message로 변환하는 이유를 설명합니다.
연결이 실패하는 경우
먼저 정확한 출력 및 입력 타입을 확인하세요. 포트는 연결되지만 실행이 실패하면 필수 설정과 인증 정보를 확인한 다음 이전 단계를 다시 테스트하세요. 추가 점검 사항은 자주 발생하는 오류에 나와 있습니다. 워크플로를 가져오거나 컴포넌트를 업데이트한 후에는 워크플로 수명 주기 가이드에 따라 영향을 받는 연결을 확인하고 다시 테스트하세요.
단축키와 캔버스 편집
AI Flowi Workflow에서 설정 → 단축키를 열어 현재 키 조합을 확인하세요. 단축키를 두 번 클릭하면 새 키 조합을 등록할 수 있습니다. 다른 작업에 이미 할당된 조합은 거부됩니다. 복원을 사용하면 단축키 목록을 기본값으로 되돌릴 수 있습니다. 사용자 지정 키 조합은 이 브라우저에 저장됩니다.
설정된 그룹화, 복사, 붙여넣기, 복제, 삭제 단축키를 사용해 선택한 캔버스 컴포넌트를 정리하거나 재사용하세요. 그룹화는 선택한 연결을 점검하며, 선택이 유효하지 않으면 그룹을 만들지 않고 오류를 알립니다. 기록이 있으면 실행 취소와 다시 실행으로 기록된 캔버스 상태 사이를 이동할 수 있습니다. 워크플로가 잠겨 있거나 에이전트가 작업 중이거나 버전을 미리 보는 동안에는 실행 취소, 다시 실행, 그룹화, 붙여넣기, 복제, 삭제가 차단됩니다.
Playground와 첨부 파일
Playground는 워크플로를 테스트할 수 있는 채팅 화면을 제공합니다. 독립형 페이지를 사용하려면 인식 가능한 입력 또는 출력이 있는 공개 워크플로가 필요합니다. 첨부 컨트롤로 메시지에 파일을 추가하세요. 첨부 파일은 미리 보기로 표시되며 업로드된 경로가 메시지와 함께 전송됩니다. 설정한 워크플로가 첨부한 파일을 처리할 수 있는지 테스트하세요.
저장된 메시지와 세션 범위
설정 → 메시지를 열면 저장된 메시지 표가 표시됩니다. 세션별 보기에서는 세션을 기준으로 메시지를 필터링하고, 워크플로가 지정된 경우 워크플로 기준도 적용합니다. 독립형 Playground 페이지 밖에서는 메시지 텍스트를 수정하고 선택한 메시지 행을 삭제할 수 있습니다. 독립형 Playground 페이지에서는 이 표의 메시지 편집과 삭제가 비활성화됩니다. 삭제는 선택한 메시지 ID를 대상으로 하며 워크플로 삭제와는 별개입니다.