Sanity内容管理系统自动标签功能实现指南

前言

在内容管理系统中，标签(Tag)是组织内容、提高可发现性的重要工具。然而，手动为每篇文章添加标签不仅耗时，还容易导致标签不一致的问题。本文将详细介绍如何在Sanity内容管理系统中实现自动标签功能，帮助内容团队提升工作效率。

自动标签功能概述

自动标签功能通过AI分析文章内容，智能生成3个相关标签，并优先复用系统中已存在的标签，确保标签词汇的一致性。该功能主要特点包括：

1. 自动化处理：在文章发布时自动触发
2. 智能分析：基于文章内容生成相关标签
3. 一致性维护：优先使用现有标签库中的词汇
4. 效率提升：每篇文章可节省2-3分钟手动操作时间

准备工作

在开始实现前，请确保满足以下条件：

1. 已创建Sanity项目并启用Functions功能
2. 项目Schema中包含post文档类型，且该类型包含：
   • content字段（用于内容分析的便携文本）
   • tags数组字段（用于存储生成的标签）
3. 本地开发环境使用Node.js v22.x版本
4. 拥有Sanity AI功能访问权限

实现步骤

第一步：添加标签字段

如果使用官方"clean"模板，需要先添加tags字段：

1. 打开studio/src/schemaTypes/documents/post.ts文件
2. 在fields数组中添加以下字段定义：

defineField({
  name: 'tags',
  title: 'Tags',
  type: 'array',
  of: [{ type: 'string' }],
  description: '文章发布时将自动生成标签',
}),

3. 部署更新后的Schema：

# 在studio目录下执行
npx sanity schema deploy

第二步：初始化自动标签功能

根据项目情况选择初始化方式：

新项目初始化：

npx sanity blueprints init --example auto-tag

现有项目添加功能：

npx sanity blueprints add function --example auto-tag

第三步：配置蓝图文件

在sanity.blueprint.ts中添加以下配置：

import {defineBlueprint, defineDocumentFunction} from '@sanity/blueprints'

export default defineBlueprint({
  resources: [
    defineDocumentFunction({
      type: 'sanity.function.document',
      name: 'auto-tag',
      src: './functions/auto-tag',
      memory: 2,
      timeout: 30,
      event: {
        on: ['publish'],
        filter: "_type == 'post' && !defined(tags)",
        projection: '_id',
      },
    }),
  ],
})

第四步：安装依赖

1. 安装项目根依赖：

npm install

2. 安装功能特定依赖：

npm install @sanity/functions
cd functions/auto-tag
npm install
cd ../..

本地测试

在部署前，建议先在本地测试功能是否正常工作。

基础测试方法

1. 创建测试文档：

cd studio
npx sanity documents create ../functions/auto-tag/document.json --replace

2. 测试功能：

cd ..
npx sanity functions test auto-tag --file functions/auto-tag/document.json

使用真实文档测试

1. 导出已有文章：

cd studio
npx sanity documents query "*[_type == 'post' && !defined(tags)][0]" > ../real-post.json

2. 测试功能：

cd ..
npx sanity functions test auto-tag --file real-post.json

交互式开发模式

启动开发服务器进行交互式测试：

npx sanity functions dev

功能工作原理

当内容编辑发布新博客文章时，自动标签功能会：

1. 在发布事件触发时检查文章是否已有标签
2. 使用AI分析文章内容
3. 从其他已发布文章中检索现有标签
4. 生成3个相关标签，优先复用现有标签
5. 将标签直接应用到发布的文档中

自定义选项

调整标签生成数量

修改AI指令以改变标签生成行为：

instruction: `基于$content，生成5个相关标签(而非3个)，重点关注技术主题并使用驼峰命名法`

更改目标字段

更新目标路径将标签保存到不同字段：

target: {
  path: 'categories', // 替代'tags'
}

针对不同文档类型

修改蓝图过滤器以定位不同内容类型：

filter: "_type == 'article' && !defined(keywords)"

最佳实践建议

1. 测试覆盖率：确保测试各种内容类型的文章
2. 标签审核：初期可保留人工审核环节
3. 性能监控：关注AI处理时间，必要时调整超时设置
4. 词汇维护：定期检查自动生成的标签，必要时更新标签库

结语

通过实现Sanity自动标签功能，内容团队可以显著提升工作效率，同时确保标签系统的一致性和可用性。本文详细介绍了从准备到测试的完整流程，帮助开发者快速集成这一实用功能。