服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 至少产生三个分块的文本文档才符合摘要条件,转换后满足条件的 PDF 也包括在内。
- 系统保留已有 context,模型仍会生成适合放进分块的主题,这次模型调用仍计费。
- API 更新会整块替换 indexing_options。提交前读取实例配置,保留每项现有值后再改变 file_summary。
哪些文件会生成摘要?
Cloudflare 在 2026 年 11 月 17 日宣布可在索引时生成文件摘要。AI Search 会把文档切成小段,用于后续搜索。按实例当前分块大小,产生至少三个分块的文本文档才符合条件。满足条件的转换格式也可以,例如转换后的 PDF。
图像不走这一项文件摘要,小于三个分块的文档照常索引,这项功能不会为它们调用模型。把分块大小调小可能让更多文件达到门槛,预算也会随之变化。
摘要和主题分别放在哪里?
摘要和关键词在符合元数据大小限制时写入条目的 context,也就是检索结果交给生成模型时携带的上下文。若你已通过 R2 或上传元数据填了 context,AI Search 会保留这项内容。主题在空间允许时加到分块的上下文头部。
已有 context 的文件仍可能触发用于生成主题的计费调用。主题可能在多个分块里重复,提高关键词搜索中的权重。用代表性的查询比较开启前后的返回结果,再决定是否在正式实例中启用。
为什么不能只传一个开关更新?
可用控制台设置,或在创建与更新实例时把 indexing_options.file_summary 设为 true。该设置默认关闭。改变它会触发全量重索引,因此先估算重处理规模,为验证留出时间。
使用 API、Workers binding 或发送该配置的 Terraform 时,先读出实例当前值。更新会整块替换 indexing_options,省略的选项回到默认值。只改目标字段并带回其他现有选项,避免之后的更新漏传 file_summary,意外关掉摘要并再次触发重索引。
怎样判断成本和摘要缺失?
摘要调用通过实例关联的 AI Gateway 或默认网关发往 Workers AI,按 Workers AI 用量计费。AI Search 的索引用量额度不包含这些调用。按新建与改动的合格文件估算,并在你自己的 AI Gateway 日志核对使用模型与用量。后续同步通常复用未改动文件的摘要。
模型失败时,文件仍可被索引,只是没有摘要。先确认分块数量、网关和账户的用量限制,再看模型调用是否成功。Cloudflare 说明了按文件版本尝试、临时失败的重试条件以及网关限制的影响,单次重索引不能作为所有缺失摘要都已补齐的证据。
资料来源
常见问题
已有自定义 context,为什么仍会产生摘要调用费用?
系统保留已有 context,同时调用模型为合格文件生成主题。该调用仍记为 Workers AI 用量。
关闭文件摘要能避免再次重索引吗?
更改开关会触发全量重索引,包含关闭。先核对实例原有设置,并把这次重处理纳入变更计划。