Agent Skills
返回列表
2Ryun 知识底座

2Ryun 知识底座

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_1d3db2ec/2ryun-skill 并阅读其 SKILL.md 后按说明使用。

技能介绍

为 AI Agent 搭建知识工作流时,最常见的坑是把「临时想法」和「值得沉淀的知识」混在一起:所有文档一律写入知识库,结果 AI 每次检索都撞上大量派生内容,既浪费 token,也让知识图谱变得嘈杂。2Ryun 把这个问题拆成了两个清晰的容器——文档(Document) 与笔记(Note),并通过 wikiAutoExtract 开关让创建者明确决定一篇文档是否值得进入知识库。

核心机制:入库决策下沉到创建那一刻

2Ryun 的提取与组织是完全异步后台执行的,Agent 不需要手动调用提取接口。文档创建后,1–3 分钟内后台自动完成提取、去重与关联;如果创建后立刻搜索,大概率查不到刚入库的内容——这一点在对接时必须提前告知用户(「稍等片刻再查」)。文档创建接口的 PUT /restapi/documents/update/:id 和 DELETE /restapi/documents/delete/:id 也保持了同样的 REST 风格:资源即增删改查。

判断一篇文档是否入库,核心原则只有一条:它包含新知识,还是已有知识的重组。

  • 适合入库(wikiAutoExtract: true):用户原创文档、笔记、研究;导入的参考资料、报告、论文;包含个人观点、数据、经验的任何新信息
  • 不适合入库(wikiAutoExtract: false 或不设置):基于知识库检索生成的报告与总结;AI 草稿、临时内容;待整理的会议记录

衍生内容再次入库不仅重复,还会在后续检索中稀释相关性——这条规则值得写进你的 Agent prompt 里。

四大能力如何覆盖日常工作流

  1. 文档管理底座:支持文本创建与文件导入(pdf、docx、xlsx、pptx、md、txt、html),统一走 REST API,Authorization: Bearer 鉴权,Key 形如 sk- 前缀加随机串。文档树靠 rootId 与 parentId 约束:根文档两个字段设为同一 ID,子文档分别指向根与直接父节点
  2. 结构化知识库:入库后自动构建,Agent 直接语义搜索(按相关度排序)或查看知识图谱与状态;POST /restapi/wiki/extract 等手动接口仅在明确需要时调用
  3. 可视化发布:单篇文档先从模板接口拿列表再按内容匹配(长文→article-magazine、技术文档→documentation,不要硬编码模板),生成后发布获得 https://www.2ryun.com/restapi/gen-html/public/GEN_ID 形式的公开链接;也可从文档树直接搭建多页面站点(https://www.2ryun.com/s/SITE_ID),或聊天式编辑已有网页的局部区域
  4. 轻量级笔记:笔记天生不提取、不入库,接口与文档独立,适合灵感备忘一类临时记录

容易踩的坑

积分与重试策略是写 Agent 代码时绕不开的:402 配额不足要引导用户去 /pricing 升级,绝不重试;401/403 提示检查 Key,不重试;429 等 Retry-After 秒;500 等 3 秒重试一次仍失败则告知用户。整体上出错重试不超过一次。

另两个细节:查询参数含中文必须 URL 编码(curl 用 --data-urlencode,JavaScript 用 encodeURIComponent);基于知识库生成的报告属于衍生内容,即使通过「知识搜索 + 生成网页报告」流程产出,也应视为新文档且不设 wikiAutoExtract: true。

一句话总结:这个技能的价值不在于功能堆叠,而在于它把「什么值得进知识库」的决策明确下沉给了创建文档的人——Agent 只需诚实地设置开关,剩下的提取、去重、关联、图谱都由服务端异步完成。

使用场景

  • 把本地 PDF 研究报告导入知识库,等待后台异步提取完成后再做语义搜索
  • 从知识库语义搜索某个主题的资料,汇总成 Markdown 报告并生成网页发布
  • 把多篇已写好的文档按树结构组织起来,从文档树一键生成多页面网站并发布
  • 随手记录灵感待办时,用笔记接口存为临时内容,避免污染知识库检索结果

适合人员

  • 维护个人知识库的技术写作者,希望原创长文和导入论文能自动提取关联,而不是手动整理
  • 需要定期归档外部参考资料的研究员,希望报告、论文入库后能被语义搜索准确命中
  • 发布内容的个人博主,想把已有文档通过模板生成网页拿到公开链接,而不是重复排版