QueryPinecone
QueryPinecone
입력 벡터와 유사한 벡터를 Pinecone에서 쿼리하거나, ID로 벡터를 검색하는 OpenFlow 프로세서예요. 임베딩 기반 검색/추천 시나리오에 자주 쓰여요.
출처: Snowflake 문서
본문
번들 (Bundle)
com.snowflake.openflow.runtime | runtime-pinecone-nar
설명 (Description)
입력 벡터와 유사한 벡터를 Pinecone에서 쿼리하거나, ID로 벡터를 검색합니다.
태그 (Tags)
chatbot, gen ai, generative ai, llm, openflow, pinecone, query, similarity, vector
입력 요구사항 (Input Requirement)
REQUIRED
민감 동적 속성 지원 (Supports Sensitive Dynamic Properties)
false
속성 (Properties)
| 속성 (Property) | 설명 (Description) |
|---|---|
| ID Record Path | 레코드에서 ID 필드로 가는 경로입니다. |
| Include Metadata | 결과에 메타데이터를 포함할지 여부를 지정합니다. |
| Include Vectors | 결과에 벡터를 포함할지 여부를 지정합니다. |
| Number of Results | 반환할 결과 수입니다(예: Top K). |
| Pinecone API Key | Pinecone 서비스의 API 키입니다. |
| Pinecone Index | 사용할 Pinecone 인덱스의 이름입니다. |
| Pinecone Namespace | 사용할 Pinecone 네임스페이스의 이름입니다. |
| Query Filter | 사용할 쿼리 필터의 JSON 표현입니다. |
| Query Strategy | Pinecone을 쿼리하는 데 사용할 전략입니다. |
| Record Reader | FlowFile을 읽는 데 사용할 Record Reader입니다. |
| Record Writer | 결과를 쓰는 데 사용할 Record Writer입니다. |
| Results Record Path | 레코드의 어느 위치에 결과를 둘지 지정합니다. |
| Sparse Dense Vector Weighting | 0.0에서 1.0 사이입니다. 하이브리드 검색 시 밀집 및 희소 벡터에 적용할 가중치입니다. (1 - weight)는 희소 벡터 값에, (weight)는 밀집 벡터에 적용됩니다. |
| Sparse Vector Indices Path | 희소 벡터가 제공되는 경우, 이 RecordPath는 사용할 희소 데이터의 인덱스를 가리킵니다. |
| Sparse Vector Values Path | 희소 벡터가 제공되는 경우, 이 RecordPath는 사용할 희소 데이터의 값을 가리킵니다. |
| Vector Record Path | 레코드에서 벡터 필드로 가는 경로입니다. |
| Web Client Service | Pinecone과 통신하는 데 사용할 Web Client Service입니다. |
관계 (Relationships)
| 이름 (Name) | 설명 (Description) |
|---|---|
| failure | Pinecone으로 보낼 수 없고 재시도가 성공할 것으로 기대되지 않는 FlowFile이 이 관계로 라우팅됩니다. |
| retry | Pinecone으로 보내지 못했지만 재시도가 도움이 될 수 있는 FlowFile이 이 관계로 라우팅됩니다. |
| success | Pinecone으로 성공적으로 보내진 FlowFile이 이 관계로 라우팅됩니다. |
다른 구성 요소와 함께 쓰는 사용 사례 (Use Cases Involving Other Components)
- 어떤 입력 텍스트와 유사한 벡터를 Pinecone에서 쿼리합니다.