Convex Agents RAG：为智能体集成RAG，实现基于知识库的精准回答，减少幻觉

🇨🇳中文介绍

目的

使智能体能够搜索自定义内容和知识库，以提供准确、基于上下文的回答。RAG 结合了大型语言模型（LLM）的能力与语义搜索。

使用场景

• 智能体需要引用知识库或文档集合
• 将答案基于特定数据（政策、产品文档等）
• 跨自定义内容进行语义搜索
• 构建搜索 + 生成系统（常见问题解答、文档、支持）
• 通过将回答限制在已知信息中来减少幻觉
• 管理用户特定或团队特定的知识命名空间

设置

在您的 convex.config.ts 中安装并配置 RAG：

import { defineApp } from "convex/server";
import agent from "@convex-dev/agent/convex.config";
import rag from "@convex-dev/rag/convex.config";

const app = defineApp();
app.use(agent);
app.use(rag);

export default app;

添加内容

将文档摄取到命名空间中：

import { rag } from "@convex-dev/rag";

export const addContent = action({
  args: { userId: v.string(), key: v.string(), text: v.string() },
  handler: async (ctx, { userId, key, text }) => {
    const namespace = `user:${userId}`;
    await rag.addContent(ctx, components.rag, {
      namespace,
      key,
      text,
      filters: { filterNames: [filename] },
    });
  },
});

搜索与生成

与智能体一起使用 RAG：

export const answerWithContext = action({
  args: { threadId: v.string(), userId: v.string(), question: v.string() },
  handler: async (ctx, { threadId, userId, question }) => {
    const { thread } = await myAgent.continueThread(ctx, { threadId });

    const context = await rag.search(ctx, components.rag, {
      namespace: `user:${userId}`,
      query: question,
      limit: 10,
    });

    const augmentedPrompt = `# Context:\n\n${context.text}\n\n# Question:\n\n${question}`;
    const result = await thread.generateText({ prompt: augmentedPrompt });

    return result.text;
  },
});

关键原则

• 命名空间隔离数据：使用 user:userId 或 team:teamId 以确保多租户安全
• 混合搜索：结合文本和向量搜索以获得更好的结果
• 过滤：使用 filterNames 来定位特定文档

后续步骤

• 查看 基础 了解基本的智能体设置
• 查看 上下文 了解高级上下文自定义

每周安装次数

–

来源

smithery.ai/ski…ents-rag

首次出现

–

import { defineApp } from "convex/server";
import agent from "@convex-dev/agent/convex.config";
import rag from "@convex-dev/rag/convex.config";

const app = defineApp();
app.use(agent);
app.use(rag);

export default app;

import { rag } from "@convex-dev/rag";

export const addContent = action({
  args: { userId: v.string(), key: v.string(), text: v.string() },
  handler: async (ctx, { userId, key, text }) => {
    const namespace = `user:${userId}`;
    await rag.addContent(ctx, components.rag, {
      namespace,
      key,
      text,
      filters: { filterNames: [filename] },
    });
  },
});