Actions11
Overview
This node provides advanced integration with the Qdrant vector search engine, enabling full control over collections and points through the Qdrant API. It supports operations such as creating, updating, deleting collections, managing points (upsert, update, delete, retrieve), searching points by vector similarity, counting points, and listing collections.
Typical use cases include:
- Creating and configuring new vector collections for storing embeddings.
- Managing data points within collections, including batch upserts and updates.
- Performing similarity searches on vector data to find nearest neighbors.
- Retrieving metadata about collections or specific points.
- Deleting collections or points when no longer needed.
For example, a user can create a new collection with custom configuration, then upsert embedding vectors representing documents, and later perform similarity searches to find related documents based on query embeddings.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform on Qdrant. Options: Count Points, Create Collection, Delete Collection, Delete Points, Get Collection Info, Get Points by IDs, List Collections, Search Points, Update Collection, Update Points, Upsert Points. |
| Collection Name | The name of the Qdrant collection to operate on. Supports expressions. |
| Collection Config (JSON) | Raw JSON configuration for the collection (e.g., vectors config, replication factor). Required for creating or updating collections. Supports expressions. |
| Point IDs (JSON Array) | Array of point IDs (e.g., [1,2,3]) used for retrieving or deleting points. Supports expressions. |
| Points (JSON Array) | Array of point objects with structure { ID, vector: [...], payload: {...} } used for upserting or updating points. Supports expressions. |
| Search Vector (JSON Array) | Embedding vector array used to perform similarity search against stored points. If left blank, incoming data is used. Supports expressions. |
| Filter (JSON) | JSON filter object to narrow down search or count queries. Supports expressions. |
| Limit | Maximum number of results to return in search operations. Must be at least 1. |
Output
The node outputs an array of JSON objects corresponding to the result of the selected operation:
- For collection operations (
createCollection,updateCollection,getCollection,listCollections,deleteCollection), the output contains the response from Qdrant about the collection status or success confirmation. - For point operations (
getPoints,deletePoints,upsertPoints,updatePoints), the output includes details about the affected points or operation success. - For
searchPoints, the output contains search results with matched points and their similarity scores. - For
countPoints, the output returns the count of points matching the filter criteria.
The node does not output binary data; all outputs are JSON structured responses from the Qdrant API.
Dependencies
- Requires access to a Qdrant instance via its REST API.
- Needs an API key credential for authentication with Qdrant.
- Uses the official Qdrant JavaScript client library (
@qdrant/js-client-rest). - Requires proper configuration of the Qdrant API URL and API key in the node credentials.
Troubleshooting
- Missing Collection Name: Operations require a collection name; ensure this property is set and not empty.
- Invalid or Missing Collection Config: For create or update collection operations, a valid JSON config must be provided.
- Point IDs or Points Missing: For operations involving points (get, delete, upsert, update), ensure the respective JSON arrays are correctly specified.
- Search Vector Missing or Invalid: The search operation requires a valid embedding vector and a limit ≥ 1.
- JSON Parsing Errors: Input properties accepting JSON may throw errors if the JSON is malformed. Validate JSON syntax before execution.
- API Errors: Network issues, invalid API keys, or incorrect Qdrant URLs will cause API errors. Verify credentials and endpoint accessibility.
- Unsupported Operation: Selecting an operation not listed will throw an error.