PromptVertexAI
PromptVertexAI
VertexAI에 프롬프트를 보내고 응답을 FlowFile 속성 또는 들어오는 FlowFile 내용으로 작성하는 프로세서예요. 프롬프트는 순수 텍스트 상호작용이거나 멀티미디어를 포함할 수 있어요.
본문
번들 (Bundle)
com.snowflake.openflow.runtime | runtime-vertexai-nar
설명
VertexAI에 프롬프트를 보내고 응답을 FlowFile 속성 또는 들어오는 FlowFile 내용으로 작성해요. 프롬프트는 순수 텍스트 상호작용이거나 멀티미디어를 포함할 수 있어요.
태그
ai, chat, cloud, gcp, google, image, openflow, pdf, prompt, text, video
입력 요구 사항 (Input Requirement)
선택 (OPTIONAL) — 입력 FlowFile이 선택적이에요.
민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false — 지원하지 않아요.
속성 (Properties)
| 속성 | 설명 |
|---|---|
| GCP Credentials Service | Google Cloud Platform 자격 증명을 얻기 위한 Controller Service예요. |
| GCP Location | Vertex 클라이언트를 구성할 위치(location)예요. |
| GCP Project ID | Vertex 클라이언트를 구성할 프로젝트 ID예요. |
| Max File Size | 이미지로 Vertex에 보낼 수 있는 FlowFile의 최대 크기예요. 이보다 크면 'failure'로 라우팅돼요. |
| Max Tokens | 생성할 최대 토큰 수예요. |
| Media MIME Type | FlowFile 내용에 있는 미디어의 MIME 타입이에요. 지원되는 미디어 타입은 여기서 확인하세요: https://firebase.google.com/docs/vertex-ai/input-file-requirements |
| Model Name | Vertex 모델의 이름이에요. |
| Output Strategy | 응답 출력 위치를 결정해요. |
| Prompt Type | Vertex에 보낼 프롬프트 유형이에요. Text는 단순 프롬프트를 보내요. Media는 멀티미디어 유형을 먼저 보낸 다음 텍스트 프롬프트를 보내요. |
| Response Format | Vertex 응답의 형식이에요. |
| Results Attribute | 응답을 쓸 속성의 이름이에요. |
| Stop Sequences | 쉼표로 구분된 문자열 목록으로 stop sequence 역할을 해요. 모델은 stop sequence 중 하나를 만난 후 멈춰요. |
| System Message | Vertex에 보낼 시스템 메시지예요. FlowFile 속성은 Expression Language로, FlowFile 내용은 flowfile_content 변수로 참조할 수 있어요(예: ${flowfile_content}). |
| Temperature | 응답 생성에 사용할 온도예요. 기본값은 1.0, 범위는 0.0~1.0이에요. 분석적/객관식 작업에는 0.0에 가깝게, 창의적·생성적 작업에는 1.0에 가깝게 사용하세요. |
| Top K | 응답 생성에 사용할 top K 값이에요. 각 후속 토큰에 대해 상위 K개 옵션에서만 샘플링해요. 고급 사용 사례에만 권장해요. 보통은 temperature만 사용하면 돼요. |
| Top P | 응답 생성에 사용할 top P 값이에요. Top P는 nucleus sampling으로, 각 후속 토큰에 대해 모든 옵션의 누적 분포를 확률 내림차순으로 계산하고 top_p가 지정한 특정 확률에 도달하면 잘라내요. 고급 사용 사례에만 권장해요. 보통은 temperature만 사용하면 돼요. |
| User Message | Vertex에 보낼 사용자 메시지예요. FlowFile 속성은 Expression Language로, FlowFile 내용은 flowfile_content 변수로 참조할 수 있어요(예: ${flowfile_content}). 사용자 메시지는 이미지가 없는 경우 먼저 추가돼요. |
관계 (Relationships)
| 이름 | 설명 |
|---|---|
failure |
Vertex에서 유효한 응답을 얻지 못하면 원본 FlowFile이 이 관계로 라우팅돼요. |
success |
Vertex의 응답이 이 관계로 라우팅돼요. |
쓰기 속성 (Writes attributes)
| 이름 | 설명 |
|---|---|
vertex.usage.inputTokens |
요청에서 읽은 입력 토큰 수예요. |
vertex.usage.outputTokens |
응답에서 생성된 출력 토큰 수예요. |
vertex.chat.completion.id |
대화에 할당된 고유 ID예요. |
mime.type |
응답의 MIME 타입이에요. |
filename |
응답에 대한 업데이트된 파일 이름이에요. |