Use cases and templates: Qdrant integration for AI agents
Use Qdrant in Sim to upsert points, search for similar vectors with optional payload filters, and fetch points by ID. Points contain vectors and associated payload data; fetch and search options control which fields are returned.
Use the block
Upsert, search, and fetch points.
Actions
Qdrant Upsert Points
Insert or update points in a Qdrant collection
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Qdrant instance URL (e.g., https://your-cluster.qdrant.io) |
apiKey | string | No | Qdrant API key for authentication |
collection | string | Yes | Collection name for upsert (e.g., "my_collection") |
points | array | Yes | Array of points to upsert |
Output
| Parameter | Type | Description |
|---|---|---|
status | string | Operation status (ok, error) |
data | object | Result data from the upsert operation |
↳ operation_id | number | Operation ID for async tracking |
↳ status | string | Operation status (acknowledged, completed) |
Qdrant Search Vector
Search for similar vectors in a Qdrant collection
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Qdrant instance URL (e.g., https://your-cluster.qdrant.io) |
apiKey | string | No | Qdrant API key for authentication |
collection | string | Yes | Collection name to search (e.g., "my_collection") |
vector | array | Yes | Query vector for similarity search (e.g., [0.1, 0.2, 0.3, ...]) |
limit | number | No | Maximum number of results to return (e.g., 10) |
filter | object | No | Qdrant filter object (e.g., {"must": [{"key": "field", "match": {"value": "val"}}]}) |
search_return_data | string | No | Data to return from search |
with_payload | boolean | No | Include payload in response |
with_vector | boolean | No | Include vector in response |
Output
| Parameter | Type | Description |
|---|---|---|
status | string | Operation status (ok, error) |
data | array | Vector search results with ID, score, payload, and optional vector data |
↳ id | string | Point ID (integer or UUID string) |
↳ version | number | Point version number |
↳ score | number | Similarity score |
↳ payload | json | Point payload data (key-value pairs) |
↳ vector | json | Point vector(s) - single array or named vectors object |
↳ shard_key | string | Shard key for routing |
↳ order_value | number | Order value for sorting |
Qdrant Fetch Points
Fetch points by ID from a Qdrant collection
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
url | string | Yes | Qdrant instance URL (e.g., https://your-cluster.qdrant.io) |
apiKey | string | No | Qdrant API key for authentication |
collection | string | Yes | Collection name to fetch from (e.g., "my_collection") |
ids | array | Yes | Array of point IDs to fetch (e.g., ["id1", "id2"] or [1, 2]) |
fetch_return_data | string | No | Data to return from fetch |
with_payload | boolean | No | Include payload in response |
with_vector | boolean | No | Include vector in response |
Output
| Parameter | Type | Description |
|---|---|---|
status | string | Operation status (ok, error) |
data | array | Fetched points with ID, payload, and optional vector data |
↳ id | string | Point ID (integer or UUID string) |
↳ payload | json | Point payload data (key-value pairs) |
↳ vector | json | Point vector(s) - single array or named vectors object |
↳ shard_key | string | Shard key for routing |
↳ order_value | number | Order value for sorting |