qdrant-dotnet:官方提供的开源 .NET 客户端库,用于与 Qdrant 向量搜索引擎操作!
2026/6/19 13:40:51 网站建设 项目流程

基于AI开发应用,已经是非常流行了,特别是AI 增强应用(如 RAG)。而开发AI应用,必须用到向量数据库。

Qdrant就是一个开源的向量相似度搜索引擎,专为高效存储、检索和管理高维向量(embeddings)而设计。它不仅支持向量搜索,还允许为每个向量附加结构化元数据(称为 payload),从而实现更灵活、精准的语义搜索和混合检索。

qdrant-dotnet就是Qdrant官方提供的开源 .NET 客户端库,同时也提供Python、Go、JavaScript、Rust 等客户端。

01

项目简介

该客户端库提供了对 Qdrant REST API 和 gRPC 接口的完整封装,主要功能包括:

  1. 向量操作
  • 插入(upsert)、更新、删除向量点(points)

  • 批量导入向量数据

  • 向量搜索
    • 支持多种距离度量(余弦、点积、欧氏距离等)

    • 支持带 payload 过滤条件的语义搜索

    • 支持按 ID 精确检索

  • 集合(Collection)管理
    • 创建、删除、更新集合

    • 配置向量维度、索引类型、存储选项等

  • Payload 操作
    • 为每个向量附加结构化元数据(payload)

    • 支持基于 payload 的过滤(例如{"category": "electronics"}

  • 异步支持
    • 全面使用async/await,适合高并发应用

  • gRPC 支持
    • 除默认的 HTTP/REST 外,也支持更高效的 gRPC 协议(需 Qdrant 服务启用 gRPC)

    02

    使用方法

    1、安装依赖

    dotnet add package Qdrant.Client

    2、保存向量并搜索

    using Qdrant.Client;using Qdrant.Client.Grpc;// 创建客户端var client = new QdrantClient("localhost", port: 6333);// 创建集合await client.CreateCollectionAsync( collectionName: "example", vectorsConfig: new VectorParams { Size = 4, Distance = Distance.Cosine });// 插入向量await client.UpsertAsync( collectionName: "example", points: new[] { new PointStruct { Id = 1, Vectors = new float[] { 0.1f, 0.2f, 0.3f, 0.4f }, Payload = { ["name"] = "item_1" } } });// 搜索var results = await client.SearchAsync( collectionName: "example", queryVector: new float[] { 0.15f, 0.25f, 0.35f, 0.45f }, limit: 3);

    03

    项目地址

    https://github.com/qdrant/qdrant-dotnet

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询