← Cloudflare AI Gateway / ai-gateway

Slovník hlaviček

AI Gateway podporuje řadu hlaviček, které vám pomohou konfigurovat, upravovat a spravovat požadavky API. Tato stránka obsahuje úplný seznam všech podporovaných hlaviček s krátkým popisem

Pojem	Definice
cf-aig-backoff	Hlavička pro přizpůsobení typu prodlevy (backoff) pro opakování požadavků požadavku.
cf-aig-cache-key	cf-aig-cache-key-aig-cache-key umožňují přepsat výchozí klíč mezipaměti a přesně nastavit možnost ukládání do mezipaměti pro libovolný prostředek.
cf-aig-cache-status	Indikátor stavu cachování, která ukazuje, zda byl požadavek obsloužen z mezipaměti.
cf-aig-cache-ttl	Určuje doba platnosti mezipaměti pro odpovědi.
cf-aig-collect-log	cf-aig-collect-log hlavička umožňuje obejít výchozí nastavení protokolování brány.
cf-aig-custom-cost	Umožňuje přizpůsobení nákladů na požadavek tak, aby odrážel parametry definované uživatelem.
cf-aig-dlp	Hlavička odpovědi, která se vrátí, když Zásada DLP odpovídá požadavku nebo odpovědi. Obsahuje JSON s provedenou akcí (Flag nebo Block), ID shodných zásad, ID shodných profilů a ID záznamů detekce.
cf-aig-event-id	cf-aig-event-id je jedinečný identifikátor události, který slouží ke sledování konkrétních událostí v systému.
cf-aig-log-id	cf-aig-log-id je jedinečný identifikátor konkrétního záznamu protokolu, ke kterému chcete přidat zpětnou vazbu.
cf-aig-max-attempts	Hlavička pro přizpůsobení maximálního počtu pokusů pro opakování požadavků požadavku.
cf-aig-metadata	Vlastní metadataumožňuje označovat požadavky ID uživatelů nebo jinými identifikátory, což zlepšuje sledování a analýzu vašich požadavků.
cf-aig-request-timeout	Hlavička pro nastavení časový limit požadavku (v milisekundách). Pokud poskytovatel v tomto čase neodpoví, požadavek vrátí chybu.
cf-aig-retry-delay	Hlavička pro přizpůsobení prodlevy mezi opakováními pro opakování požadavků požadavku.
cf-aig-skip-cache	Hlavička pro obejít mezipaměť pro konkrétní požadavek.
cf-aig-step	Hlavička odpovědi cf-aig-step určuje, který krok v toku požadavku jej úspěšně zpracoval, což se hodí pro sledování a ladění.
cf-cache-ttl	Zastaralé: Tuto hlavičku nahrazuje `cf-aig-cache-ttl`. Určuje dobu platnosti záznamu v cache (TTL).
cf-skip-cache	Zastaralé: Tuto hlavičku nahrazuje `cf-aig-skip-cache`. Obchází ukládání do cache pro konkrétní požadavek.

Hierarchie konfigurace

Nastavení v AI Gateway lze konfigurovat na dvou úrovních: Požadavek a Gateway. Protože stejná nastavení lze konfigurovat na více místech, o tom, která hodnota se použije, rozhoduje následující hierarchie:

Hlavičky na úrovni požadavku: Hlavičky zahrnuté v jednotlivých požadavcích mají přednost před nastavením na úrovni gateway.
Nastavení na úrovni gateway: Slouží jako výchozí nastavení, pokud nejsou na úrovni požadavku nastaveny žádné hlavičky.

Tato hierarchie zajišťuje konzistentní chování a upřednostňuje nejkonkrétnější konfigurace. Pro jemné doladění použijte hlavičky na úrovni požadavku, obecné výchozí hodnoty pak zajistí nastavení gateway.