PromptAnthropicAI

PromptAnthropicAI

Anthropic에 프롬프트를 보내고 응답을 FlowFile 속성 또는 들어오는 FlowFile의 내용으로 작성하는 프로세서예요. 프롬프트는 순수 텍스트 상호작용이거나 이미지를 포함할 수 있어요.

출처: Snowflake 문서 — PromptAnthropicAI

본문

번들 (Bundle)

com.snowflake.openflow.runtime | runtime-anthropic-nar

설명

Anthropic에 프롬프트를 보내고 응답을 FlowFile 속성 또는 들어오는 FlowFile의 내용으로 작성해요. 프롬프트는 순수 텍스트 상호작용이거나 이미지를 포함할 수 있어요. 동적 속성을 사용해 Anthropic 엔드포인트에서 베타 기능을 활성화할 수 있어요.

태그

ai, anthropic, chat, image, openflow, prompt, text

입력 요구 사항 (Input Requirement)

REQUIRED — 입력 FlowFile이 필요해요.

민감한 동적 속성 지원 (Supports Sensitive Dynamic Properties)

false — 지원하지 않아요.

속성 (Properties)

속성 설명
Anthropic API Key Anthropic에 인증하기 위한 API Key예요.
Assistant Message Anthropic에 보낼 assistant 메시지예요. FlowFile 속성은 Expression Language로, FlowFile 내용은 flowfile_content 변수로 참조할 수 있어요(예: ${flowfile_content}). assistant 메시지는 마지막에 추가돼요.
Image MIME Type FlowFile 내용에 있는 이미지의 MIME 타입이에요. 지원되는 타입은 image/jpeg, image/png, image/gif, image/webp예요.
Max File Size 이미지로 Anthropic에 보낼 수 있는 FlowFile의 최대 크기예요. 이보다 크면 'failure'로 라우팅돼요.
Max Tokens 생성할 최대 토큰 수예요.
Model Name Anthropic 모델의 이름이에요.
Output Strategy 응답 출력 위치를 결정해요.
Prompt Type Anthropic에 보낼 프롬프트 유형이에요. TEXT는 단순 프롬프트를 보내요. IMAGE는 이미지를 먼저 보낸 다음 프롬프트를 보내요. Anthropic의 /v1/messages 엔드포인트를 고급으로 사용하려면 JSON을 사용하세요.
Response Format Anthropic 응답의 형식이에요.
Results Attribute 응답을 쓸 속성의 이름이에요.
Stop Sequences 쉼표로 구분된 문자열 목록으로 stop sequence 역할을 해요. 모델은 stop sequence 중 하나를 만난 후 멈춰요.
System Message Anthropic에 보낼 시스템 메시지예요. 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 ID 요청 메타데이터에 설정할 사용자 ID예요.
User Message Anthropic에 보낼 사용자 메시지예요. FlowFile 속성은 Expression Language로, FlowFile 내용은 flowfile_content 변수로 참조할 수 있어요(예: ${flowfile_content}). 사용자 메시지는 이미지가 없는 경우 먼저 추가돼요.
Web Client Service Anthropic과 통신하는 데 사용할 Web Client Service예요.

관계 (Relationships)

이름 설명
failure Anthropic에서 유효한 응답을 얻지 못하면 원본 FlowFile이 이 관계로 라우팅돼요.
retry Anthropic이 5XX 응답을 반환하면 원본 FlowFile이 이 관계로 라우팅돼요.
success Anthropic의 응답이 이 관계로 라우팅돼요.

쓰기 속성 (Writes attributes)

이름 설명
anthropic.usage.inputTokens 요청에서 읽은 입력 토큰 수예요.
anthropic.usage.outputTokens 응답에서 생성된 출력 토큰 수예요.
anthropic.chat.completion.id 대화에 할당된 고유 ID예요.
anthropic.chat.completion.stop.reason 멈춘 이유예요.
anthropic.chat.completion.stop.sequence 생성된 커스텀 stop sequence가 있다면 그것으로, 없으면 'null'일 수 있어요.
mime.type 응답의 MIME 타입이에요.
filename 응답에 대한 업데이트된 파일 이름이에요.

더 알아보기 (Learn more)