diff --git a/packages/service/core/ai/functions/queryExtension.ts b/packages/service/core/ai/functions/queryExtension.ts index 50684f9e6bc1..812b31cca4d2 100644 --- a/packages/service/core/ai/functions/queryExtension.ts +++ b/packages/service/core/ai/functions/queryExtension.ts @@ -3,21 +3,173 @@ import { createChatCompletion } from '../config'; import { type ChatItemType } from '@fastgpt/global/core/chat/type'; import { countGptMessagesTokens, countPromptTokens } from '../../../common/string/tiktoken/index'; import { chats2GPTMessages } from '@fastgpt/global/core/chat/adapt'; -import { getLLMModel } from '../model'; +import { getLLMModel, getEmbeddingModel } from '../model'; +import { getVectorsByText } from '../../ai/embedding'; import { llmCompletionsBodyFormat, formatLLMResponse } from '../utils'; import { addLog } from '../../../common/system/log'; import { filterGPTMessageByMaxContext } from '../../chat/utils'; import json5 from 'json5'; /* - query extension - 问题扩展 - 可以根据上下文,消除指代性问题以及扩展问题,利于检索。 + Query Extension - Semantic Search Enhancement + + This module can eliminate referential ambiguity and expand queries based on context to improve retrieval. + + Submodular Optimization Mode: Generate multiple candidate queries, then use submodular algorithm to select the optimal query combination */ +// Priority Queue implementation for submodular optimization +class PriorityQueue { + private heap: Array<{ item: T; priority: number }> = []; + + enqueue(item: T, priority: number): void { + this.heap.push({ item, priority }); + this.heap.sort((a, b) => b.priority - a.priority); + } + + dequeue(): T | undefined { + return this.heap.shift()?.item; + } + + isEmpty(): boolean { + return this.heap.length === 0; + } + + size(): number { + return this.heap.length; + } +} + +// Calculate cosine similarity +function cosineSimilarity(a: number[], b: number[]): number { + if (a.length !== b.length) { + throw new Error('Vectors must have the same length'); + } + + let dotProduct = 0; + let normA = 0; + let normB = 0; + + for (let i = 0; i < a.length; i++) { + dotProduct += a[i] * b[i]; + normA += a[i] * a[i]; + normB += b[i] * b[i]; + } + + if (normA === 0 || normB === 0) return 0; + return dotProduct / (Math.sqrt(normA) * Math.sqrt(normB)); +} + +// Calculate marginal gain +function computeMarginalGain( + candidateEmbedding: number[], + selectedEmbeddings: number[][], + originalEmbedding: number[], + alpha: number = 0.3 +): number { + if (selectedEmbeddings.length === 0) { + return alpha * cosineSimilarity(originalEmbedding, candidateEmbedding); + } + + let maxSimilarity = 0; + for (const selectedEmbedding of selectedEmbeddings) { + const similarity = cosineSimilarity(candidateEmbedding, selectedEmbedding); + maxSimilarity = Math.max(maxSimilarity, similarity); + } + + const relevance = alpha * cosineSimilarity(originalEmbedding, candidateEmbedding); + const diversity = 1 - maxSimilarity; + + return relevance + diversity; +} + +// Lazy greedy query selection algorithm +function lazyGreedyQuerySelection( + candidates: string[], + embeddings: number[][], + originalEmbedding: number[], + k: number, + alpha: number = 0.3 +): string[] { + const n = candidates.length; + const selected: string[] = []; + const selectedEmbeddings: number[][] = []; + + // Initialize priority queue + const pq = new PriorityQueue<{ index: number; gain: number }>(); + + // Calculate initial marginal gain for all candidates + for (let i = 0; i < n; i++) { + const gain = computeMarginalGain(embeddings[i], selectedEmbeddings, originalEmbedding, alpha); + pq.enqueue({ index: i, gain }, gain); + } + + // Greedy selection + for (let iteration = 0; iteration < k; iteration++) { + if (pq.isEmpty()) break; + + let bestCandidate: { index: number; gain: number } | undefined; + + // Find candidate with maximum marginal gain + while (!pq.isEmpty()) { + const candidate = pq.dequeue()!; + const currentGain = computeMarginalGain( + embeddings[candidate.index], + selectedEmbeddings, + originalEmbedding, + alpha + ); + + if (currentGain >= candidate.gain) { + bestCandidate = { index: candidate.index, gain: currentGain }; + break; + } else { + pq.enqueue(candidate, currentGain); + } + } + + if (bestCandidate) { + selected.push(candidates[bestCandidate.index]); + selectedEmbeddings.push(embeddings[bestCandidate.index]); + } + } + + return selected; +} + +// Generate embeddings for input texts +async function generateEmbeddings(texts: string[], model: string): Promise { + try { + const vectorModel = getEmbeddingModel(model); + const embeddings: number[][] = []; + + for (const text of texts) { + // Use vector model's createEmbedding method + const embedding = await getVectorsByText({ + model: vectorModel, + input: text, + type: 'query' + }); + embeddings.push(embedding.vectors[0]); + } + + return embeddings; + } catch (error) { + addLog.warn('Failed to generate embeddings', { error, model }); + throw error; + } +} + const title = global.feConfigs?.systemTitle || 'FastAI'; const defaultPrompt = `## 你的任务 -你作为一个向量检索助手,你的任务是结合历史记录,从不同角度,为“原问题”生成个不同版本的“检索词”,从而提高向量检索的语义丰富度,提高向量检索的精度。 -生成的问题要求指向对象清晰明确,并与“原问题语言相同”。 +你作为一个向量检索助手,你的任务是结合历史记录,为"原问题"生成{{count}}个不同版本的"检索词"。这些检索词应该从不同角度探索主题,以提高向量检索的语义丰富度和精度。 + +## 要求 +1. 每个检索词必须与原问题相关 +2. 检索词应该探索不同方面(例如:原因、影响、解决方案、示例、对比等) +3. 避免检索词之间的冗余 +4. 保持检索词简洁且可搜索 +5. 生成的问题要求指向对象清晰明确,并与"原问题语言相同" ## 参考示例 @@ -26,7 +178,7 @@ const defaultPrompt = `## 你的任务 null """ 原问题: 介绍下剧情。 -检索词: ["介绍下故事的背景。","故事的主题是什么?","介绍下故事的主要人物。"] +检索词: ["介绍下故事的背景。","故事的主题是什么?","介绍下故事的主要人物。","故事的转折点在哪里?","故事的结局如何?"] ---------------- 历史记录: """ @@ -34,7 +186,7 @@ user: 对话背景。 assistant: 当前对话是关于 Nginx 的介绍和使用等。 """ 原问题: 怎么下载 -检索词: ["Nginx 如何下载?","下载 Nginx 需要什么条件?","有哪些渠道可以下载 Nginx?"] +检索词: ["Nginx 如何下载?","下载 Nginx 需要什么条件?","有哪些渠道可以下载 Nginx?","Nginx 各版本的下载方式有什么区别?","如何选择合适的 Nginx 版本下载?"] ---------------- 历史记录: """ @@ -44,7 +196,7 @@ user: 报错 "no connection" assistant: 报错"no connection"可能是因为…… """ 原问题: 怎么解决 -检索词: ["Nginx报错"no connection"如何解决?","造成'no connection'报错的原因。","Nginx提示'no connection',要怎么办?"] +检索词: ["Nginx报错'no connection'如何解决?","造成'no connection'报错的原因。","Nginx提示'no connection',要怎么办?","'no connection'错误的常见解决步骤。","如何预防 Nginx 'no connection' 错误?"] ---------------- 历史记录: """ @@ -52,7 +204,7 @@ user: How long is the maternity leave? assistant: The number of days of maternity leave depends on the city in which the employee is located. Please provide your city so that I can answer your questions. """ 原问题: ShenYang -检索词: ["How many days is maternity leave in Shenyang?","Shenyang's maternity leave policy.","The standard of maternity leave in Shenyang."] +检索词: ["How many days is maternity leave in Shenyang?","Shenyang's maternity leave policy.","The standard of maternity leave in Shenyang.","What benefits are included in Shenyang's maternity leave?","How to apply for maternity leave in Shenyang?"] ---------------- 历史记录: """ @@ -60,7 +212,7 @@ user: 作者是谁? assistant: ${title} 的作者是 labring。 """ 原问题: Tell me about him -检索词: ["Introduce labring, the author of ${title}." ," Background information on author labring." "," Why does labring do ${title}?"] +检索词: ["Introduce labring, the author of ${title}." ,"Background information on author labring.","Why does labring do ${title}?","What other projects has labring worked on?","How did labring start ${title}?"] ---------------- 历史记录: """ @@ -76,7 +228,7 @@ user: ${title} 如何收费? assistant: ${title} 收费可以参考…… """ 原问题: 你知道 laf 么? -检索词: ["laf 的官网地址是多少?","laf 的使用教程。","laf 有什么特点和优势。"] +检索词: ["laf 的官网地址是多少?","laf 的使用教程。","laf 有什么特点和优势。","laf 的主要功能是什么?","laf 与其他类似产品的对比。"] ---------------- 历史记录: """ @@ -102,6 +254,7 @@ assistant: Laf 是一个云函数开发平台。 1. 输出格式为 JSON 数组,数组中每个元素为字符串。无需对输出进行任何解释。 2. 输出语言与原问题相同。原问题为中文则输出中文;原问题为英文则输出英文。 +3. 确保生成恰好 {{count}} 个检索词。 ## 开始任务 @@ -116,12 +269,14 @@ export const queryExtension = async ({ chatBg, query, histories = [], - model + model, + generateCount = 10 // 添加生成数量参数,默认为10个 }: { chatBg?: string; query: string; histories: ChatItemType[]; model: string; + generateCount?: number; }): Promise<{ rawQuery: string; extensionQueries: string[]; @@ -162,7 +317,8 @@ assistant: ${chatBg} role: 'user', content: replaceVariable(defaultPrompt, { query: `${query}`, - histories: concatFewShot || 'null' + histories: concatFewShot || 'null', + count: generateCount.toString() }) } ] as any; @@ -216,15 +372,40 @@ assistant: ${chatBg} try { const queries = json5.parse(jsonStr) as string[]; + if (!Array.isArray(queries) || queries.length === 0) { + return { + rawQuery: query, + extensionQueries: [], + model, + inputTokens, + outputTokens + }; + } + + // Generate embeddings for original query and candidate queries + const allQueries = [query, ...queries]; + const embeddings = await generateEmbeddings(allQueries, model); + const originalEmbedding = embeddings[0]; + const candidateEmbeddings = embeddings.slice(1); + // Select optimal queries using lazy greedy algorithm + const selectedQueries = lazyGreedyQuerySelection( + queries, + candidateEmbeddings, + originalEmbedding, + Math.min(5, queries.length), // Select top 5 queries or less + 0.3 // alpha parameter for balancing relevance and diversity + ); + return { rawQuery: query, - extensionQueries: (Array.isArray(queries) ? queries : []).slice(0, 5), + extensionQueries: selectedQueries, model, inputTokens, outputTokens }; } catch (error) { - addLog.warn('Query extension failed, not a valid JSON', { + addLog.warn('Query extension failed', { + error, answer }); return {