如何使用Azure OpenAI .NET SDK为助手关联Vector store？

核心解决步骤 #

直接给助手关联文件存在20个上限，正确做法是将Vector Store关联到**线程（Thread）**而非助手本身，以此利用向量库的检索能力，摆脱文件数量限制。

1. 初始化客户端 #

先确保正确初始化Azure OpenAI Assistants客户端：

using Azure;
using Azure.AI.OpenAI.Assistants;

var client = new OpenAIAssistantsClient(
    new Uri("你的Azure OpenAI端点"),
    new AzureKeyCredential("你的API密钥"));

2. 关联Vector Store到线程 #

有两种方式完成关联：

方式一：创建新线程时直接关联

// 定义Vector Store引用
var vectorStoreRef = new VectorStoreReference("你的Vector Store ID");

// 创建线程并绑定Vector Store
var createThreadOpts = new CreateThreadOptions
{
    ToolResources = new ToolResources
    {
        VectorStores = { vectorStoreRef }
    }
};

Response<Thread> threadResp = await client.CreateThreadAsync(createThreadOpts);
Thread thread = threadResp.Value;

方式二：给已有线程添加Vector Store

如果线程已存在，可通过更新操作绑定：

var updateThreadOpts = new UpdateThreadOptions
{
    ToolResources = new ToolResources
    {
        VectorStores = { new VectorStoreReference("你的Vector Store ID") }
    }
};

Response<Thread> updatedThread = await client.UpdateThreadAsync("你的线程ID", updateThreadOpts);

3. 确保助手启用检索工具 #

需确认你的Assistant已开启file_search工具：

• 在Azure门户创建Assistant时，在工具选项勾选「文件搜索」
• 或通过SDK更新Assistant配置：

var updateAssistantOpts = new UpdateAssistantOptions
{
    Tools = { new FileSearchToolDefinition() }
};

await client.UpdateAssistantAsync("你的Assistant ID", updateAssistantOpts);

4. 运行线程触发检索 #

添加用户消息并启动线程，助手会自动调用关联的Vector Store进行检索：

// 向线程添加用户查询
await client.CreateMessageAsync(thread.Id, MessageRole.User, "请帮我查找XX相关内容");

// 启动线程运行
var runOpts = new CreateRunOptions
{
    AssistantId = "你的Assistant ID"
};

Response<Run> runResp = await client.CreateRunAsync(thread.Id, runOpts);
Run run = runResp.Value;

关键注意点 #

• 避免直接给助手绑定文件，通过线程关联Vector Store可突破20个文件的限制，因为Vector Store可存储大量文件的向量索引数据。
• 确保Vector Store中已完成文件上传与向量索引构建（可通过Azure门户或SDK操作）。

内容的提问来源于stack exchange，提问作者TechEnthusiast