@tencentcloud/sdk-mcp 1.7.7 → 1.7.9-beta.1

package/knowledge/search/search-knowledge.js

@@ -7,7 +7,7 @@ import { classifyRetrievalMode } from './intent-router.js';
 import { rankSubsetWithIndex } from '../bm25.js';
 import { getProductsBM25Index } from '../bm25-cache.js';
 import { hasExplicitFrameworkMatch } from './framework-fallback.js';
-import { assessConfidence, assessNarrativeCompleteness, buildNarrativeDocument, hasNativeClientFramework, hasNativeTrtcApiSignal, hasProductScopeIntent, inferQueryApiTokens, pickNarrativeSource, } from './search-core.js';
+import { assessConfidence, assessNarrativeCompleteness, buildDiscoveryCatalog, buildNarrativeDocument, hasNativeClientFramework, hasNativeTrtcApiSignal, hasProductScopeIntent, inferQueryApiTokens, pickNarrativeSource, } from './search-core.js';
 import { scoreUrlRow } from './url-row-scorer.js';
 import { buildAnswerContract, buildAgentMessage } from './search-message.js';
 import { runSearchPass } from './search-pass.js';
@@ -174,7 +174,7 @@ function computePrimaryCompleteness(allChunks, fragments, preferredSource) {
         primary_completeness: fileToken > 0 ? Number((hitToken / fileToken).toFixed(2)) : 0,
     };
 }
-export function searchKnowledge(params) {
+export async function searchKnowledge(params) {
     const norm = normalizeParams(params);
     const retrievalMode = classifyRetrievalMode(norm.prompt);
     if (requiresFramework(norm)) {
@@ -196,36 +196,21 @@ export function searchKnowledge(params) {
     const manifest = loadManifest();
     const allChunks = manifest.chunks;
     const queryApiTokens = inferQueryApiTokens(norm.prompt);
-    let pass = runSearchPass({
+    let pass = await runSearchPass({
         allChunks,
         passNorm: norm,
         retrievalMode,
         queryApiTokens,
     });
-    // best-practice 懒补充：仅在主 pass 无本地片段（仅 URL 映射行或完全为空）时触发。
-    // 典型场景：Agent 传 types=['sdk']，filterPool 把 best-practice（type=faq）硬过滤掉，
-    // 只剩 URL 映射行（有 E7 boost 但内容只是一个 URL 链接）。
-    // 不侵入 runSearchPass 层，避免每次调用都执行重复检索。
-    // 修复 B1 副作用：之前 `types: undefined` 会同时把 chat/preset/{flutter,android,...}/integration.md
-    // （types=['integration']）也放进 pool，integration 文档多 section 命中 generic 词会把 URL row 顶掉。
-    // 改为 `types: ['faq']` 后：
-    //   - best-practice（types=['faq']）走 filterPool 的 bp-bypass 保留
-    //   - chat/preset/.../integration.md（types=['integration']）被硬过滤
-    //   - URL row（types 与原请求一致）继续保留
-    // 合并策略：append BP fragments 到原 pass（不去重 URL row），保留 URL row 在 top。
+    // best-practice 懒补充（收敛版）：仅在主 pass 完全无结果时触发。
+    //
+    // 设计意图：
+    // - BP 从“主通道召回增强”退到“兜底校准器”
+    // - 对“仅 URL 行”的场景不再补 BP，避免策略叠加导致的 BP 过召回
+    // - 保留 hard-fail 场景的可恢复性（空结果时补一次 faq）
     const passRetryReasons = [];
-    const hasLocalContent = pass.fragments.some((f) => !f.source.includes('/urls/'));
-    // 当主 pass 命中一个明确的 URL row（scoreUrlRow ≥ 300 强信号）时，**跳过 B1 补充**，
-    // 避免 BP 兜底把无关 BP 文档（message-unread-count、avchatroom-message-loss-diagnosis 等）塞满 fragments。
-    // 典型反例：query「im 内网代理」types=['product']，pass 命中「内网代理实现方案」(scoreUrlRow=460)，
-    // 旧 B1 会触发 → 拉 8 个无关 BP → fragments 膨胀到 9 个。
-    // 进一步保护：当 top1 finalScore < 20（零命中场景，如「im 怎么发火箭」finalScore=16.8），
-    // 也不触发 B1——无意义 query 不该被 BP 兜底撑满。
-    const top1UrlScore = !hasLocalContent && pass.fragments[0]?.title
-        ? scoreUrlRow(norm.prompt, pass.fragments[0].title).score
-        : 0;
-    const top1FinalScore = pass.fragments[0]?.score ?? 0;
-    if (!hasLocalContent && top1UrlScore < 300 && top1FinalScore >= 20 && norm.product?.length && !norm.types?.includes('faq')) {
+    const noFragments = pass.fragments.length === 0;
+    if (noFragments && norm.product?.length && !norm.types?.includes('faq')) {
         const primaryProduct = norm.product[0];
         const bpCandidates = allChunks.filter((chunk) => {
             if (!/\/best-practice\//i.test(chunk.source))
@@ -244,7 +229,7 @@ export function searchKnowledge(params) {
             const bpIndex = getProductsBM25Index(allChunks, [norm.product[0]]);
             const bpRanked = rankSubsetWithIndex(norm.prompt, bpCandidates.map((c) => c.id), bpIndex, {});
             if ((bpRanked[0]?.score ?? 0) >= 6) {
-                const bpPass = runSearchPass({
+                const bpPass = await runSearchPass({
                     allChunks,
                     passNorm: { ...norm, types: ['faq'] },
                     retrievalMode,
@@ -276,7 +261,7 @@ export function searchKnowledge(params) {
         ? Number((pass.missingApiTokens.length / queryApiTokens.length).toFixed(2))
         : 0;
     if (queryApiTokens.length > 0 && (pass.apiNameCoverage === 0 || missingRatio >= 0.3)) {
-        const retryPass = runSearchPass({
+        const retryPass = await runSearchPass({
             allChunks,
             passNorm: { ...norm, types: undefined },
             retrievalMode,
@@ -296,7 +281,7 @@ export function searchKnowledge(params) {
     // B3: 混合“集成 + 产品开通/计费/控制台”问法时，补充 product type，避免仅搜 integration/feature。
     if (norm.types?.length && !norm.types.includes('product') && hasProductScopeIntent(norm.prompt)) {
         const widenedTypes = [...new Set([...norm.types, 'product'])];
-        const retryPass = runSearchPass({
+        const retryPass = await runSearchPass({
             allChunks,
             passNorm: { ...norm, types: widenedTypes },
             retrievalMode,
@@ -320,7 +305,7 @@ export function searchKnowledge(params) {
         && pass.apiNameCoverage < 0.5;
     if (shouldRetryNativeProduct) {
         const expandedProducts = [...new Set([...(norm.product ?? []), 'native_trtc_sdk'])];
-        const retryPass = runSearchPass({
+        const retryPass = await runSearchPass({
             allChunks,
             passNorm: { ...norm, product: expandedProducts, types: undefined },
             retrievalMode,
@@ -356,7 +341,7 @@ export function searchKnowledge(params) {
             types: undefined,
             limit: Math.max(norm.limit ?? 8, 12),
         };
-        const retryPass = runSearchPass({
+        const retryPass = await runSearchPass({
             allChunks,
             passNorm: narrativeRetryNorm,
             retrievalMode,
@@ -379,7 +364,7 @@ export function searchKnowledge(params) {
     if (shouldDeepCoverageCheck) {
         coverageReport = buildCoverageReport(allChunks, pass.fragments, pass.preferredSource);
         if (coverageReport.retry_suggested) {
-            const coverageRetryPass = runSearchPass({
+            const coverageRetryPass = await runSearchPass({
                 allChunks,
                 passNorm: { ...norm, types: undefined, limit: Math.max(norm.limit ?? 8, 12) },
                 retrievalMode,
@@ -441,6 +426,9 @@ export function searchKnowledge(params) {
     const documents = retrievalMode === 'narrative'
         ? (narrativeState.document ? [narrativeState.document] : [])
         : [];
+    const catalog = retrievalMode === 'discovery'
+        ? buildDiscoveryCatalog(pass.rankedWithMultipliers, pass.poolWithContent, Math.max(norm.limit ?? 8, 6))
+        : [];
     let finalStatus = status;
     let finalConfidence = confidence;
     if (retrievalMode === 'narrative' && documents.length > 0) {
@@ -453,7 +441,7 @@ export function searchKnowledge(params) {
             finalConfidence = 'low';
         }
     }
-    if (retrievalMode === 'discovery' && pass.fragments.length > 0) {
+    if (retrievalMode === 'discovery' && catalog.length > 0) {
         finalStatus = 'success';
         finalConfidence = finalConfidence === 'none' ? 'medium' : finalConfidence;
     }
@@ -486,7 +474,7 @@ export function searchKnowledge(params) {
     const narrativeConverged = retrievalMode !== 'narrative'
         || (documents.length > 0 && narrativeState.quality.isComplete);
     const convergenceReached = (retrievalMode === 'narrative' && narrativeConverged)
-        || (retrievalMode === 'discovery' && pass.fragments.length > 0)
+        || (retrievalMode === 'discovery' && catalog.length > 0)
         || (finalStatus === 'success'
             && (finalConfidence === 'high' || finalConfidence === 'medium')
             && (!hasApiQueryTokens || pass.apiNameCoverage >= 0.5)
@@ -529,6 +517,7 @@ export function searchKnowledge(params) {
         query: params,
         retrieval_mode: retrievalMode,
         documents,
+        catalog,
         meta: {
             // 参考文档（AI 输出「参考文档」小节依据）：
             ...(pass.references.length ? { references: pass.references } : {}),
@@ -549,6 +538,7 @@ export function searchKnowledge(params) {
                     },
                 }
                 : {}),
+            vector_retrieval: pass.vectorDiagnostics,
         },
         fragments: pass.fragments,
     };