SetFN
SetFNDocs27 de octubre de 2026

Preparar un servidor Qdrant

Para seleccionar Qdrant en Almacenamiento de conocimiento, primero necesita un servidor accesible. SetFN no lo instala automáticamente; esta guía explica cómo prepararlo con Docker.

Antes de comenzar

  • Para guardar la conexión en SetFN necesita permiso de administrador de Workspace.
  • Necesita un entorno Linux, como Ubuntu, con privilegios sudo.
  • Instale Docker si aún no está disponible.
  • El servidor de SetFN debe poder acceder por red a Qdrant.

Instalar Docker

Procedimiento oficial para Ubuntu. Omítalo si ya está instalado.

1. Actualizar el índice e instalar paquetes

sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

2. Añadir el repositorio de Docker a Apt

sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

3. Instalar los paquetes de Docker

sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Ejecutar el contenedor de Qdrant

1. Crear docker-compose.yml

Cree docker-compose.yml en la carpeta donde ejecutará Qdrant.

services:
  qdrant:
    image: qdrant/qdrant:latest
    container_name: qdrant
    restart: unless-stopped
    ports:
      - "6333:6333"
      - "6334:6334"
    volumes:
      - ./qdrant_storage:/qdrant/storage

2. Ejecutar el contenedor

sudo docker compose up -d
  • image: imagen y versión. latest cambia al volver a descargar; en producción, fije una versión validada de Qdrant Releases. Puede sustituir la ruta por un registro interno.
  • container_name y ./qdrant_storage: son ejemplos y pueden cambiarse.
  • 6333: puerto de la API REST.
  • 6334: puerto gRPC. Utiliza protobuf y puede ser más rápido en cargas masivas o búsquedas por lotes. SetFN admite gRPC y lo utiliza preferentemente.

Conectar SetFN

Introduzca los siguientes valores en Vector DB Setup, dentro de Knowledge Storage, y seleccione Save. Consulte Almacenamiento de conocimiento para conocer los demás ajustes.

Configuración del controlador Qdrant

CampoValor
DriverQdrant
CollectionNombre propio y distinto para cada instancia
REST endpointDirección REST, por ejemplo http://localhost:6333
gRPC endpointDirección gRPC recomendada de la misma instancia, por ejemplo http://localhost:6334. Si queda vacío y REST usa 6333, se prueba 6334; si falla, se usa REST.
API keySolo si activó la autenticación. Vacío significa sin autenticación y al guardar vacío se elimina el valor anterior.

La conexión es correcta cuando Vector DB Overview muestra Connected y el almacén indica Qdrant.

Documentos relacionados