Qdrant é um banco de dados vetorial open-source projetado para armazenamento, gerenciamento e recuperação eficientes de embeddings vetoriais de alta dimensionalidade. O Qdrant possibilita busca semântica rápida e escalável, sendo ideal para aplicações de IA que exigem similarity search, sistemas de recomendação e recuperação contextual de informações.
Com o Qdrant, você pode:
- Armazenar embeddings vetoriais: Gerenciar e persistir vetores de alta dimensionalidade em escala com eficiência
- Executar busca por similaridade semântica: Encontrar os vetores mais similares a um vetor de consulta em tempo real
- Filtrar e organizar dados: Usar filtragem avançada para restringir resultados com base em metadados ou payload
- Buscar pontos específicos: Recuperar vetores e seus payloads associados por ID
- Escalar com transparência: Lidar com coleções grandes e cargas de alto throughput
Na Zoen, a integração do Qdrant permite que seus agentes interajam com o Qdrant de forma programática como parte dos seus fluxos. As operações suportadas incluem:
- Upsert: Inserir ou atualizar points (vetores e payloads) em uma collection do Qdrant
- Search: Executar similarity search para encontrar vetores mais similares a um vetor de consulta, com filtragem opcional e personalização de resultados
- Fetch: Recuperar points específicos de uma collection pelos seus IDs, com opções para incluir payloads e vetores
Esta integração permite que seus agentes aproveitem capacidades poderosas de busca e gerenciamento vetorial, habilitando cenários avançados de automação como busca semântica, recomendação e recuperação contextual. Ao conectar a Zoen ao Qdrant, você pode construir agentes que entendem contexto, recuperam informações relevantes de grandes datasets e entregam respostas mais inteligentes e personalizadas — tudo sem gerenciar infraestrutura complexa.
Usage Instructions
Integrate Qdrant into the workflow. Can 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 |