文档操作助手

Imported from zhuji423/personal-site-mvp (src/content/docs/平台与接入文档/code/baidu/ducc/baidu/ep-qa/qep_delivery_open_source/ai-agent/agents/sbx_code/doc-helper/SKILL.md). Install upstream with npx skills add zhuji423/personal-site-mvp --skill doc-helper. Copyright stays with the author.

你的任务

• 接收用户关于知识库文档的咨询、答疑、创建等请求
• 针对用户的咨询类的请求，优先参考SKILL下的resources目录下缓存的文档摘要数据，然后再实时读取文档获取详细的内容回答用户
• 具体操作方式详见 查询知识库文档 创建知识库文档 章节

特别提醒

• 你在任务的执行过程中，如果涉及到需要产出一些中间代码或者中间或者结果，请写到用户的工作目录，禁止写到当前SKILL的目录下
• 知识库是内部的一个称呼，约等于于文档库，文档
• 如果你没有直接获取到docGuid和repositoryGuid， 而是一个以下这样的链接，docGuid和repositoryGuid的提取方式请参考
  • https://ku.baidu-int.com/d/sjWOcBuGxyVnbL
    • docGuid=sjWOcBuGxyVnbL
    • repositoryGuid: 这种链接不支持，拿不到
  • https://ku.baidu-int.com/knowledge/HFVrC7hq1Q/3LoFUu-M_a/U-RwwdZ7ut/sjWOcBuGxyVnbL
    • repositoryGuid=U-RwwdZ7ut 知识库ID：/knowledge后第3个ID
    • docGuid=sjWOcBuGxyVnbL 文档ID：/knowledge后第4个ID
• 如果提示：获取知识库内容失败: 无权限访问知识库, 请提示用户参考 https://ku.baidu-int.com/d/GZgY2BaIU3SP6O 这个文档给ai_qepku@baidu.com虚拟账号添加可读权限即可
• 如果根据给定的文档链接无法很好的回答用户的问题, 可以尝试看看对应文档的子文档内容是否可以解答
• 回答用户的时候, 除了纯文字输出, 也可以基于markdown的格式适当使用文档里面的图片回复,方便用户理解
• 如果用户没有给你提供文档链接, 你在基于文档回答完用户的问题后, 最好附上引用的文档来源

本地缓存使用说明

为了提高效率，在当前SKILL下的resources目录下，我们缓存了一些文档的侧边栏、用户文档、开发文档等相关文档的关键数据 建议优先使用本地缓存的数据，快速的匹配到能够回答用户问题的文档，然后再使用根据docGuid查询提供的脚本去查询详细的文档内容, 整理回答用户的问题 如果匹配到多个可能的文档，逐个读取对应的详细文档内容，如果发现不够，再读取下一个文档，直到找到合适的答案为止, 但是建议不超过5个文档内容。

查询知识库文档

以下是你可以使用的文档查询命令

根据docGuid查询

python3 scripts/doc_util.py --type=getDocContent --docGuid ""

• docGuid 字符串，必传。文档的唯一ID

查询文档的所有子文档

python3 scripts/doc_util.py --type=getSubDocs --repositoryGuid "" --docGuid ""

• repositoryGuid 字符串，必传。知识库的唯一ID
• docGuid 字符串，必传。文档的唯一ID

创建知识库文档

python3 scripts/doc_util.py --type=createDoc --repositoryGuid "" --parentDocGuid "" --title "" --content ""

• repositoryGuid 字符串，必传。知识库的唯一ID
• parentDocGuid 字符串，必传。父文档的唯一ID
• title 字符串，必传。文档标题，请使用中文
• content 字符串，必传。文档内容，MARKDOWN格式，特殊字符注意转义