技能介绍

要解决的问题

工程师在接入 IMA 知识库时，经常面对一组开放接口：字段名、kb_id、folder_id、media_id 容易传错，写入后又难以撤回。这个技能把 IMA 知识库管理 的常见操作整理成可执行流程：先定位知识库，再浏览目录、导入内容、维护标签和权限，减少凭记忆调 API 的试错成本。

技能如何工作

查询与定位：通过 search_knowledge_base 获取知识库 ID 与角色，通过 get_knowledge_list 浏览文件夹结构，通过 search_knowledge 按名称定位文件或文件夹。
内容入库：支持 upload_file.py 上传文件、import_urls 导入网页链接、add_knowledge 添加笔记，适合把零散资料沉淀到统一知识库。
结构与标签维护：可创建文件夹、重命名、置顶、移动文件，并使用 tag_add、tag_remove、tag_rename、tag_delete 管理标签。
权限管理：通过 join_knowledge、update_knowledge_base_permission、update_knowledge_access_status 控制知识库和文件访问状态。

适用边界

当前 API 不支持删除知识库、文件夹、文件或已上传内容；用户要求删除时应引导其在 IMA 客户端手动处理。
写入操作不可逆，尤其是 tag_delete 和 tag_rename，执行前应先用 tag_list 或 get_knowledge_list(tags=[...]) 预览受影响文件。
内容搜索和阅读更适合交给 search / fetch；此技能负责拿到 kb_id、浏览元数据、导入导出和管理权限。
所有接口返回的 ID 必须原样传递，不能截取、补前缀或改动格式。