Qdrant
1. Visión General
El add-on Qdrant implementa una instancia de Qdrant, una base de datos vectorial de alto rendimiento. Almacena embeddings (vectores) y ejecuta búsqueda por similitud/semántica sobre ellos.
Úsalo cuando el producto necesita búsqueda vectorial — recuperación para RAG (Retrieval-Augmented Generation), recomendación, deduplicación o cualquier caso que implique indexar y consultar vectores. Para datos relacionales usa PostgreSQL; para clave/valor en memoria, Cache (Valkey).
Tags del catálogo: Database, Vector, AI, Qdrant.
2. Prerrequisitos
- Un squad y un entorno ya seleccionados en la pantalla de Add-ons.
3. Paso a paso del Deploy
El asistente de deploy de Qdrant tiene 2 pasos:
Paso 1 — General
| Campo | Obligatorio | Descripción |
|---|---|---|
| Add-on Name | Sí | Nombre del add-on dentro del entorno. Solo letras minúsculas, números y guiones. Ejemplo: my-qdrant. |
| Admin Public | No | Cuando está activado, el dashboard nativo de Qdrant queda accesible públicamente. Desactivado por defecto (acceso restringido por la plataforma). |
La API key es generada automáticamente por la plataforma en el momento de la creación, almacenada de forma cifrada e inyectada en la instancia — no la defines en el deploy.
Paso 2 — Resources
Define los recursos computacionales asignados a la instancia.
| Campo | Por defecto | Sugerencia/Máximo |
|---|---|---|
| Memory Limit | 1Gi | 2Gi |
| CPU Limit | 500m | 2000m |
| Storage Size | 10Gi | 20Gi |
Al hacer clic en Deploy Add-on, se inicia la implementación. El add-on pasa a aparecer en la pestaña My Add-ons del entorno.
4. Después del Deploy
El panel del add-on en la plataforma ofrece un conjunto reducido de acciones para el día a día, organizado en pestañas:
- Overview — salud de la instancia (estado agregado de las collections), número de collections, points, vectores y vectores indexados.
- Connect — revelar/copiar la API key, exportar la conexión a un secret de la plataforma y rotar la clave (mira abajo).
- Collections — listar, crear (asistente guiado: vectores, distancia, índices de payload), inspeccionar (config + points) y eliminar collections.
- Console — enviar solicitudes REST directas a la instancia para lo que el panel no cubre.
- Settings — recursos (memoria/CPU/almacenamiento — el almacenamiento solo crece) y la visibilidad (Privado/Público) del dashboard nativo.
Además del panel reducido, el dashboard nativo de Qdrant está disponible en el adminUrl del add-on (servido en /dashboard), con el conjunto completo de funcionalidades. Cuando Admin Public está desactivado (por defecto), el acceso está protegido por la sesión de la plataforma.
Conectando un flow a Qdrant
Los Flows se conectan a Qdrant vía gRPC, usando el conector Qdrant. Las credenciales de conexión deben quedar en secrets:
- En la pestaña Connect, usa Export to secret — la plataforma graba
host,port(gRPC),apiKeyyuseTlsen un secret (nuevo o existente). - En el conector del flow, referencia esas propiedades como
{$.env.<secret>.<prop>}.
El export es una conveniencia: también puedes configurar el conector manualmente usando el internalUrl del add-on más la API key.
5. Preguntas frecuentes
¿Cómo accedo a la API key de Qdrant?
En la pestaña Connect del panel, usa Reveal para mostrar y copiar la clave actual, o Export to secret para grabarla (junto con host/puerto) en un secret de la plataforma que tus flows referencian.
¿Qué pasa cuando roto la API key?
La plataforma genera una nueva clave y la instancia pasa a usarla; la clave anterior deja de funcionar inmediatamente. Cualquier secret que ya hayas exportado todavía contiene la clave antigua — vuelve a exportar (o actualiza) ese secret para que los flows sigan conectándose.
¿El add-on hace backup de los datos?
Los backups (snapshots) todavía no son gestionados por el add-on.