元数据属性

使用元数据属性组织已索引文档，并提供上下文以指导 AI 响应。本页介绍内置元数据属性与自定义元数据 schema。要在查询时按这些属性筛选搜索结果，请参阅筛选。

AI Search 会自动从已索引文档中提取以下元数据属性：

自定义元数据允许你定义用于筛选搜索结果的额外字段。你可以将结构化元数据附加到文档，并按类别、版本或任意自定义字段筛选查询。

在提取自定义元数据之前，请在 AI Search 配置中使用 custom_metadata 字段定义 schema。schema 指定要提取的字段及其数据类型。

custom_metadata: [
	{ field_name: "category", data_type: "text" },
	{ field_name: "version", data_type: "number" },
	{ field_name: "is_public", data_type: "boolean" },
];

Schema 约束：

• 每个 AI Search 实例最多 5 个自定义元数据字段
• 字段名不区分大小写，并以小写存储
• 字段名不能使用保留名称：timestamp、folder、filename
• 文本值截断为 500 个字符
• 更改 schema 会触发所有文档的完整重新索引

如何附加自定义元数据属性取决于你的数据源：

• R2 存储桶：使用 S3 兼容的自定义标头（x-amz-meta-*）设置元数据。示例请参阅 R2 自定义元数据。
• 网站：在 HTML 页面中添加 <meta> 标签。详情请参阅网站自定义元数据。
• 内置存储：通过 Items API 上传文件时附加元数据。

当你修改 custom_metadata schema 时：

1. 新字段会添加到搜索索引。
2. 已移除的字段会从搜索索引中删除。
3. 对所有文档触发完整重新索引。
4. 现有向量会使用新的元数据结构更新。

如果文件元数据超出大小限制，元数据会替换为错误指示器：

{
	"file": { "error": "metadata is too large" }
}

为避免这种情况，请保持各个元数据值简洁。