INTEGRITY Dokumentace

← Přehled / ai-search / troubleshooting

Chybové kódy indexování

Poté, co AI Search přijme požadavek na nahrání, synchronizaci nebo procházení, zpracuje váš obsah na pozadí, aby jej bylo možné prohledávat. Pokud zpracování selže, AI Search zaznamená jeden z chybových kódů uvedených na této stránce. Některé chyby ovlivňují jedinou položku, jiné pozastaví celou instanci.

Protože toto zpracování probíhá až po úspěšném dokončení požadavku, chyby se v původní odpovědi API nevracejí. Najdete je v protokoly položek, podrobnosti položky nebo statistiky instance. Chyby vrácené okamžitě při selhání požadavku jsou zdokumentované samostatně v Chybové kódy API.

Jak se vracejí chyby

Chyby při indexování jsou asynchronní: požadavek na nahrání, synchronizaci nebo procházení může být úspěšný, ale obsah může později selhat, zatímco ho AI Search zpracovává. Dělí se do dvou kategorií:

Chcete-li zopakovat pokus u jedné neúspěšné položky, zkontrolujte protokoly položek, opravte případný zjevný problém se zdrojem nebo konfigurací a poté synchronizovat položku znovu. U datových zdrojů typu web a R2 můžete také spustit úloha synchronizace zdroje.

Pokud je instance pozastavená, vyřešte příčinu problému a poté instanci obnovte.

Pokud přechodná chyba přetrvává i po opakovaném pokusu, kontaktování podpory Cloudflare s ID položky, ID instance, kódem chyby a časovým razítkem požadavku.

Chyby na úrovni položky

Tyto chyby ovlivňují jedinou položku. Položka se přesune do status: "error" zatímco zbytek instance dál indexuje. Opravte danou položku nebo to zkuste znovu.

Soubor a obsah

Tyto chyby se objeví, když AI Search nemůže přečíst, převést, rozdělit na části nebo vektorizovat zdrojový soubor. Podporované formáty a limity velikosti souborů najdete v Zdroj dat. Informace o limitech dělení na části obsahu a limitech modelu najdete v Rozdělování na části a Podporované modely.

Chyba Podrobnosti Doporučená akce
unknown_error Došlo k neočekávané chybě při zpracování. Zkontrolujte protokoly položek pro neúspěšný krok a poté synchronizovat položku znovu. Pokud chyba přetrvává, kontaktujte podporu.
over_size Soubor překračuje maximální povolenou velikost. Zmenšete velikost souboru, rozdělte soubor nebo ho vylučte. Zkontrolujte limity souborů.
unsupported_type Typ souboru není podporován. Převeďte soubor na podporovaný typ souboru, poté ho znovu nahrajte nebo synchronizujte.
file_not_found Soubor nebyl ve zdroji nalezen. Obnovte zdrojový soubor a poté synchronizovat položku nebo spustit úloha synchronizace zdroje. Pokud byl soubor smazán záměrně, spusťte synchronizaci zdroje, aby AI Search mohl aktualizovat index.
invalid_url URL adresa souboru je neplatná. Opravte adresu URL v zdroj dat webu nebo sitemapu a poté spusťte úlohu synchronizace zdroje.
file_is_corrupt Soubor je poškozený. Nahraďte soubor nepoškozenou kopií a poté ho znovu nahrajte nebo synchronizujte.
file_is_password_locked Soubor je zašifrovaný nebo vyžaduje heslo, než z něj AI Search dokáže načíst obsah. Odeberte heslo, nahrajte odemčenou kopii a poté položku znovu synchronizujte.
invalid_pdf AI Search se nepodařilo analyzovat soubor jako platný PDF. Nahrajte PDF, které se otevírá správně, nebo obsah převeďte do jiného podporovaný typ souboru.
unable_to_convert_to_markdown AI Search se nepodařilo převést soubor na text. Použijte podporovaný typ souboru nebo nahradit naskenovaný obsah extrahovatelným textem.
markdown_too_large AI Search převedla soubor, ale vygenerovaný Markdown překročil limity zpracování AI Search. Pokud je zdrojový soubor v rámci Limity souborů AI Search, kontaktujte podporu. Jako řešení rozdělte zdroj na menší soubory, pokud je to možné.
markdown_conversion_empty AI Search převedla soubor, ale převod nevrátil žádný použitelný text. Ujistěte se, že soubor obsahuje extrahovatelný text. Naskenované soubory nebo soubory obsahující pouze obrázky žádný text neposkytují, proto přidejte textovou vrstvu nebo nahrajte verzi založenou na textu.
file_content_empty Soubor je prázdný nebo obsahuje pouze nadpisy. Přidejte prohledávatelný obsah, poté soubor znovu nahrajte nebo synchronizujte.
chunk_too_large_for_storage AI Search vygenerovala část obsahu, která překročila interní limity úložiště. Nižší velikost části pokud jste nastavili vysokou hodnotu. Pokud položka stále selhává, kontaktujte podporu.
timeout_error Vypršel časový limit zpracování položky. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
file_length_exceed_embedding_model Soubor je pro embedding model příliš dlouhý. Použijte menší zdrojový soubor, nebo kontaktujte podporu pokud je soubor v rámci dokumentovaných limitů.
file_too_large_for_embedder Soubor překračuje maximální velikost v bajtech, kterou embedding model akceptuje. Použijte menší zdrojový soubor, nebo kontaktujte podporu pokud je soubor v rámci dokumentovaných limitů.

Procházení webu

Tyto chyby se objeví, když AI Search nemůže načíst, vykreslit nebo zahrnout stránku z zdroj dat webu. AI Search použije Browser Run na pozadí, aby procházel a vykresloval stránky, a spravuje ji za vás.

Chyba Podrobnosti Doporučená akce
too_many_redirects Crawler následoval příliš mnoho přesměrování nebo narazil na smyčku přesměrování. Opravte řetězec přesměrování pro zdroj dat webu, poté spusťte synchronizační úlohu zdroje.
invalid_host_after_redirect Stránka byla přesměrována na hostitelský název mimo aktuální rozsah procházení. Zkontrolujte cíl přesměrování v protokolech položky. Pokud by měl být tento cíl zaindexován, kontaktujte podporu. Jinak vylučte původní URL adresu pomocí filtrování cest.
subdomains_not_allowed Adresa URL je mimo hostitelské názvy, které může AI Search procházet pro tento zdroj dat typu web. Pokud má být tato URL adresa instancí zaindexovaná, kontaktujte podporu. Jinak ho vylučte pomocí filtrování cest.
blocked_by_robots_txt robots.txt zakázal procházení. Aktualizujte robots.txt takže platí AI Search crawler mohou přistupovat k webu.
blocked_by_robots_txt_path robots.txt zakázal cestu. Povolte cestu v robots.txt, nebo ji vylučte pomocí filtrování cest pokud si nepřejete, aby byla indexována.
blocked_by_content_signal Web zablokoval procházení pomocí Content Signals. Přečtěte si direktivy Content Signals v robots.txt. Pokud obsah nemá být indexován, vylučte ho pomocí filtrování cest.
excluded_by_path_filter Váš filtr cest položku vyloučil. Zkontrolujte pravidla pro zahrnutí a vyloučení zda má být položka indexována.
network_connection_lost Síťové připojení bylo přerušeno. Znovu synchronizujte položku. Pokud chyba přetrvává, zkontrolujte, zda je zdroj dostupný.
crawl_got_http_error Crawler obdržel chybu HTTP. Zkontrolujte stav HTTP v protokolech položky. Opravte odpověď origin serveru nebo řízení přístupu a poté spusťte synchronizační úlohu zdroje.
crawl_got_http_401 Crawler obdržel 401 Unauthorized. Zpřístupněte stránku crawleru. U chráněných stránek nakonfigurujte ověřovací hlavičky nebo přihlašovací údaje služby Cloudflare Access.
crawl_got_http_403 Crawler obdržel 403 Forbidden. Povolte AI Search crawler přes vaše řízení přístupu a firewall origin serveru.
crawl_got_http_429 Origin server odmítl crawler kvůli rate limitu. Povolte AI Search crawler, zvyšte limit originů, nebo zúžete rozsah procházení pomocí filtrování cest.
blocked_by_payment Web vrátil 402 Payment Required. Stránku vylučte filtrováním cest. AI Search nepodporuje placené procházení.
blocked_by_waf Web aplikační firewall (WAF) zablokoval prohledávač. Povolte AI Search crawler ve vašem WAF.
blocked_by_bot_management Ochrana proti botům zablokovala prohledávač. Povolte AI Search crawler v nastavení ochrany proti botům.
blocked_by_turnstile Turnstile zablokoval crawler. Povolte AI Search crawler, nebo stránku vylučte pomocí filtrování cest.
http_4xx Web vrátil chybu HTTP 4xx. Zkontrolujte přesný stav v protokolech položky. Opravte adresu URL nebo řízení přístupu, případně stránku vylučte pomocí filtrování cest.
http_5xx Web vrátil chybu HTTP 5xx. Napravte stav origin serveru a poté položku synchronizujte nebo spusťte úlohu synchronizace zdroje.
unreachable_timeout Crawler se ke stránce nedostal před vypršením časového limitu. Zkontrolujte latenci origin serveru, pravidla firewallu a dostupnost stránky, poté spusťte synchronizační úlohu zdroje.
unreachable_dns Zdrojovou doménu se nepodařilo přeložit. Zkontrolujte DNS záznamy pro zdrojovou doménu.
page_limit_reached Spravovaný crawler dosáhl denního limitu stránek pro váš plán, takže některé stránky nebyly při tomto běhu procházeny. Přejděte na Workers Paid pro neomezené denní procházení, nebo omezte počet stránek v rozsahu pomocí filtrování cest. Plány Free prochází až 500 stránek denně. Více informací najdete v limity.
browser_rendering_unknown_error Browser Run vrátil neznámou chybu. Spusťte úloha synchronizace zdroje znovu. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud stejná stránka stále selhává.
browser_rendering_authentication_error Browser Run vyžadoval ověření. Nakonfigurujte ověřovací hlavičky pro chráněné stránky, nebo stránku vylučte.
browser_rendering_no_body_status_error Browser Run nevrátil žádný obsah stránky, který by AI Search mohl zaindexovat. Pokud má být stránka zaindexovaná, kontaktujte podporu. Jinak vylučte stránku pomocí filtrování cest.
browser_rendering_timeout_error U Browser Run vypršel časový limit. Spusťte úloha synchronizace zdroje znovu. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
browser_rendering_network_connection_closed_error Připojení prohlížeče se během vykreslování zavřelo. Spusťte úloha synchronizace zdroje znovu. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
browser_rendering_server_refused_connection_error Origin server odmítl připojení prohlížeče. Povolte AI Search crawler přes síťová pravidla vašeho origin serveru a poté spusťte synchronizaci zdroje.
browser_rendering_rate_limit_error Browser Run narazil na limit četnosti požadavků. Spusťte úloha synchronizace zdroje později. Pokud chyba přetrvává, kontaktujte podporu.

Modely a AI Gateway

Tyto chyby se objeví, když embedding modely, Workers AI, externí poskytovatele, nebo AI Gateway nedokáže zpracovat obsah položky.

Chyba Podrobnosti Doporučená akce
error_embedding_data_with_workers_ai Workers AI se nepodařilo vygenerovat embeddingy. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
workers_ai_invalid_input Workers AI odmítla vstup. Zkontrolujte obsah souboru, typ souboru a podpora embedding modelu.
workers_ai_free_allocation_exceeded Byla překročena alokace pro free tier Workers AI. Zkontrolujte Ceny Workers AI a počkejte na reset alokace, nebo si upgradujte plán Workers.
workers_ai_internal_error Workers AI vrátila interní chybu. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
workers_ai_out_of_capacity_error Kapacita Workers AI nebyla k dispozici. Zkuste to později znovu a projděte si Limity Workers AI.
workers_ai_timeout_error Vypršel časový limit pro Workers AI. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
error_external_model_unknown_error Externí embedding model vrátil neznámou chybu. Zkontrolujte stav poskytovatele a Protokoly AI Gateway, poté položku znovu synchronizujte.
error_external_model_rate_limited Externí embedding model uplatnil na požadavek omezení počtu požadavků. Spusťte úloha synchronizace zdroje později, nebo zvyšte rate limit u svého poskytovatele modelu. Zkontrolujte Protokoly AI Gateway pro odpověď poskytovatele.
error_external_model_unauthorized Externí embedding model odmítl autentizaci. Zkontrolujte přihlašovací údaje poskytovatele v AI Gateway, poté položku znovu synchronizujte.
ai_gateway_request_blocked_firewall AI Gateway Guardrails zablokovaly požadavek. Zkontrolujte AI Gateway Guardrails nastavení promptu pro nakonfigurovaný gateway a poté znovu spusťte úlohu synchronizace zdroje.
ai_gateway_dlp_blocked AI Gateway Data Loss Prevention (DLP) zablokoval obsah. Zkontrolujte Nastavení DLP v AI Gateway a obsah položky.
ai_gateway_response_blocked_firewall AI Gateway Guardrails zablokovaly odpověď. Zkontrolujte AI Gateway Guardrails nastavení odpovědi pro nakonfigurovaný gateway a poté znovu spusťte úlohu synchronizace zdroje.
ai_gateway_rate_limited AI Gateway požadavek odmítla kvůli rate limitu. Spusťte úloha synchronizace zdroje později. Pokud chyba přetrvává, kontaktujte podporu.

Úložiště a Vectorize

Tyto chyby se objeví, když se nezdaří uložení nebo indexace položky, nebo když instance dosáhne limitu kapacity. AI Search používá Vectorize na pozadí, aby ukládal vektory, a spravuje ji za vás.

Chyba Podrobnosti Doporučená akce
r2_unknown_error R2 vrátil neznámou chybu. Spusťte úloha synchronizace zdroje znovu. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
r2_internal_error R2 vrátil interní chybu. Spusťte úloha synchronizace zdroje znovu. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
vectorize_rate_limited Vectorize omezil operaci limitem četnosti požadavků. Spusťte úloha synchronizace zdroje později. Pokud chyba přetrvává, kontaktujte podporu.
vectorize_ingestion_timeout Vectorize nezpracoval mutaci včas. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
vectorize_upstream_error Vectorize vrátil dočasnou chybu podkladové služby. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
hybrid_search_indexing_failed Indexování hybridního vyhledávání selhalo. Znovu synchronizujte položku. Zkontrolujte Cloudflare Status ↗ a kontaktujte podporu pokud chyba přetrvává.
ai_search_is_full Instance AI Search je plná. Na rozdíl od plného indexu hybridního vyhledávání to instanci nepozastaví. Požádat o vyšší limit ↗ pro instanci, nebo vytvořte další instanci pro indexování dalšího obsahu. Viz limity.

Chyby na úrovni instance

Tyto chyby pozastaví celou instanci a zastaví veškerou indexaci, dokud nebude vyřešena základní příčina a instance nebude obnovena. Liší se od ručního pozastavení nebo automatického pozastavení po období nečinnosti.

Chyba Podrobnosti Doporučená akce
r2_not_enabled Pozastaví instanci. R2 není pro tento účet povoleno. Povolit R2 pro účet a poté obnovte instanci.
bucket_not_found Pozastaví instanci. Zdrojový R2 bucket nebyl nalezen. Zkontrolujte Zdroj dat R2 název bucketu a účet, poté instanci obnovte.
bucket_unauthorized Pozastaví instanci. AI Search nemá přístup k R2 bucketu. Zkontrolujte servisní token API a oprávnění k bucketu R2 a poté instanci obnovte.
external_source_missing_api_token Pozastaví instanci. Externímu zdroji chybí přihlašovací údaje API. Přidejte nebo aktualizujte servisní token API, poté instanci obnovte.
bucket_name_invalid Pozastaví instanci. Název R2 bucketu je neplatný. Použijte platný název bucketu bez velkých písmen a podtržítek, aktualizujte zdroj dat R2 a poté instanci obnovte.
invalid_custom_header Pozastaví instanci. Vlastní hlavička procházení je neplatná. Odeberte nebo aktualizujte ověřovací hlavička, poté instanci obnovte.
ai_gateway_not_configured Pozastaví instanci. Nastavená AI Gateway pro tuto instanci nebyla nalezena. Aktualizujte instance ai_gateway_id na existující gateway v AI Gateway, poté instanci obnovte.
hybrid_search_is_full Pozastaví instanci. Index hybridního vyhledávání je plný. Jeho limit počtu souborů je nižší než standardní limit instance, takže ho lze dosáhnout dříve. Požádat o vyšší limit ↗ a obnovte tak instanci, nebo vytvořte další instanci pro indexování dalšího obsahu. Více informací v limity.