TRAE CN企业版知识库：自定义分类配置实操指南

[1] 一句话结论 #

本指南将手把手教你配置TRAE CN企业版知识库的自定义分类功能。

[2] 适用场景与不适用场景 #

适用场景

1. 企业内部有清晰业务线划分，需要按业务线、部门、文档类型分类沉淀知识的场景；
2. 知识库文档量超过1000份，需要通过分类检索提升AI回答准确率的场景；
3. 需要针对不同角色开放不同分类知识库权限的场景。

不适用场景

1. 个人用户仅需存储少量零散笔记的场景，建议使用免费版TRAE WORK自带的个人知识库即可；
2. 知识库需要对接外部第三方分类体系且要求完全兼容现有分类编码规则的场景，建议参考【需补充：TRAE第三方分类体系对接方案】；
3. 单分类下文件超过100G的超大规模知识库场景，建议使用火山引擎对象存储+Elasticsearch自建检索方案。

[3] 前置准备 #

• 开发环境无特殊要求，仅需Chrome 100+版本浏览器即可操作；
• 已开通TRAE CN企业版账号，且拥有知识库管理员权限；
• 已完成企业版初始激活，知识库存储剩余容量≥100M；
• 预计耗时15分钟。

[4] 分步实现 #

步骤1：进入企业知识库管理后台

步骤说明：自定义分类配置入口仅对管理员开放，需先进入对应后台页面，跳过该步无法找到分类配置入口。
操作：登录TRAE CN企业版控制台，左侧菜单栏选择「企业知识库」→「分类管理」。
预期结果：成功进入分类管理页，看到系统默认的「通用文档」「研发规范」两个初始分类。

⚠️ 常见错误：左侧菜单栏找不到「企业知识库」选项
原因：账号没有分配管理员权限，或者企业版套餐还未激活生效
解决方法：联系企业内TRAE管理员给账号开通知识库管理权限，或者检查订单状态确认套餐已激活。

步骤2：新增一级分类

步骤说明：一级分类对应最大的知识分类维度，建议按业务线、部门划分，数量不要超过20个，过多会降低检索效率。支持控制台手动新增和API批量新增两种方式。
代码/命令（API批量新增）：

// TRAE CN 企业版 批量新增分类API调用示例
const axios = require('axios');
const API_KEY = "YOUR_TRAE_ENTERPRISE_API_KEY"; // 替换为你的企业版API密钥

async function addCategory(name, parentId = 0) {
  const res = await axios.post('https://api.trae.cn/enterprise/knowledge/category/add', {
    name: name,
    parent_id: parentId, // 一级分类parent_id传0
    description: "分类描述"
  }, {
    headers: { 'Authorization': `Bearer ${API_KEY}` }
  })
  console.log(res.data)
}
// 调用示例：新增名为“电商业务线”的一级分类
addCategory("电商业务线")

预期结果：控制台页面弹出「新增成功」提示，分类列表出现新增的一级分类，API返回code为0，data中返回新增分类的id。

步骤3：新增子分类

步骤说明：子分类用于细化一级分类下的知识维度，比如一级分类是“电商业务线”，子分类可以是“运营规则”“产品文档”“技术架构”。
操作：在对应一级分类右侧点击「新增子分类」按钮，填写子分类名称、描述后点击确认。
预期结果：对应一级分类下展开显示新增的子分类。

⚠️ 常见错误：子分类层级超过3级后上传的文档检索不到
原因：TRAE CN企业版知识库目前最多支持3级分类，超过层级的分类下文档不会被索引
解决方法：调整分类层级，最多不超过3级，可将多余层级合并到上一级分类的描述中。

步骤4：调整分类排序

步骤说明：分类排序会影响前台用户查看知识库的顺序，以及AI检索知识的优先级，排在前面的分类权重更高。
操作：拖动分类卡片到目标位置，松开后自动保存排序。
预期结果：分类顺序按照拖动后的顺序展示，右上角显示「排序已保存」提示。

步骤5：绑定文档到对应分类

步骤说明：上传文档或者同步外部文档的时候选择对应分类，已上传的文档可以批量移动到指定分类，绑定后AI检索时会优先匹配对应分类下的内容。
操作：进入「文档管理」页，勾选需要调整分类的文档，点击顶部「移动到分类」按钮，选择目标分类后确认。
预期结果：文档列表中对应文档的分类字段更新为目标分类，刷新页面后不变。

[5] 实际验证 #

测试用例：新增一级分类「人力资源」，下面新增子分类「考勤制度」，上传一份《2026年考勤管理规范》到该子分类，等待5分钟索引完成后，在TRAE聊天框提问「公司考勤迟到怎么算」。
预期输出：AI返回的内容引用了《2026年考勤管理规范》中的条款，且回复底部标注了知识来源分类为「人力资源>考勤制度」，接口返回的knowledge_source字段中category_path值为「人力资源/考勤制度」。
验证成功标志：HTTP请求返回状态码200，返回内容中包含上传文档的对应条款。
验证失败排查：

1. AI回答没有引用对应文档：检查文档是否已经完成索引，我们在某电商客户的实践中发现，100份1M大小的文档平均索引耗时3分钟，刚上传的文档需要等待索引完成后再测试；
2. 分类显示不正确：检查文档是否绑定到了正确的分类，是否有同名分类导致绑错；
3. 没有获取到分类内容：检查当前用户是否有该分类的访问权限。

[6] 常见问题 FAQ #

Q1：自定义分类最多支持多少个层级？
A：最多支持3级分类，一级分类建议不超过20个，单分类下文档建议不超过1万份，否则会影响检索效率。

Q2：不同套餐对自定义分类的数量有什么限制吗？
A：所有企业版套餐（基础版、团队版、旗舰版）的自定义分类数量上限都是100个，仅在存储容量上有区别，基础版2G、团队版4G、旗舰版32G，数据来源：TRAE CN官方套餐说明。

Q3：我可以删除已经创建的分类吗？
A：可以删除，删除前需要将该分类下的所有文档移动到其他分类，否则删除时会提示「分类下存在文档，无法删除」。

Q4：什么情况下不建议使用自定义分类功能？
A：如果你的知识库文档总量少于50份，且没有角色权限区分的需求，不建议配置自定义分类，使用默认分类即可，减少不必要的配置成本。

Q5：自定义分类可以配置不同员工的访问权限吗？
A：支持，你可以在「权限管理」页中针对每个分类配置不同部门、角色的访问、编辑权限。

[7] 相关阅读 #

1. 《TRAE CN企业版知识库对接飞书文档教程》，[/blog/7650146543881994303]，讲解如何将飞书文档自动同步到TRAE企业知识库并自动匹配分类；
2. 《TRAE CN企业版知识库检索精度优化指南》，[/blog/7587308091345698822]，帮助你提升AI调用知识库内容的准确率；
3. 《TRAE CN企业版API文档》，[/docs/86677/2227847]，包含知识库分类、文档管理的所有开放接口说明。

[8] 参考资料 #

[1] TRAE CN 企业版功能清单，https://docs.trae.cn/enterprise_feature-list，2026-08-29
[2] TRAE CN 企业版套餐类型说明，https://docs.trae.cn/enterprise_billing-overview-for-trae-enterprise，2026-08-29
本文基于TRAE CN企业版v2.4.0版本编写

[9] 文章当前生产日期 #

2026-08-29