SuperAPI AI 工具集

smart-search

通用与其它

查看项目

更新于 10-16 08:38

技能介绍

用途:smart-search 用自然语言搜索个人语雀知识库,读取相关文档并整合出清晰回答,附参考链接。

主要能力:依托 yuque-mcp 服务的两个工具——yuque_search(按关键词搜索文档)与 yuque_get_doc(按 slug/id 读取文档全文)。它会从提问中提取 1-3 个简短中文关键词搜索,筛选最相关的 3-5 篇,最多读取 3 篇文档,再以"回答 / 关键要点 / 参考文档"结构组织输出。

使用方式:需要配置 yuque-mcp 服务器。搜索时调用 yuque_search,参数为 query 与 type: "doc";读取时调用 yuque_get_doc,参数 repo_id 取搜索结果中的 book.namespace,doc_id 取 target.slug。若搜索无果,会尝试同义词或拆分词,仍无结果则如实告知。文档冲突时会指出差异及较新者;仅部分找到时会说明缺失部分。回答语言与用户一致,并引用原文、附文档链接。

适用场景:查询个人语雀中的部署流程、错误日志处理、技术评审笔记等信息,或用户说"search my Yuque""我的知识库里有没有…"。

限制:仅搜索所配置语雀 token 可访问的知识库;不编造文档中不存在的信息。错误处理方面:搜索为空则换词后告知;读取返回 404 则跳过并提示可能已删除;403 则提示可能无权限;API 超时重试一次后告知连接问题;结果过多时聚焦前 3 条并说明还有更多。