AI 워크플로 모델과 변수
AI 워크플로 모델과 변수는 AI Flowi Workflow에서 모델 제공업체와 재사용 가능한 값을 컴포넌트 필드에 연결합니다. API 허브는 관리형 접근 또는 워크스페이스 자체의 제공업체 키를 사용하는 방식을 제공합니다. 지원되는 컴포넌트 필드는 워크플로에 값을 직접 넣는 대신 이름으로 Global Variables를 불러올 수 있습니다.
작성: Ai Flowi · 기술 검토: Janice Lee, 기술 지원, Ai Flowi.
게시일 · 수정일
제품: Ai Flowi의 AI Flowi Workflow · 설정: 모델 접근과 재사용 가능한 값
API 허브의 모델 제공업체
API 허브 카탈로그에는 OpenAI, Anthropic, Google Gemini, DeepSeek, Groq 및 OpenRouter가 포함되어 있습니다. 모델 호출을 실행하려면 먼저 제공업체 경로를 설정하고 활성화해야 합니다. 워크스페이스에 표시된 카탈로그를 확인합니다. 카탈로그에 항목이 있다는 사실만으로 제공업체가 활성화되어 있다고 볼 수는 없습니다.
Flowi AI 컴포넌트는 Model 선택기에 사용할 API 허브의 언어 모델 카탈로그를 읽습니다. 모델 호출에는 선택한 카탈로그 항목을 사용합니다. 이 선택기가 있다고 해서 명시된 제공업체의 모든 모델이나 미디어 기능을 사용할 수 있다는 의미는 아닙니다.
관리형 접근과 자체 키 사용
관리형 API 허브 호출의 모델 사용 비용은 Flowi Tokens로 결제합니다. 관리형 키는 워크스페이스에 속하며, 허용되는 API와 토큰 예산을 제한할 수 있습니다. 관리형 접근을 이용할 때는 Flowi AI 컴포넌트 안에 제공업체 키를 넣을 필요가 없습니다.
자체 키 사용 방식인 BYOK는 워크스페이스에 저장된 제공업체 키를 사용합니다. API 허브는 해당 키를 암호화하여 저장하고, 키의 세부 정보는 마스킹하여 반환합니다. 제공업체는 선택한 모델의 제공업체와 일치해야 하며, 저장된 키는 활성 상태여야 합니다. BYOK는 제공업체 비용으로 Flowi Tokens를 차감하지 않으며, 해당 비용은 제공업체 계정에서 부담합니다. 워크플로 실행 요금은 별도입니다.
컴포넌트를 테스트하기 전에 모델 접근을 설정합니다. 컴포넌트 연결이 유효하다는 것만으로 외부 모델 호출까지 검증되지는 않습니다. 워크플로 사용량과 토큰 내역에서 기록된 요금과 토큰 잔액을 확인합니다.
실행 전 모델 호출 비용 미리 보기
API 허브는 실행 전에 관리형 모델 호출의 Flowi Token 사용량을 추정할 수 있습니다. 추정에는 선택한 요율표와 입력 크기 미리 보기를 사용합니다. 설정 화면에는 예상 사용량, 사전 확보할 토큰 수와 해당 토큰 확보 후 잔액이 표시됩니다.
이는 미리 보기를 위한 추정 방식이며, 전체 워크플로의 최종 요금이 아닙니다. 추정 과정에서는 모델 요청을 보내거나 실행 요금을 부과하지 않습니다. 실제 관리형 모델 요금은 API 허브의 과금 절차를 통해 정산됩니다. BYOK 제공업체 요금은 이 관리형 토큰 미리 보기와 별개입니다.
Flowi AI 컴포넌트 설정
- 워크플로에 Flowi AI 컴포넌트를 추가합니다.
- Model 선택기를 새로 고침하고 원하는 API 허브 카탈로그 항목을 선택합니다.
- API 허브에서 선택한 모델에 대해 저장된 워크스페이스 설정을 확인합니다. 저장된 설정은 컴포넌트의 Payment 및 BYOK entry id 필드보다 우선합니다.
- 저장된 설정이 managed 모드를 사용하면 컴포넌트에 byok라고 표시되어 있어도 호출은 관리형 접근을 사용합니다.
- 저장된 설정이 byok를 사용하면 컴포넌트에 managed라고 표시되어 있거나 다른 키가 지정되어 있어도 호출은 저장된 워크스페이스 키를 사용합니다.
- 해당 모델의 설정이 저장되어 있지 않다면 고급 Payment 필드에서 managed 또는 byok를 선택합니다. byok의 경우 제공업체 비밀 키가 아닌, 저장된 워크스페이스 키의 BYOK entry id를 입력합니다.
- 실행 전에 실제 적용되는 모드와 저장된 키를 확인합니다. BYOK 키는 활성 상태이고 해당 워크스페이스에 속해야 하며, 모델의 제공업체와 일치해야 합니다.
- 문제를 일으키지 않는 프롬프트로 워크플로를 테스트하고 모델 응답을 확인합니다.
컴포넌트는 선택한 모델 항목과 요청한 결제 모드를 API 허브로 전달합니다. 저장된 워크스페이스 설정이 있으면 해당 설정이 실제 적용 모드를 결정합니다. 제공업체 키를 워크플로에 저장하지는 않습니다. 모델 호출이 실패하면 모델 설정과 오류 세부 정보를 확인합니다. 허브 사용 불가, 비활성 모델, 권한 누락 또는 부적합한 BYOK 항목으로 인해 호출이 차단될 수 있습니다.
기존 모델 제공업체 설정
모델 제공업체 설정은 AI Flowi Workflow에서 사용하는 모델의 인증 정보를 저장합니다. 제공업체 서비스는 제공업체와 모델을 나열하고, 저장 시 인증 정보를 검증하며, 설정된 제공업체를 식별하고, 활성화된 모델과 기본 모델 선택을 지원합니다. 이 설정은 해당 인증 정보 시스템을 사용하는 컴포넌트에 여전히 적용되며, API 허브의 워크스페이스 BYOK 항목과는 별개입니다.
제공업체 인증 정보를 저장한 뒤 원하는 모델이 활성화되어 있는지 확인하고 워크플로를 테스트합니다. 모델 호출이 실패하면 제공업체 설정과 오류 세부 정보를 확인합니다.
Global Variables
Global Variables는 지원되는 컴포넌트 필드에 재사용 가능한 값을 제공합니다. 변수 불러오기가 활성화된 필드는 컴포넌트 실행 전에 변수 이름에 해당하는 값을 불러옵니다. 변수를 사용하는 컴포넌트를 테스트하기 전에 필요한 변수를 설정합니다.
공유 워크플로 텍스트와 예시에 인증 정보 값을 넣지 않습니다. 설정을 문서화할 때는 YOUR_MODEL_KEY와 같은 변수 이름이나 자리표시자를 표시합니다. 워크플로 텍스트에 비밀 값을 직접 넣는 대신 필드에서 지원하는 변수 불러오기 기능을 사용합니다.
관련 자료
LLM 선택기 튜토리얼에서는 문서화된 모델 라우팅 워크플로를 보여줍니다. 컴포넌트 카탈로그는 해당 워크플로의 모델 및 처리 컴포넌트를 확인하는 데 도움이 됩니다.