Aller au contenu principal

Retrieve

Category: RAG
Node id: retrieve

Performs vector similarity search and retrieval from Qdrant collections with filtering and score thresholds

What it does​

  • Vector similarity search against Qdrant collections
  • Configurable top-K result retrieval
  • Minimum score threshold filtering
  • Qdrant filter conditions for metadata-based narrowing
  • Automatic Qdrant client initialization from config

Use cases​

  • Retrieving relevant documents for RAG pipelines
  • Semantic search across clinical knowledge bases
  • Finding similar patient records by embedding similarity

Runtime​

  • Performance tier: fast

Input ports​

NameTypeRequiredDescription
query_vectorjsonYesQuery embedding vector ([]float32 or []interface{})

Output ports​

NameTypeRequiredDescription
resultjsonNoMain result containing results array, count, collection, top_k, min_score, and total_results
successbooleanNoWhether the operation succeeded

Settings​

Basic​

SettingNameTypeRequiredDefaultAllowed valuesDescription
CollectioncollectionstringYesQdrant collection name
Top Ktop_knumberNo5min 1; max 100Number of results to retrieve
Min Scoremin_scorenumberNo0min 0; max 1Minimum similarity score threshold
Qdrant URLqdrant_urlstringNohttp://localhost:6333Qdrant server URL

Auth​

SettingNameTypeRequiredDefaultAllowed valuesDescription
API Keyapi_keysecretNoQdrant API key

Advanced​

SettingNameTypeRequiredDefaultAllowed valuesDescription
FilterfilterjsonNoQdrant filter conditions

Errors​

CodeDescription
COLLECTION_REQUIREDCollection name is not configured
VECTOR_REQUIREDNo query_vector input was provided
INVALID_VECTORquery_vector has invalid element types
SEARCH_FAILEDQdrant vector search request failed

Runtime notes​

  • total_results is the raw count before min_score filtering; count is after filtering
  • query_vector must match the dimensionality of the target Qdrant collection
  • Wire result.results to a rerank node's results input for two-stage retrieval
  • If qdrant_url is not set in config, defaults to http://localhost:6333

See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.

Quelque chose n'est pas clair ? Envoyez vos commentaires sur la documentation par courriel.