← Обзор / ai-search / configuration

Синхронизация

AI Search автоматически индексирует ваш контент для поиска. Способ индексирования зависит от источника данных.

Внешние источники данных

Для экземпляров, подключённых к сайт или Бакет R2, AI Search создаёт задания для синхронизации источника данных. Задания запускаются автоматически по расписанию, по умолчанию каждые 6 часов, и обрабатывают новые, изменённые или удалённые файлы, чтобы поисковый индекс оставался актуальным.

Просмотреть статус и историю заданий можно в Задания вкладку на dashboard или с помощью API экземпляров.

Интервал синхронизации

По умолчанию AI Search запускает задание синхронизации каждые 6 часов. Чтобы изменить частоту выполнения запланированных синхронизаций, используйте Интервал синхронизации настройку в dashboard, либо задайте sync_interval поле, когда вы создать или обновить экземпляр через привязку Workers или REST API.

Интервал может составлять 1, 2, 4, 6, 12 или 24 часа. В API sync_interval задаётся в секундах, поэтому допустимые значения: 3600 (1 час), 7200 (2 часа), 14400 (4 часа), 21600 (6 часов, по умолчанию), 43200 (12 часов) и 86400 (24 часа).

Запуск синхронизаций из автоматизированных конвейеров

Обычно задания синхронизации запускаются по расписанию, но вы можете также запустить синхронизацию программно при изменении исходного контента. Это удобно при подключении AI Search к CMS или контент-конвейеру: когда завершается событие публикации или этап сборки, запустите синхронизацию, чтобы индекс отразил изменения, не дожидаясь следующего запланированного запуска.

Запустите задание синхронизации с помощью Wrangler CLI, например из шага CI/CD или deploy hook:

npx wrangler ai-search jobs create <INSTANCE_NAME>

Либо вызовите REST API для создания задания от вебхука CMS или Worker. Задания синхронизации можно запускать не чаще одного раза в 30 секунд.

Встроенное хранилище

Файлы, загруженные в встроенное хранилище индексируются сразу же. Заданий синхронизации не существует. Каждый файл обрабатывается отдельно по мере загрузки.

Элементы управления

Действие	Описание
Запустить синхронизацию	Запустите задание синхронизации вручную, чтобы просканировать внешний источник данных на изменения. Может запускаться каждые 30 секунд.
Отменить задание	Отменить выполняющееся задание синхронизации.
Приостановка индексирования	Временно остановите все запланированные задания синхронизации.
Возобновить индексирование	Возобновление запланированных заданий синхронизации, в том числе приостановленных автоматически из-за неактивности.
Синхронизация отдельного файла	Переиндексируйте конкретный файл.

Эти действия можно выполнить через dashboard, REST API, или привязка Workers.

Производительность

Общее время индексирования зависит от количества и типа файлов. На производительность влияют следующие факторы:

Общее количество файлов и их размеры
Форматы файлов (например, изображения обрабатываются дольше, чем обычный текст)
Задержка моделей Workers AI, используемых для встраивания и обработки изображений

Автоматическая приостановка неактивных экземпляров

Если экземпляр не получает запросов на поиск в течение 31 дня, AI Search автоматически приостанавливает запланированные задания синхронизации. Это применимо только к внешние источники данных (сайт или R2), так как встроенное хранилище не имеет заданий синхронизации. Это позволяет избежать лишних запросов к источнику данных на повторное сканирование и синхронизацию экземпляра, когда он не используется.

Приостановленный экземпляр остаётся полностью доступным для поиска, но изменения в источнике не отслеживаются, пока задания синхронизации приостановлены. После того как экземпляр снова начинает получать поисковый или чат-трафик, AI Search автоматически возобновляет запланированные задания синхронизации во время проверок активности. Вы также можете возобновить их вручную с помощью Возобновить индексирование настройку. См. Элементы управления.