Vektorová úložiště pro vyhledávání souborů

Objekty vektorového úložiště poskytují nástroji pro vyhledávání souborů možnost prohledávat soubory. Přidání souboru do vektorového úložiště poskytuje modelu Foundry agenta znalosti nad rámec trénovacích dat. Služba analyzuje, rozděluje na kusy, vkládá a indexuje soubor, aby nástroj mohl spustit vyhledávání klíčových slov včetně sémantického vyhledávání.

Vektorová úložiště mohou být připojena k agentům i konverzacím. V současné době můžete k agentovi připojit maximálně jedno vektorové úložiště a k konverzaci maximálně jedno vektorové úložiště. Koncepční přehled konverzací najdete v tématu Komponenty modulu runtime agenta.

V současném prostředí pro vývojáře agentů používá generování odpovědí a konverzace. Některé sady SDK a starší ukázky používají termín run. Pokud uvidíte oba termíny, považujte run za generování odpovědí. Pokyny k migraci najdete v tématu Postup migrace do nové služby agenta.

Seznam omezení pro vektorové vyhledávání (například maximální povolené velikosti souborů) najdete v článku o kvótách a omezeních .

Požadavky

Omezení klíčů a výchozí hodnoty

Vektorová úložiště jsou často prvním místem selhání pracovních postupů načítání v produkčním prostředí, takže pomáhá znát výchozí a pevné limity.

  • Soubory pro každé úložiště vektorů: Každé úložiště vektorů může obsahovat až 10 000 souborů.
  • Přílohy: K agentu a k konverzaci můžete připojit maximálně jedno vektorové úložiště.
  • Výchozí nastavení vyhledávání (hledání souborů):
    • Velikost bloku: 800 tokenů
    • Překrývající se blok dat: 400 tokenů
    • Model vkládání: text-embedding-3-large s 256 rozměry
    • Maximální počet bloků dat přidaných do kontextu: 20

Informace o omezení velikosti souboru a tokenu najdete v tématu kvóty a omezení.

Klíčové koncepty

Termín Význam
Vektorové úložiště Kontejner pro prohledávatelný obsah souboru (bloky a vkládání) používaný nástrojem pro vyhledávání souborů.
Požití Asynchronní proces, který analyzuje, zpracovává části, vkládá a indexuje soubor pro vyhledávání.
Připravenosti Zda je příjem dat dokončen a úložiště vektorů je prohledávatelné.
Zásady vypršení platnosti Zásady životního cyklu, které ukončí platnost úložiště vektorů po určité době nečinnosti.

Vyhledávání souborů používá osvědčené postupy načítání, které vašemu agentu pomůžou najít správný obsah ze souborů. Nástroj může v závislosti na dotazu a vašich datech:

  • Přepište uživatelské dotazy, aby se zlepšilo načítání.
  • Rozdělte složité dotazy do několika hledání.
  • Spusťte klíčová i sémantická hledání napříč úložišti vektorů agentů a konverzací.
  • Před přidáním výsledků do kontextu modelu je znovu seřadíte.

Aktuální výchozí nastavení načítání (velikost bloku bloků dat a překrytí, vložený model a maximální počet bloků dat přidaných do kontextu) najdete v tématu Jak to funguje.

Kde se vaše data nacházejí (základní a standardní nastavení agenta)

Umístění aktivních souborů a prostředků vyhledávání závisí na nastavení vašeho agenta:

  • nastavení agenta Basic: Vyhledávání souborů používá Microsoft spravované úložiště a prostředky vyhledávání.
  • Standardní zřízení agenta: Vyhledávání souborů používá zdroje Azure Blob Storage a Azure AI Vyhledávač, které připojíte během zřízení, takže vaše soubory zůstanou ve vašem úložišti.

Pokud chcete nastavit prostředí, přečtěte si téma Nastavení prostředí agenta. Další podrobnosti najdete v tématu Závislost na instalaci agenta.

Zajištění připravenosti úložiště vektorů před vytvořením odpovědí

Před vytvořením odpovědi se ujistěte, že jsou všechny soubory v úložišti vektorů plně zpracovány. Tento krok zajistí, že všechna data ve vašem vektorovém úložišti budou prohledávatelná.

Pokud chcete zkontrolovat připravenost, použijte pomocné funkce dotazování SDK (například vytvoření a dotazování a nahrání a dotazování) nebo dotazujte objekt úložiště vektorů, dokud jeho stav nebude dokončen. Příklady kódu najdete v nástroji pro vyhledávání souborů pro agenty.

Během příjmu dat může být úložiště vektorů ve stavu in_progress . Po dokončení příjmu dat se stav změní na dokončeno.

Generování odpovědí zahrnuje jako záložní řešení 60sekundové maximální čekání, když úložiště vektorů konverzace obsahuje soubory, které se stále zpracovávají. Tato záložní čekací doba se nevztahuje na úložiště vektorů agenta.

Kontrolní seznam pro kompletní pracovní postup

Pomocí tohoto kontrolního seznamu ověřte pracovní pracovní postup úložiště vektorů od příjmu dat až po správu životního cyklu.

  1. Rozhodněte se, zda použít základní nastavení agenta nebo standardní nastavení agenta podle toho, kde chcete, aby vaše soubory a vyhledávací prostředky byly umístěny. Podívejte se , kde se nacházejí vaše data (základní vs. standardní nastavení agenta).
  2. Nahrajte soubory a vytvořte vektorové úložiště. Podrobný příklad najdete v tématu Nahrání souborů a jejich přidání do úložiště vektorů.
  3. Než vygenerujete odpovědi, počkejte na dokončení příjmu dat. Použijte pomocné funkce pro dotazování ze sady SDK nebo dotazujte úložiště vektorů, dokud nebude jeho stav dokončen a v rozpracované nezůstanou žádné soubory. Před vytvořením odpovědí si přečtěte téma Zajištění připravenosti úložiště vektorů.
  4. Připojte vektorové úložiště k agentu nebo konverzaci, kterou používáte k hledání souborů. Mějte na paměti limity příloh. Viz Úložiště vektorů.
  5. Vytvořte odpověď, která používá vyhledávání souborů, a ověřte, že nástroj načítá z očekávaných zdrojů. Viz Vytvoření odpovědi s hledáním souborů a ověřením výsledků.
  6. Správa životního cyklu: Odebrání souborů, které už nepotřebujete, a plánování zásad vypršení platnosti (zejména pro vektorová úložiště vytvořená pomocníky konverzace). Viz Vektorová úložiště a úložiště vektorů konverzací mají výchozí zásady vypršení platnosti.

Přidání souborů a správa úložišť vektorů

Přidání souborů do vektorových úložišť je asynchronní operace. Pro dokončení příjmu dat použijte pomocné funkce pro vytváření a dotazování v oficiálních sadách SDK. Pokud nepoužíváte sadu SDK, pravidelně kontrolujte stav úložiště vektorů, dokud není jeho stav completed a v in_progress nezůstanou žádné soubory.

Soubory lze také přidat do vektorového úložiště, které bylo již vytvořeno, a to vytvořením souborů příslušného úložiště. Alternativně můžete do úložiště vektorů přidat několik souborů vytvořením dávek až 500 souborů.

Když nahrajete soubor pro vytvoření vektorového úložiště, systém automaticky:

  1. Rozdělí obsah do spravovatelných částí.
  2. Převede každý blok dat na vysoce dimenzionální vektory pomocí vložených modelů.
  3. Ukládá tyto vektory do optimalizovaného indexu vyhledávání.
  4. Vytvoří asociace mezi vektory a původním obsahem.

Odebrání souborů z úložišť vektorů

Soubory z vektorového úložiště můžete odebrat dvěma různými způsoby:

  • Odstraňte objekt souboru úložiště vektorů.
  • Odstraňte základní objekt souboru. Tím se odebere soubor ze všech konfigurací úložiště vektorů napříč všemi agenty a konverzacemi ve vaší organizaci.

Správa životního cyklu pomocí zásad vypršení platnosti

Zásady vypršení platnosti pomáhají spravovat životní cyklus úložiště vektorů. Tyto zásady můžete nastavit při vytváření nebo aktualizaci objektu úložiště vektorů.

Úložiště vektorů konverzací mají výchozí zásady vypršení platnosti.

Vektorové úložiště vytvořené pomocí konverzačních pomocníků má výchozí zásadu vypršení platnosti sedm dní po jejich poslední aktivitě (definováno jako poslední použití vektorového úložiště během generování odpovědi).

Když vyprší platnost úložiště vektorů, generování odpovědí pro tuto konverzaci selže. Pokud chcete tento problém vyřešit, znovu vytvořte nové úložiště vektorů se stejnými soubory a znovu ho připojte ke konverzaci. Podrobnější informace naleznete v části Výchozí pravidla vypršení platnosti pro úložiště konverzačních vektorů.

Podporované typy souborů a omezení klíčů

Seznam podporovaných typů souborů a požadavky na kódování najdete v tématu Podporované typy souborů.

Klíčové limity, které je potřeba mít na paměti:

  • K agentu a k konverzaci můžete připojit maximálně jedno vektorové úložiště.
  • Omezení velikosti souboru a tokenu se liší podle funkce. Viz Kvóty a omezení.

Řešení potíží

  • Úložiště vektorů zatím nejde prohledávat: Počkejte na dokončení příjmu dat. Použijte pomocníky pro dotazování SDK nebo dotazujte úložiště vektorů, dokud není jeho stav dokončen.
  • Generování odpovědí po několika dnech selže: Možná vypršela platnost úložiště vektorů konverzace. Znovu vytvořte nové úložiště vektorů se stejnými soubory a znovu ho připojte.
  • Soubor zmizel z několika agentů nebo konverzací: Je možné, že jste odstranili základní objekt souboru, který odebere soubor ze všech konfigurací úložiště vektorů ve vaší organizaci.
  • Nahrání nebo příjem dat se nezdaří: Zkontrolujte omezení velikosti souboru a tokenu v kvótách a omezeních.

Související obsah

  • Poslední aktualizace v