当前位置：首页 >专题 >Go Qdrant 向量检索与 RAG 工程实践专题

Go Qdrant 向量检索与 RA

Go Qdrant 向量检索与 RAG 工程实践专题

从 Go SDK、集合与向量写入到过滤、混合检索和 RAG 评估

RAG 项目真正难的不是把向量写进数据库，而是让检索结果可过滤、可解释、可删除、可评估。本专题以 Qdrant 官方资料和 Go client 为主线，精选站内真实文章，串起文档切片、embedding 维度、集合与 payload、硬过滤、混合召回、rerank、引用回链和知识库更新的工程闭环。

Qdrant 官网、API 与 Go SDK

先掌握集合、搜索、客户端、Cloud 和安全边界

官方

Qdrant 官方文档总览

Qdrant 向量搜索、集合、payload、索引、检索、Inference 和 Cloud 的官方入口。

官方

Qdrant 本地 Quickstart

用本地实例完成集合、向量写入、查询和官方客户端接入。

官方

Qdrant 官方 Go client

Qdrant 维护的 Go client，提供集合、upsert、query、payload 和 gRPC 客户端能力。

官方

Qdrant Cloud Quickstart

介绍 Cloud 集群、URL、API key 和官方 SDK 连接方式。

官方

Qdrant API 与 SDK 接口总览

列出 REST API、gRPC 和各语言官方客户端，包括 Go client 安装入口。

官方

Qdrant 集合与向量配置

解释 collection、向量尺寸、距离度量、分片、复制和集合生命周期。

官方

Qdrant 搜索与查询

覆盖相似度查询、过滤、score threshold、payload 和搜索策略。

官方

Qdrant 安全文档

介绍 API key、TLS、网络绑定、只读权限和审计等部署安全措施。

站内 Go RAG 检索工程路径

从数据准备推进到召回、过滤、重排、更新与质量评估

文章

RAG 文档切片为什么要保留标题路径：用 Go 生成可追溯检索片段

用 Go 将标题路径、片段编号和来源锚点写入可追溯的 Chunk。

文章

向量检索为什么召回为空：embedding 维度与归一化的排查链

排查向量维度、归一化和余弦相似度导致的空召回。

文章

向量检索怎么按租户和文档类型过滤结果

使用 Qdrant payload、must 条件和 payload index 做租户与文档类型过滤。

文章

Embedding 向量维度改了为何不能直接复用索引：模型切换、迁移双写与回滚

讨论模型切换时的维度、距离、双写、切流和回滚验收。

文章

向量数据库召回分数怎么设阈值：Go 中用候选分层避免低相关答案

在 Go 检索链中拆分候选召回、分数阈值、过滤和生成兜底。

文章

向量检索过滤条件和 rerank 顺序如何安排

先执行租户、权限、状态和有效期硬过滤，再召回、重排和阈值收口。

文章

Qdrant 删除文档后为何仍被召回：wait、索引可见性与缓存失效的排查

排查 Qdrant 删除请求、wait、索引可见性、复制和应用缓存造成的旧结果。

文章

RAG 混合检索结果重复时怎么做去重和排序

按文档与分块身份合并关键词检索和向量检索结果，并稳定排序。

文章

RAG 检索结果太多时怎么用 reranker 控制上下文长度

将扩大召回、rerank 和 token 预算裁剪拆成三层。

文章

知识库文档删除后怎么同步清理向量数据

以 doc_id 和版本字段串起业务删除、Qdrant 清理与异步重建失效。

文章

RAG 检索结果为什么要保留来源：从召回片段到答案引用的接口设计

设计带 source_id、chunk_id、locator 和 score 的 Go 检索结果接口。

文章

RAG 召回评估实战：用向量检索和重排序减少答非所问

用固定问题集和 Recall@K、MRR、nDCG 评估切片、召回和重排。

Qdrant 与 RAG 上线前常见问题

用四个判断题收口安全、维度、过滤和更新边界

Qdrant collection 的向量维度可以随意修改吗？

不能直接修改已写入集合的向量维度。模型切换通常需要新集合或双写迁移，同时核对距离度量、空值率、召回样本和回滚读路径。

租户权限应该放在向量相似度还是 payload filter？

租户、权限、状态和有效期属于硬边界，应使用结构化 payload filter 在召回入口收紧；相似度和 rerank 只负责可访问候选中的相关性排序。

Qdrant 删除返回成功后为什么还能搜到旧文档？

写操作被接收不等于索引和副本已经可见。根据一致性要求使用 wait、检查集合状态和查询结果，并清理应用缓存、让旧版本异步任务失效。

Go Qdrant 服务如何避免把低质量候选直接交给模型？

保留略大的候选集，先做硬过滤和去重，再用 reranker、score threshold、上下文 token 预算和引用检查收口；候选不足时返回可识别的无依据或澄清状态。