INTEGRITY Документация

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

Коды ошибок индексации

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

Поскольку эта обработка происходит уже после успешного выполнения запроса, ошибки не возвращаются в исходном ответе API. Чтобы их найти, проверьте журналы элемента, сведения об элементе или статистику экземпляра. Ошибки, которые возвращаются сразу при сбое запроса, задокументированы отдельно в Коды ошибок API.

Как возвращаются ошибки

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

Чтобы повторить попытку для одного неудавшегося элемента, посмотрите журналы элемента, устраните очевидную проблему с источником данных или конфигурацией, затем синхронизировать элемент ещё раз. Для источников данных типа «сайт» и R2 также можно запустить задание синхронизации источника.

Если экземпляр приостановлен, устраните причину, а затем возобновите его работу.

Если временная ошибка сохраняется после повторных попыток, обратитесь в службу поддержки Cloudflare с ID элемента, ID экземпляра, кодом ошибки и временной меткой запроса.

Ошибки на уровне элемента

Эти ошибки затрагивают один элемент. Он переходит в status: "error" пока остальная часть экземпляра продолжает индексироваться. Исправьте элемент или повторите попытку.

Файл и содержимое

Эти ошибки возникают, если AI Search не может прочитать, преобразовать, разбить на чанки или векторизовать исходный файл. Поддерживаемые форматы и ограничения по размеру файла см. Источник данных. Сведения об ограничениях на чанкинг и на модель приведены в Чанкинг и Поддерживаемые модели.

Ошибка Подробности Рекомендуемое действие
unknown_error Произошла непредвиденная ошибка обработки. Проверьте журналы элемента для неудавшегося шага, а затем синхронизировать элемент ещё раз. Если ошибка не исчезает, обратиться в поддержку.
over_size Файл превышает максимально допустимый размер. Уменьшите размер файла, разделите его на части или исключите его. Ознакомьтесь с лимиты на файлы.
unsupported_type Тип файла не поддерживается. Преобразуйте файл в поддерживаемый тип файла, затем снова загрузите или синхронизируйте его.
file_not_found Файл не найден в источнике. Восстановите исходный файл, а затем синхронизировать элемент или запустить задание синхронизации источника. Если файл был удалён намеренно, запустите синхронизацию источника, чтобы AI Search мог обновить индекс.
invalid_url URL файла недействителен. Исправьте URL-адрес в источник данных веб-сайта или sitemap, а затем запустите задание синхронизации источника.
file_is_corrupt Файл повреждён. Замените файл неповреждённой копией, затем снова загрузите или синхронизируйте его.
file_is_password_locked Файл зашифрован или защищён паролем, поэтому AI Search не может прочитать его содержимое. Удалите пароль, загрузите разблокированную копию, затем синхронизируйте элемент снова.
invalid_pdf AI Search не удалось разобрать файл как корректный PDF. Загрузите корректно открывающийся PDF или преобразуйте контент в другой поддерживаемый тип файла.
unable_to_convert_to_markdown AI Search не удалось преобразовать файл в текст. Используйте поддерживаемый тип файла или заменить отсканированный контент извлекаемым текстом.
markdown_too_large AI Search преобразовал файл, но объём получившегося Markdown превысил лимиты обработки AI Search. Если исходный файл находится в пределах Лимиты файлов AI Search, обратиться в поддержку. В качестве обходного решения разделите источник на файлы меньшего размера, если это возможно.
markdown_conversion_empty AI Search преобразовал файл, но в результате не получилось пригодного для использования текста. Убедитесь, что файл содержит извлекаемый текст. В отсканированных файлах и файлах, состоящих только из изображений, текст отсутствует, поэтому добавьте текстовый слой или загрузите версию с текстом.
file_content_empty Файл пуст или содержит только заголовки. Добавьте доступное для поиска содержимое, а затем повторно загрузите файл или синхронизируйте его.
chunk_too_large_for_storage AI Search сгенерировал чанк, превышающий внутренние лимиты хранения. Ниже размер чанка если вы задали высокое значение. Если элемент всё равно не обрабатывается, обратиться в поддержку.
timeout_error Время ожидания обработки элемента истекло. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
file_length_exceed_embedding_model Файл слишком длинный для embedding-модели. Используйте исходный файл меньшего размера или обратиться в поддержку если файл соответствует документированным ограничениям.
file_too_large_for_embedder Размер файла в байтах превышает максимально допустимый для embedding-модели. Используйте исходный файл меньшего размера или обратиться в поддержку если файл соответствует документированным ограничениям.

Обход сайта

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

Ошибка Подробности Рекомендуемое действие
too_many_redirects Краулер выполнил слишком много редиректов или обнаружил цикл редиректов. Исправьте цепочку перенаправлений для источник данных веб-сайта, затем запустите задание синхронизации источника.
invalid_host_after_redirect Страница перенаправлена на имя хоста за пределами текущей области сканирования. Проверьте журналы элемента на предмет цели перенаправления. Если эту цель нужно индексировать, обратиться в поддержку. В противном случае исключите исходный URL-адрес с помощью фильтрация по пути.
subdomains_not_allowed URL находится за пределами имён хостов, которые AI Search может сканировать для этого источника данных веб-сайта. Если этот URL должен быть проиндексирован экземпляром, обратиться в поддержку. В противном случае исключите его с помощью фильтрация по пути.
blocked_by_robots_txt robots.txt запретил обход. Обновите robots.txt так что Краулер AI Search могут получить доступ к сайту.
blocked_by_robots_txt_path robots.txt запретил путь. Разрешите путь в robots.txt, или исключите его с помощью фильтрация по пути если не хотите, чтобы он индексировался.
blocked_by_content_signal Сайт заблокировал сканирование с помощью Content Signals. Ознакомьтесь с директивами Content Signals в robots.txt. Если контент не должен индексироваться, исключите его с помощью фильтрации путей.
excluded_by_path_filter Фильтр путей исключил этот элемент. Проверьте правила включения и исключения если элемент должен быть проиндексирован.
network_connection_lost Сетевое соединение было прервано. Синхронизируйте элемент повторно. Если ошибка сохраняется, проверьте доступность источника.
crawl_got_http_error Краулер получил ошибку HTTP. Проверьте журналы элемента на наличие статуса HTTP. Исправьте ответ исходного сервера или настройки доступа, затем запустите задание синхронизации источника.
crawl_got_http_401 Краулер получил 401 Unauthorized. Сделайте страницу доступной для краулера. Для защищённых страниц настройте заголовки аутентификации или учётные данные службы Cloudflare Access.
crawl_got_http_403 Краулер получил 403 Forbidden. Разрешите Краулер AI Search через ваши средства управления доступом и файрвол исходного сервера.
crawl_got_http_429 Исходный сервер ограничил скорость краулера. Разрешите Краулер AI Search, увеличьте лимит источников, или сузьте область сканирования с помощью фильтрация по пути.
blocked_by_payment Сайт вернул 402 Payment Required. Исключите страницу с помощью фильтрации по пути. AI Search не поддерживает платные обходы.
blocked_by_waf Веб-межсетевой экран (WAF) заблокировал crawler. Разрешите Краулер AI Search в вашем WAF.
blocked_by_bot_management Защита от ботов заблокировала краулер. Разрешите Краулер AI Search в настройках защиты от ботов.
blocked_by_turnstile Turnstile заблокировал краулер. Разрешите Краулер AI Search, или исключите страницу с помощью фильтрация по пути.
http_4xx Сайт вернул ошибку HTTP 4xx. Проверьте журналы элемента, чтобы узнать точный статус. Исправьте URL или настройки доступа либо исключите страницу с помощью фильтрации по пути.
http_5xx Сайт вернул ошибку HTTP 5xx. Устраните проблему с исходным сервером, а затем синхронизируйте элемент или запустите задание синхронизации источника.
unreachable_timeout Краулер не смог обратиться к странице до истечения тайм-аута. Проверьте задержку исходного сервера, правила брандмауэра и доступность страницы, затем запустите задание синхронизации источника.
unreachable_dns Исходный домен не удалось разрешить. Проверьте DNS-записи для исходного домена.
page_limit_reached Управляемый краулер достиг дневного лимита страниц вашего тарифного плана, поэтому часть страниц не была просканирована в этом запуске. Перейдите на тариф Workers Paid, чтобы снять ограничение на ежедневный обход, или сократите количество страниц в области обхода с помощью фильтрация по пути. Планы Free обходят до 500 страниц в день. Подробнее см. в ограничения.
browser_rendering_unknown_error Browser Run вернул неизвестную ошибку. Запустите задание синхронизации источника ещё раз. Проверьте Cloudflare Status ↗ и обратиться в поддержку если одна и та же страница продолжает завершаться ошибкой.
browser_rendering_authentication_error Для Browser Run потребовалась аутентификация. Настройте заголовки аутентификации для защищённых страниц, либо исключите страницу.
browser_rendering_no_body_status_error Browser Run не вернул содержимое страницы для индексирования AI Search. Если страницу нужно проиндексировать, обратиться в поддержку. В противном случае исключите страницу с помощью фильтрация по пути.
browser_rendering_timeout_error Время ожидания Browser Run истекло. Запустите задание синхронизации источника ещё раз. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
browser_rendering_network_connection_closed_error Соединение с браузером было закрыто во время рендеринга. Запустите задание синхронизации источника ещё раз. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
browser_rendering_server_refused_connection_error Исходный сервер отказал в подключении браузера. Разрешите Краулер AI Search через сетевые настройки вашего исходного сервера, а затем запустите задание синхронизации источника.
browser_rendering_rate_limit_error Browser Run превысил ограничение скорости запросов. Запустите задание синхронизации источника позже. Если ошибка не исчезает, обратиться в поддержку.

Модели и AI Gateway

Эти ошибки возникают, когда embedding-модели, Workers AI, внешних провайдеров, или AI Gateway не может обработать содержимое элемента.

Ошибка Подробности Рекомендуемое действие
error_embedding_data_with_workers_ai Workers AI не удалось сгенерировать эмбеддинги. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
workers_ai_invalid_input Workers AI отклонил входные данные. Проверьте содержимое файла, тип файла и поддержка embedding-моделей.
workers_ai_free_allocation_exceeded Превышена квота бесплатного тарифа Workers AI. Проверьте Цены Workers AI и дождитесь сброса выделенных ресурсов, либо перейдите на более высокий план Workers.
workers_ai_internal_error Workers AI вернул внутреннюю ошибку. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
workers_ai_out_of_capacity_error Мощность Workers AI была недоступна. Повторите попытку позже и ознакомьтесь с Лимиты Workers AI.
workers_ai_timeout_error У Workers AI истекло время ожидания. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
error_external_model_unknown_error Внешняя embedding-модель вернула неизвестную ошибку. Проверьте статус провайдера и логи AI Gateway, затем синхронизируйте элемент снова.
error_external_model_rate_limited Внешняя embedding-модель ограничила частоту запросов. Запустите задание синхронизации источника позже, либо повысьте лимит скорости запросов у своего провайдера модели. Проверьте логи AI Gateway для ответа провайдера.
error_external_model_unauthorized Внешняя embedding-модель отклонила аутентификацию. Проверьте учётные данные провайдера в AI Gateway, затем синхронизируйте элемент снова.
ai_gateway_request_blocked_firewall AI Gateway Guardrails заблокировал запрос. Проверьте AI Gateway Guardrails настройки prompt для настроенного шлюза, а затем повторно запустите задание синхронизации источника.
ai_gateway_dlp_blocked AI Gateway Data Loss Prevention (DLP) заблокировал содержимое. Проверьте Настройки AI Gateway DLP и содержимое элемента.
ai_gateway_response_blocked_firewall AI Gateway Guardrails заблокировал ответ. Проверьте AI Gateway Guardrails настройки ответа для настроенного шлюза, а затем повторно запустите задание синхронизации источника.
ai_gateway_rate_limited AI Gateway ограничил скорость запроса. Запустите задание синхронизации источника позже. Если ошибка не исчезает, обратиться в поддержку.

Хранилище и Vectorize

Эти ошибки возникают при сбое сохранения или индексации элемента, а также при достижении экземпляром предела по ёмкости. AI Search использует Vectorize в фоновом режиме для хранения векторов и управляет этим процессом за вас.

Ошибка Подробности Рекомендуемое действие
r2_unknown_error R2 вернул неизвестную ошибку. Запустите задание синхронизации источника ещё раз. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
r2_internal_error R2 вернул внутреннюю ошибку. Запустите задание синхронизации источника ещё раз. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
vectorize_rate_limited Vectorize ограничил скорость операции. Запустите задание синхронизации источника позже. Если ошибка не исчезает, обратиться в поддержку.
vectorize_ingestion_timeout Vectorize не успел вовремя обработать мутацию. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
vectorize_upstream_error Vectorize вернул временную ошибку вышестоящего сервера. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
hybrid_search_indexing_failed Сбой индексации гибридного поиска. Синхронизируйте элемент повторно. Проверьте Cloudflare Status ↗ и обратиться в поддержку если ошибка не исчезает.
ai_search_is_full Экземпляр AI Search заполнен. В отличие от заполненного индекса гибридного поиска, это не приостанавливает работу экземпляра. Запросить более высокий лимит ↗ для экземпляра либо создайте другой экземпляр для индексации дополнительного содержимого. См. ограничения.

Ошибки на уровне экземпляра

Такие ошибки приостанавливают весь экземпляр и останавливают всю индексацию, пока не будет устранена причина и экземпляр не будет возобновлён. Это отличается от ручной приостановки и автоматической приостановки после периода бездействия.

Ошибка Подробности Рекомендуемое действие
r2_not_enabled Приостанавливает работу экземпляра. R2 не включён для этого аккаунта. Включить R2 для аккаунта, а затем возобновите работу экземпляра.
bucket_not_found Приостанавливает работу экземпляра. Исходный бакет R2 не найден. Проверьте Источник данных R2 имя bucket и аккаунт, а затем возобновите работу экземпляра.
bucket_unauthorized Приостанавливает работу экземпляра. AI Search не может получить доступ к бакету R2. Проверьте токен API службы и права доступа к бакету R2, а затем возобновите работу экземпляра.
external_source_missing_api_token Приостанавливает работу экземпляра. У внешнего источника отсутствуют учётные данные API. Добавьте или обновите токен API службы, затем возобновите работу экземпляра.
bucket_name_invalid Приостанавливает работу экземпляра. Имя бакета R2 недействительно. Используйте допустимое имя бакета без заглавных букв и знаков подчёркивания, обновите источник данных R2, а затем возобновите работу экземпляра.
invalid_custom_header Приостанавливает работу экземпляра. Пользовательский заголовок обхода недействителен. Удалите или обновите заголовок аутентификации, затем возобновите работу экземпляра.
ai_gateway_not_configured Приостанавливает работу экземпляра. AI Gateway, указанный для этого экземпляра, не найден. Обновите для экземпляра ai_gateway_id на существующий gateway в AI Gateway, затем возобновите работу экземпляра.
hybrid_search_is_full Приостанавливает работу экземпляра. Индекс гибридного поиска заполнен. Его лимит файлов ниже стандартного лимита экземпляра, поэтому он может быть достигнут раньше. Запросить более высокий лимит ↗ и таким образом возобновить работу инстанса, либо создайте другой инстанс для индексирования дополнительного содержимого. Подробнее см. в ограничения.