cannbot-knowledge回答可追溯技术问题7步答案框架与零命中处理终极方法【免费下载链接】cannbot-knowledgecannbot算子开发知识库插件依赖的知识库本体仓给cannbot提供统一的知识底座。项目地址: https://gitcode.com/cann/cannbot-knowledgecannbot-knowledge 是 CANN 算子开发 AgentCANNBot的知识底座仓库提供统一的知识检索货架。本文介绍如何用它的7 步可追溯答案框架回答 CANN 算子、API、调试与性能优化类技术问题并给出检索零命中零结果时的标准处理方法让每一个回答都能追溯到具体知识卡和原始来源新手也能照着做。为什么 CANN 技术回答要可追溯CANN 工程知识有很强的边界性同一个 API 在 Ascend 910B 和 950 上行为可能不同同一个优化经验可能只适用于特定 CANN 版本。如果回答只有结论、没有依据你就无法判断它是否适用于你的平台和版本。cannbot-knowledge 把知识整理成带 Frontmatter 元数据的Markdown 知识卡每张卡都记录适用平台、生命周期状态和来源例如 Ascend 910/95 平台概念卡、数据拷送概念卡。可追溯回答的要点先给结论再说明适用范围、依据读过的卡片与来源、限制和仍需验证的内容——这正是 recipes/answer_with_evidence.md 定义的流程。7步答案框架从提问到可追溯回答以下步骤整理自 recipes/answer_with_evidence.md明确问题一次只回答一个问题。复杂问题拆开查不要把实现、调试和性能问题塞进同一条 query。查看覆盖情况确认目标范围内真的有知识卡——只有目录不代表有内容安装后可先用knowledge-query的discover查看覆盖统计。按真实范围查询保留平台与 DSL 条件不为了增加结果而扩大范围记录 CANN 版本打开命中卡后核对正文边界。选择候选卡根据标题、摘要、路径和状态选卡。精确 API 名在目标平台稳定卡零命中时按查询 Skill 单独补搜平台未定位的 draft仅作待核验线索。打开卡片正文读结论、适用条件、限制和完整来源不要直接拿搜索摘要作答。核对来源确认来源确实支持结论多张卡片冲突时先比较它们的平台、版本和来源。整理回答按固定结构输出——结论直接回答问题 适用范围技术、平台、版本和其他条件 依据使用的知识卡和来源 限制或冲突不适用情况或不同结论 仍需验证源码、实验或性能分析 第 5、6 步是可追溯的核心标题、摘要或来源链接本身都不构成已核验证据必须读完正文并核对来源。零命中处理终极方法先判故障再判缺口查询返回空结果时最常见的误区是直接把没查到当成这个技术不存在。docs/installation_and_usage.md 的没有结果时怎么办章节 knowledge-query Skill 给出了标准处理链步骤判断与动作① 区分错误与零命中脚本退出码2是参数/索引错误不是零命中先修复索引重跑安装器即可重建索引退出码0且无结果才是有效零命中② 索引不可用 → 停止索引缺失、损坏或过期时停止查询并报告不能把本次结果当作没有知识③ 核对查询条件核对目标范围的实际覆盖、API 名/错误码拼写以及平台、技术、版本条件④ 定向补搜精确 API 名 stable 零命中时立即补搜平台未定位 draft保留 API 名与 domain/technology使用--type apis --match literal --include-unlocated --status draft不带 platform。结果只是平台待核验线索不能混入原平台结论⑤ 普通补搜只换一个角度保持已确定的平台和技术边界只改变一个有依据的角度准确标识 → 参数/错误信号、接口 → 使用指南不要一上来就放宽到所有技术、所有状态⑥ 仍无结果 → 报告知识缺口回答中说明已检查的范围、具体的知识缺口、是否需要你提供材料或允许核对其他来源。不要用其他平台或其他 DSL 的卡片替代目标证据三条底线来自 Skill 的权限边界零命中不证明API 或能力不存在命中也不等于当前问题已覆盖仍要读正文核对边界不能为了召回而修改知识卡的平台或状态字段。快速上手安装后如何发起一次查询安装入口是 install.sh以 Claude Code 的 consumer查询模式为例bash install.sh claude /path/to/project consumer安装成功后进入目标项目向 Agent 提问即可。三种常见入口详见 安装与使用指南问题形态推荐入口已知准确卡片路径答案只依赖一张卡直接把路径交给 Agent 阅读全文例如 Ascend 910/95 平台卡不知道卡片路径或需要多张卡综合knowledge-query通用检索Ascend C API 的契约、选型、本地头文件核对ascendc-api-knowledge-query提问时给足问题 目标技术 目标平台三要素例如使用knowledge-query查询 950 平台上实现 Softmax 时可复用的算子设计、API 约束和已知性能问题。请选择相关知识卡核对来源后综合回答。延伸阅读把可追溯能力接入你的项目形成可追溯回答7 步框架完整说明本文主要依据安装与使用指南安装、验证、零命中处理与常见问题查询 API 最佳实践API 检索的推荐问法知识路径规范理解知识卡目录结构方便按路径直接读卡knowledge-query Skill 定义检索边界、补搜与停止条件的权威说明设计原则为什么知识库要做成可追溯到来源的样子一句话总结可追溯回答 明确问题 → 按范围查询 → 读卡正文 → 核对来源 → 结构化输出零命中 先排除索引故障再做定向补搜最后如实报告知识缺口。照着做你的每次回答都有据可查。【免费下载链接】cannbot-knowledgecannbot算子开发知识库插件依赖的知识库本体仓给cannbot提供统一的知识底座。项目地址: https://gitcode.com/cann/cannbot-knowledge创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考