SuperAPI AI 工具集

cms-taxonomy

通用与其它

查看项目

更新于 10-15 20:28

技能介绍

用途:为开发者提供 Contentstack Taxonomy(分类法)的使用建议,用于结构化、层级化的内容分类,以及交付端(Delivery)按分类过滤。适用于产品分类、地理区域、内容主题、文档类型等需要被查询的场景。

主要能力:帮助判断应使用 taxonomy、tags、labels 还是 references;指导层级与术语建模;给出 CDA 分类查询操作符示例;覆盖本地化与导入导出建议。

使用方式:先理解分类需求与交付要求,再推荐合适机制。若适合 taxonomy,则规划层级(通常最多 3-4 层,术语按父子排序),并用 CDA 操作符过滤:$taxonomy_exists(任意术语)、$taxonomy_equal(指定术语)、$taxonomy_below(术语及其后代)、$taxonomy_above(祖先)。本地化取决于套餐,本地化术语与主术语共享同一 UID;导入导出支持 JSON 与 CSV,无效 CSV 行会被跳过而有效行继续处理。

适用场景:需要交付端可查询的结构化层级分类;不适合自由标签、CMS 内部组织或带独立内容模型的丰富分类页——这些应分别用 tags、labels 或带引用的 Category 内容类型。

限制:该技能为只读咨询,不创建、修改、移动、删除或导入分类数据;移动带子项的术语默认被阻止,除非显式使用 force 标志。示例代码须用环境变量存放凭据,不得暴露管理令牌或 API 密钥,浏览器应用应通过服务端代理调用 CMA。