技能介绍

要解决的问题

在智能体对话中处理知识库时，常见困难不是“能不能调接口”，而是不知道该调哪个接口、如何定位目标知识库、如何把 文件、网页、笔记 或 URL 安全写入，以及如何把内部 ID 转成用户可理解的名称展示。这个技能面向基于 openapi/wiki/v1 的知识库场景，把用户意图映射为明确接口与参数约束，减少猜测和重复操作。

技能如何工作

写入流程：上传文件前先做前置检查与 check_repeated_names，再执行 create_media、COS 上传、验证和 add_knowledge；批量上传可一次检查最多 2000 个文件名。
内容来源：支持添加网页/微信文章（import_urls）、笔记（add_knowledge 且 media_type=11），以及 URL。若 URL 指向 PDF/Word/PPT 等文件型资源，按文件上传流程处理。
定位与浏览：用户知道名称但不知道 ID 时，优先 search_knowledge_base；用户未指定目标知识库时，使用 get_addable_knowledge_base_list 让用户选择。浏览内容使用 get_knowledge_list，搜索使用 search_knowledge。
原文处理：通过 get_media_info 获取原文信息；当需要导出或下载时，在 URL 后追加 response-content-type 与 response-content-disposition，让浏览器以指定文件名下载。

适用边界与注意点

该技能适合需要把自然语言任务落到具体知识库 API 的场景，尤其是上传、检索、浏览、定位文件夹和导出原文。读取类操作没有文件上传安全门限制，但写入类操作必须遵守重名检查、COS 上传与验证流程。面向用户展示时应隐藏 knowledge_base_id、media_id、folder_id，使用知识库名称、文件标题或文件夹名称；批量操作应汇总成功与失败原因，而不是逐条暴露内部步骤。