当前位置:首页 > 技术 > 正文内容

利用Microsoft.Extensions.AI与VectorData实现向量搜索

访客 技术 2026年6月19日 1

本文演示如何通过Microsoft.Extensions.AI和Microsoft.Extensions.VectorData库构建向量搜索系统,主要步骤如下:

  1. 为数据集生成嵌入向量
  2. 创建并填充向量存储
  3. 将用户查询转换为嵌入向量
  4. 执行相似度搜索并返回结果

初始化项目

创建控制台应用并安装必要依赖:

dotnet new console -o VectorSearchDemo
cd VectorSearchDemo
dotnet add package Microsoft.Extensions.AI.OpenAI --prerelease
dotnet add package Microsoft.Extensions.VectorData.Abstractions
dotnet add package Microsoft.SemanticKernel.Connectors.InMemory --prerelease
dotnet add package Microsoft.Extensions.Configuration
dotnet add package Microsoft.Extensions.Configuration.UserSecrets
dotnet add package System.Linq.AsyncEnumerable

定义数据模型

创建云服务信息实体类:

using Microsoft.Extensions.VectorData;

namespace VectorSearchDemo;

public class CloudServiceEntry
{
    [VectorStoreKey]
    public int Id { get; set; }

    [VectorStoreData]
    public string ServiceName { get; set; }

    [VectorStoreData]
    public string ServiceDesc { get; set; }

    [VectorStoreVector(
        Dimensions: 384,
        DistanceFunction = DistanceFunction.CosineSimilarity)]
    public ReadOnlyMemory<float> VectorData { get; set; }
}

准备数据集

初始化云服务描述数据:

List<CloudServiceEntry> services = new()
{
    new() {
        Id = 0,
        ServiceName = "Azure App Service",
        ServiceDesc = "托管.NET、Java等应用的完全托管服务,自动处理高可用和扩展"
    },
    new() {
        Id = 1,
        ServiceName = "Azure Service Bus",
        ServiceDesc = "企业级消息代理服务,支持点对点和发布订阅模式"
    },
    new() {
        Id = 2,
        ServiceName = "Azure Blob Storage",
        ServiceDesc = "云文件存储服务,支持海量数据存储和高可用架构"
    }
};

配置嵌入生成器

连接OpenAI服务生成嵌入向量:

var config = new ConfigurationBuilder()
    .AddUserSecrets<Program>()
    .Build();

var embeddingGenerator = new OpenAIClient(
    new ApiKeyCredential(config["OpenAIKey"]))
    .GetEmbeddingClient(model: config["ModelName"])
    .AsIEmbeddingGenerator();

构建向量存储

填充向量数据库:

var vectorDb = new InMemoryVectorStore();
var collection = vectorDb.GetCollection<int, CloudServiceEntry>("cloudServices");
await collection.EnsureCollectionExistsAsync();

foreach (var service in services)
{
    service.VectorData = await embeddingGenerator.GenerateVectorAsync(service.ServiceDesc);
    await collection.UpsertAsync(service);
}

执行向量搜索

转换查询并检索结果:

string query = "存储Word文档的最佳服务是什么?";
var queryVector = await embeddingGenerator.GenerateVectorAsync(query);

var matches = collection.SearchAsync(queryVector, top: 3);
await foreach (var match in matches)
{
    Console.WriteLine($"服务: {match.Record.ServiceName}");
    Console.WriteLine($"匹配度: {match.Score:F4}");
}

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。