@tencentcloud/sdk-mcp 1.7.5 → 1.7.6

package/tools/definitions/search_trtc_knowledge_def.js

@@ -1,38 +1,60 @@
 const TOOL_DESCRIPTION = `
-凡 Tencent RTC 文档咨询（Chat/Call/Live/Room/Push/Web TRTC/Native TRTC）：FAQ、错误码、API、组件、feature、插件、集成查阅、排障 → MUST 先本工具。禁止 web_search。写接入代码 → get_*_integration。
+Purpose:
+Use this tool as the default retrieval entry for Tencent RTC documentation and troubleshooting.
 
-**prompt 必须原样保留用户问题**：禁止扩写、发散、改写、补充 API 用法/场景描述。用户问什么就传什么原文。若需补充语义（如 API/事件/具体实现），用 types/frameworks/product 结构化参数表达，或另行搜索。
+When to call (MUST):
+- Technical Q&A: product capability, configuration, best practice, documentation lookup.
+- API lookup: API / component / event / parameter / error code.
+- Troubleshooting: error, exception, failure, compatibility issue.
+- Integration reference lookup when user wants guidance/docs but does NOT explicitly ask for runnable code generation.
 
-**product**（能推断 MUST 传；不能确定先问用户）：
-push:TIMPush/推送/厂商/FCM/华为/小米/OPPO（≠chat）| chat:会话/TUIKit/IM/主题 | call:CallKit | live:LiveKit | room:RoomKit/会议
-rtcengine:Web TRTC | native_trtc_sdk:TRTCCloud | 跨域:["push","chat"]
+When NOT to call:
+- Non-technical chat/greeting/small talk.
+- User explicitly asks to generate or modify runnable integration code in project -> use corresponding get_*_integration tool.
 
-**frameworks**（requires-framework.ts 顺序）：
-已传→检索 | needs_framework→present_framework_choice后重搜
-chat+错误码/ERR_→先问platform | native→MUST 包含 android/ios/c++ 之一 | rtcengine→隐式web
-push:厂商名≠平台(可不传);开通/接入/控制台/厂商配置可不传;含android/ios/flutter等→MUST
-计费/REST/Webhook/UserSig→可不传 | types仅server_api/webhook/product→可不传
-控制台/产品能力配置（多端登录/登录策略/消息存储时长/控制台设置）→types=["product"]，勿用feature；误传feature时runtime按跨平台产品配置处理
-types含api/component/feature/plugin/sdk/integration→MUST | API/组件/enterRoom/SDK/插件/排障→MUST或先问
+Hard input rule:
+- prompt MUST preserve original user question verbatim. Do NOT expand, rewrite, or inject extra assumptions.
 
-**types**：默认不传；开放["faq"]；REST/错误码/Webhook/控制台产品配置时再传。控制台配置勿窄传component/api/feature。
-- 发现型/罗列型问题（"有哪些组件/API"、"可用组件列表"）→ MUST 省略 types（窄传会杀掉召回）。
-- component 与 feature 等价（UIKit 文档统一打 feature 标签），传任一都会同时匹配。RoomKit/LiveKit Web 基于 Vue（framework=web 已含 vue）。
+Product routing:
+- push: TIMPush / 推送 / 厂商 / FCM / APNs / 华为 / 小米 / OPPO / vivo
+- chat: 会话 / TUIKit / IM / 主题
+- call: CallKit / 通话
+- live: LiveKit / 直播 / 语聊房
+- room: RoomKit / 会议
+- rtcengine: Web TRTC / WebRTC
+- native_trtc_sdk: TRTCCloud / Native SDK / 客户端
+- Multi-domain is allowed (e.g. ["push","chat"]).
 
-**L0/L1**：本地fragments仅基于片段答；chat/urls/须fetch官网URL，禁止臆造。
+Framework policy:
+- If client platform is required but missing, call present_framework_choice first.
+- If status=needs_framework, MUST collect framework first and then re-search.
+- Framework is optional for cross-platform topics (pricing, REST, webhook, product-level console config).
 
-**返回**：status、confidence、fragments(doc_urls)、meta.references、queryID、message、meta.answer_contract。答案遵守 answer_contract(完整输出、用户可执行、未确认显式化),禁止精简,禁止输出"命中片段/检索结果/置信度/分数"等系统话术,但末尾需保留"参考文档"并列出 references/doc_urls。最终回复前 MUST 调用 finalize_answer;明确 follow-up 反馈后调用 submit_feedback。
+Types policy:
+- Default: do not pass types.
+- Pass types only for clearly scoped cases (REST / webhook / error_code / product-level config).
+- For discovery/listing questions (e.g. “有哪些组件/API”), keep types empty to avoid over-filtering.
+
+Few-shot:
+- User: "TRTC 报错 10015 是什么原因？" -> CALL search_trtc_knowledge
+- User: "RoomKit 有哪些可配置组件？" -> CALL search_trtc_knowledge
+- User: "帮我把 Web Chat UIKit 接进 React 项目并给可运行代码" -> Prefer get_*_integration (not this tool first)
+
+Return contract:
+- Returns status/confidence/fragments/meta.references/queryID/answer_contract.
+- Before final user reply, MUST call finalize_answer.
+- After explicit follow-up feedback, MUST call submit_feedback.
 `;
 const PARAMETER_DESCRIPTIONS = {
-    prompt: '用户原始问题原文，MUST 原样透传，禁止扩写/发散/补充（如补 API 用法、场景、追问）。用户没说的不写进去；需补充语义用 types/frameworks 等结构化参数表达。',
-    product: '产品数组：chat|call|live|room|push|rtcengine|native_trtc_sdk。能推断 MUST 传；push优先(TIMPush/推送→push，禁止误归chat)。live 常见关键词：LiveKit/直播/语聊房/TUILiveKit/AtomicXCore/开播/观看。不能确定先问用户。',
-    frameworks: '平台数组：react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。支持传多个平台用于跨端检索；CallKit 中 TUICallKit 建议按 react/vue 区分检索，TUICallEngine/TUICallEvent 仍归 web；小程序用 miniprogram；harmonyos/react-native/unity/unreal/donut仅push适用。若未传且问题依赖具体客户端平台，必须先调用 present_framework_choice 询问后重搜。',
-    types: '默认不传；开放["faq"]。限定：integration|component|feature|api|plugin|sdk|error_code|product|server_api|webhook。component 与 feature 等价（同时匹配）；发现型/罗列型问题（"有哪些组件"）MUST 省略 types。控制台/计费/产品能力配置→product（非feature）。勿主动窄传。',
-    scenario: 'live|voice，仅live产品。',
-    queryID: '首次\'\'，后续同一咨询MUST透传（见server）。',
-    ide: 'IDE名称（cursor|claude-code|vscode|codebuddy|codex|trae｜others）',
-    from: '默认空字符串。',
-    limit: '片段数，默认8，最大16。',
+    prompt: 'Original user question, MUST be passed verbatim. Do not rewrite or extend. Use structured fields (product/frameworks/types) for extra constraints.',
+    product: 'Product array: chat|call|live|room|push|rtcengine|native_trtc_sdk. Infer and pass when confident. push has priority for TIMPush/推送 queries.',
+    frameworks: 'Framework/platform array: react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut. If platform is required but missing, call present_framework_choice first.',
+    types: 'Optional filter. Allowed: integration|component|feature|api|plugin|sdk|error_code|product|server_api|webhook|faq. Keep empty for discovery/listing queries.',
+    scenario: 'live|voice, only for live product.',
+    queryID: 'First call can be empty string; all subsequent calls in same consultation MUST reuse the returned queryID.',
+    ide: 'IDE name: cursor|claude-code|vscode|codebuddy|codex|trae|others.',
+    from: 'Optional, default empty string.',
+    limit: 'Fragment count, default 8, max 16.',
 };
 export const SEARCH_KNOWLEDGE_DEFINITION = {
     name: 'search_trtc_knowledge',

package/tools/definitions/submit_feedback_def.js

@@ -1,23 +1,27 @@
 const TOOL_DESCRIPTION = `
 Purpose:
-Submit the user's reply to the finalize_answer follow-up.
+Submit user feedback for the finalize_answer follow-up.
 
-When to call:
-- If the previous assistant response ended with the finalize_answer follow-up, check the next user reply for feedback before any normal response.
-- Positive: "Yes", "已解决", "解决了", "好的", "谢谢", "OK", "yes", "resolved" -> resolved="1".
-- Negative: "No", "未解决", "没解决", "不行", "还有问题", "no" -> resolved="0".
-- MUST call this tool before replying when feedback is explicit.
-- Never say feedback was submitted/recorded unless this tool was called.
-- Do NOT call for unclear replies or new unrelated questions.
+When to call (hard rule):
+- If previous assistant message ended with finalize_answer follow-up, inspect the next user reply first.
+- If reply explicitly indicates solved/unsolved, MUST call this tool before any normal response.
+- Do NOT call for unclear replies, unrelated new questions, or non-feedback messages.
 
-Input:
-- prompt: Original user question. Must match finalize_answer.
-- queryID: REQUIRED. Same queryID as search_trtc_knowledge/finalize_answer.
-- resolved: "1" for positive feedback, "0" for negative feedback.
+Resolved mapping:
+- resolved="1": Yes / 已解决 / 解决了 / 好的 / 谢谢 / OK / resolved
+- resolved="0": No / 未解决 / 没解决 / 不行 / 还有问题 / still not working
+
+Input contract:
+- prompt: original user question, consistent with finalize_answer.
+- queryID: REQUIRED, same queryID used by search_trtc_knowledge/finalize_answer.
+- resolved: "1" or "0".
+
+Output contract:
+- Never claim feedback is submitted/recorded unless this tool has been called.
 `;
 const PARAMETER_DESCRIPTIONS = {
-    prompt: 'Original user question. Must match finalize_answer.',
-    framework: 'Reuse framework from the search_trtc_knowledge chain when available.',
+    prompt: 'Original user question. Must match finalize_answer prompt.',
+    framework: 'Reuse framework from current search_trtc_knowledge chain when available.',
     queryID: 'REQUIRED. Same queryID as search_trtc_knowledge/finalize_answer.',
     resolved: '"1" for positive feedback, "0" for negative feedback.',
 };

package/utils/report-cls-client.js

@@ -32,7 +32,7 @@ function sendCLSReport(reportData) {
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.7.5',
+        verison: '1.7.6',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: queryID || userID,

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.7.5',
+                version: '1.7.6',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,