跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

同步

最后更新 查看 MarkdownAgent 设置

AI Search 会自动为你的内容建立索引以供搜索。索引的工作方式取决于你的数据源。

外部数据源

对于连接到网站或 R2 存储桶的实例,AI Search 会创建作业以同步数据源。作业默认按计划每 6 小时自动运行,并处理新增、修改或删除的文件,以保持搜索索引最新。

你可以在仪表板的 Jobs 标签中查看作业状态和历史记录,也可以使用 Instances API。

同步间隔

默认情况下,AI Search 每 6 小时运行一次同步作业。要更改计划同步的频率,请在仪表板中使用 Sync interval 设置,或在通过 Workers 绑定或 REST API 创建或更新实例时设置 sync_interval 字段。

间隔可以设置为 15 分钟、30 分钟、1 小时、2 小时、4 小时、6 小时、12 小时或 24 小时。在 API 中,sync_interval 以秒为单位。允许的值为 900、1800、3600、7200、14400、21600(默认值)、43200 和 86400。

从自动化流水线触发同步

同步作业通常按计划运行,但也可以在源内容变更时以编程方式启动。这有助于将 AI Search 连接到 CMS 或内容流水线:当发布事件或构建步骤完成时,触发同步,使索引无需等待下一次计划运行即可反映变更。

使用 Wrangler CLI 触发同步作业,例如在 CI/CD 步骤或部署钩子中:

npx wrangler ai-search jobs create <INSTANCE_NAME>

或从 CMS webhook 或 Worker 调用 Create job REST API。同步作业最多每 30 秒触发一次。

内置存储

上传到内置存储的文件会立即建立索引。没有同步作业。每个文件在上传时单独处理。

控制操作

操作 描述
触发同步 手动启动同步作业,扫描外部数据源的变更。每 30 秒可触发一次。
取消任务 取消正在运行的同步作业。
暂停索引 暂时停止所有计划的同步作业。
恢复索引 恢复计划的同步作业,包括因不活动而自动暂停的作业。
同步单个文件 重新索引特定文件。

你可以从仪表板、REST API 或 Workers 绑定 执行这些操作。

性能

建立索引的总时间取决于文件数量和类型。影响性能的因素包括:

  • 文件总数及其大小
  • 文件格式(例如,图像比纯文本耗时更长)
  • 用于嵌入和图像处理的 Workers AI 模型延迟

非活动实例的自动暂停

如果实例连续 31 天未收到搜索请求,AI Search 会自动暂停其计划的同步作业。这仅适用于外部数据源(网站或 R2),因为内置存储没有同步作业。这可避免在实例未被使用时,对数据源发起不必要的重新扫描和同步请求。

已暂停的实例仍可完整搜索,但在同步作业暂停期间不会拾取源变更。当实例再次收到搜索或聊天流量后,AI Search 会在活动检查期间自动恢复计划的同步作业。你也可以使用 Resume indexing 控件手动恢复。请参阅控制操作。

最佳实践

为确保索引顺畅可靠:

这篇文档对您有帮助吗?