Qdrant
1. Visão Geral
O add-on Qdrant implanta uma instância do Qdrant, um banco de dados vetorial de alto desempenho. Ele armazena embeddings (vetores) e executa busca por similaridade/semântica sobre eles.
Use quando o produto precisa de busca vetorial — recuperação para RAG (Retrieval-Augmented Generation), recomendação, deduplicação ou qualquer caso que envolva indexar e consultar vetores. Para dados relacionais use PostgreSQL; para chave/valor em memória, Cache (Valkey).
Tags do catálogo: Database, Vector, AI, Qdrant.
2. Pré-requisitos
- Um squad e um ambiente já selecionados na tela de Add-ons.
3. Passo a passo do Deploy
O assistente de deploy do Qdrant tem 2 passos:
Passo 1 — General
| Campo | Obrigatório | Descrição |
|---|---|---|
| Add-on Name | Sim | Nome do add-on dentro do ambiente. Apenas letras minúsculas, números e hífens. Exemplo: my-qdrant. |
| Admin Public | Não | Quando ligado, o dashboard nativo do Qdrant fica acessível publicamente. Desligado por padrão (acesso restrito pela plataforma). |
A API key é gerada automaticamente pela plataforma no momento da criação, armazenada de forma criptografada e injetada na instância — você não a define no deploy.
Passo 2 — Resources
Define os recursos computacionais alocados para a instância.
| Campo | Padrão | Sugestão/Máximo |
|---|---|---|
| Memory Limit | 1Gi | 2Gi |
| CPU Limit | 500m | 2000m |
| Storage Size | 10Gi | 20Gi |
Ao clicar em Deploy Add-on, a implantação é iniciada. O add-on passa a aparecer na aba My Add-ons do ambiente.
4. Após o Deploy
O painel do add-on na plataforma oferece um conjunto reduzido de ações para o dia a dia, organizado em abas:
- Overview — saúde da instância (status agregado das collections), número de collections, points, vetores e vetores indexados.
- Connect — revelar/copiar a API key, exportar a conexão para um secret da plataforma e rotacionar a chave (veja abaixo).
- Collections — listar, criar (assistente guiado: vetores, distância, índices de payload), inspecionar (config + points) e deletar collections.
- Console — enviar requisições REST diretas à instância para o que o painel não cobre.
- Settings — recursos (memória/CPU/armazenamento — o armazenamento só cresce) e a visibilidade (Privado/Público) do dashboard nativo.
Além do painel reduzido, o dashboard nativo do Qdrant está disponível no adminUrl do add-on (servido em /dashboard), com o conjunto completo de recursos. Quando Admin Public está desligado (padrão), o acesso é protegido pela sessão da plataforma.
Conectando um flow ao Qdrant
Flows se conectam ao Qdrant via gRPC, usando o conector Qdrant. As credenciais de conexão devem ficar em secrets:
- Na aba Connect, use Export to secret — a plataforma grava
host,port(gRPC),apiKeyeuseTlsem um secret (novo ou existente). - No conector do flow, referencie essas propriedades como
{$.env.<secret>.<prop>}.
O export é uma conveniência: você também pode configurar o conector manualmente usando o internalUrl do add-on mais a API key.
5. Perguntas frequentes
Como acesso a API key do Qdrant?
Na aba Connect do painel, use Reveal para exibir e copiar a chave atual, ou Export to secret para gravá-la (junto com host/porta) em um secret da plataforma que seus flows referenciam.
O que acontece quando eu rotaciono a API key?
A plataforma gera uma nova chave e a instância passa a usá-la; a chave antiga para de funcionar imediatamente. Qualquer secret que você já tenha exportado ainda contém a chave antiga — re-exporte (ou atualize) esse secret para que os flows continuem se conectando.
O add-on faz backup dos dados?
Backups (snapshots) ainda não são gerenciados pelo add-on.