← Přehled / ai-search / configuration / indexing

Atributy metadat

Pomocí atributů metadat organizujte indexované dokumenty a poskytujte kontext, který řídí odpovědi AI. Tato stránka popisuje vestavěné atributy metadat i vlastní schémata metadat. Filtrování výsledků vyhledávání podle těchto atributů v době dotazu najdete v Filtrování.

AI Search automaticky extrahuje z vašich indexovaných dokumentů následující atributy metadat:

Vlastní metadata umožňují definovat další položky pro filtrování výsledků vyhledávání. K dokumentům můžete připojit strukturovaná metadata a dotazy filtrovat podle atributů, jako je kategorie, verze nebo jakákoli vlastní položka.

Než bude možné vlastní metadata extrahovat, definujte v konfiguraci AI Search schéma pomocí custom_metadata je pole. Schéma určuje, která pole se mají extrahovat, a jejich datové typy.

custom_metadata: [
	{ field_name: "category", data_type: "text" },
	{ field_name: "version", data_type: "number" },
	{ field_name: "is_public", data_type: "boolean" },
];

Omezení schématu:

• Maximálně 5 vlastních polí metadat na instanci AI Search
• Názvy položek nerozlišují velká a malá písmena a ukládají se malými písmeny
• Názvy položek nesmí používat vyhrazené názvy: timestamp, folder, filename
• Změna schématu vyvolá úplné přeindexování všech dokumentů

Způsob připojení vlastních atributů metadat závisí na vašem zdroji dat:

• R2 bucket: Nastavte metadata pomocí vlastních hlaviček kompatibilních s S3 (x-amz-meta-*). Viz Vlastní metadata R2 příklady.
• Web: Přidat <meta> tagy na své HTML stránky. Více informací najdete v Vlastní metadata webu s podrobnostmi.
• Vestavěné úložiště: Připojte metadata při nahrávání souborů přes Items API.

Když upravíte custom_metadata schéma:

1. Do vyhledávacího indexu se přidají nová pole.
2. Odebraná pole se z vyhledávacího indexu odstraní.
3. Spustí se úplné přeindexování všech dokumentů.
4. Stávající vektory se aktualizují podle nové struktury metadat.

AI Search ukládá metadata pro každý vektor ve sdílené kompaktní obálce JSON UTF-8 o velikosti 10 KiB. Tato obálka zahrnuje názvy položek, syntaxi JSON, povinná systémová metadata AI Search a metadata zákazníka. Nejde o limit na jednotlivou položku.

Nakonfigurované vlastní položky mají přednost před nedeklarovanými metadaty zdroje. AI Search sestavuje metadata deterministicky a zachovává úplné hodnoty, které se vejdou. Pokud zbývá kapacita, nakonfigurované řetězcové hodnoty mohou být oříznuty na hranicích znaků UTF-8. Povinná metadata AI Search jsou vždy zachována.

Filtrovatelných je pouze prvních 64 bajtů UTF-8 každého zaindexovaného řetězce. Delší řetězce lze uložit, ale bajty za prvními 64 nejsou filtrovatelné. Podrobnosti k Vectorize najdete v Limity a Filtrování metadat.