Vectorarchieven voor zoeken naar bestanden

Vector Store-objecten geven het hulpprogramma voor het zoeken van bestanden de mogelijkheid om uw bestanden te doorzoeken. Het toevoegen van een bestand aan een vectorarchief biedt het Foundry-model van de agent kennis buiten de trainingsgegevens. De service parseert, chunkt, embed en indexeert het bestand, zodat de tool zowel trefwoorden- als semantische zoekopdrachten kan uitvoeren.

Vectoropslagen kunnen worden gekoppeld aan zowel agenten als gesprekken. Op dit moment kunt u maximaal één vectorarchief koppelen aan een agent en maximaal één vectorarchief aan een gesprek. Zie Agent Runtime-onderdelen voor een conceptueel overzicht van gesprekken.

In de huidige ontwikkelaarservaring met agents worden reacties en gesprekken gebruikt voor het genereren van antwoorden. Sommige SDK's en oudere voorbeelden gebruiken de term run. Als u beide termen ziet, behandel run als antwoordgeneratie. Zie Migreren naar de nieuwe agentservice voor hulp bij migratie.

Zie het artikel quota en limieten voor een lijst met limieten voor vectorzoekopdrachten (zoals maximale toegestane bestandsgrootten).

Voorwaarden

Belangrijkste limieten en standaardwaarden

Vectoropslagplaatsen zijn vaak de eerste plaats waar retrievalwerkstromen in productie falen, dus het helpt om de standaardwaarden en limieten te kennen.

  • Bestanden per vectorarchief: elk vectorarchief kan maximaal 10.000 bestanden bevatten.
  • Bijlagen: U kunt maximaal één vectorarchief koppelen aan een agent en maximaal één vectorarchief aan een gesprek.
  • Standaardinstellingen voor het ophalen van bestanden (zoeken naar bestanden):
    • Blokgrootte: 800 tokens
    • Segment overlap: 400 tokens
    • Insluitmodel: text-embedding-3-large met 256 dimensies
    • Maximum aantal segmenten toegevoegd aan context: 20

Zie quota en limieten voor de bestandsgrootte en tokenlimieten.

Sleutelbegrippen

Termijn Betekenis
Vectoropslag Een container voor doorzoekbare bestandsinhoud (segmenten en insluitingen) die wordt gebruikt door het hulpprogramma voor het zoeken van bestanden.
Gegevensinvoer Het asynchrone proces dat een bestand voor zoekopdrachten parseert, segmenten, insluit en indexeert.
Bereidheid Of opname is voltooid en of het vectorarchief doorzoekbaar is.
Verloopbeleid Een levenscyclusbeleid dat een vectoropslag afloopt na een periode van inactiviteit.

Met de bestandszoekfunctie worden zoekmethoden toegepast om uw agent te helpen de juiste inhoud uit uw bestanden te vinden. Afhankelijk van de query en uw gegevens kan het hulpprogramma het volgende doen:

  • Herschrijf gebruikersquery's om het ophalen te verbeteren.
  • Complexe query's opsplitsen in meerdere zoekopdrachten.
  • Voer zowel trefwoord- als semantische zoekopdrachten uit in agent- en gespreksvectorarchieven.
  • Herordeneer de resultaten voordat u ze toevoegt aan de modelcontext.

Zie Hoe het werkt voor de huidige standaardinstellingen voor het ophalen van segmenten (segmentgrootte en overlapping, insluitingsmodel en het maximum aantal segmenten dat is toegevoegd aan context).

Waar uw gegevens zich bevinden (basis- versus standaardagentconfiguratie)

Waar bestanden en zoekbronnen zich bevinden, is afhankelijk van de installatie van uw agent:

  • Basic-agent instellen: Bestandszoekopdrachten maakt gebruik van Microsoft beheerde opslag- en zoekbronnen.
  • Standard-agent instellen: Zoeken in bestanden maakt gebruik van de Azure Blob Storage en Azure AI Zoeken resources die u tijdens de installatie verbindt, zodat uw bestanden in uw opslag blijven.

Zie Agentomgeving instellen om uw omgeving in te stellen. Zie Afhankelijkheid van agentinstallatie voor meer informatie.

Gereedheid voor vectoropslag garanderen voordat u reacties maakt

Zorg ervoor dat alle bestanden in een vectorarchief volledig worden verwerkt voordat u een antwoord maakt. Deze stap zorgt ervoor dat alle gegevens in uw vectorarchief doorzoekbaar zijn.

Als u de gereedheid wilt controleren, gebruikt u de SDK-poll-helpers (bijvoorbeeld create-and-poll en upload-and-poll) of peilt u het vectorarchiefobject totdat de status is voltooid. Zie het hulpprogramma 'Bestand Zoeken' voor agents voor codevoorbeelden.

Tijdens de opname kan een vectoropslag de status in_progress hebben. Wanneer de ingestie is voltooid, wordt de status gewijzigd in voltooid.

Als terugval bevat het genereren van antwoorden een maximale wachttijd van 60 seconden wanneer het vectorarchief van het gesprek bestanden bevat die nog worden verwerkt. Deze wachttijd bij terugval geldt niet voor de vectorwinkel van de agent.

Controlelijst voor end-to-end-werkflow

Gebruik deze controlelijst om een werkstroom voor vectoropslag te valideren van opname tot levenscyclusbeheer.

  1. Bepaal of u basisagentinstallatie of standaardagentinstallatie gebruikt, op basis van waar u uw bestanden en zoekbronnen wilt opslaan. Zie waar uw gegevens zich bevinden (basic versus standard agent setup).
  2. Upload uw bestanden en maak een vectoropslag. Zie Bestanden uploaden en toevoegen aan een vectorarchief voor een stapsgewijs voorbeeld.
  3. Wacht totdat de opname is voltooid voordat u antwoorden genereert. Gebruik hulpprogramma's voor SDK-polling of voer polling uit op de vector opslag totdat de status voltooid is en er geen bestanden meer zijn in in_progress. Zie De gereedheid van vectoropslag garanderen voordat u reacties maakt.
  4. Voeg het vectorarchief toe aan de agent of het gesprek dat u gebruikt voor het zoeken naar bestanden. Houd rekening met de bijlagelimieten. Zie vectoropslag.
  5. Maak een antwoord dat gebruikmaakt van bestandszoekopdrachten en controleer of het hulpprogramma gegevens haalt uit de verwachte bronnen. Zie Antwoord maken met bestand zoeken en resultaten verifiëren.
  6. Levenscyclus beheren: verwijder bestanden die u niet meer nodig hebt en plan het verloopbeleid (met name voor vectorarchieven die zijn gemaakt door gesprekshelpers). Zie vectorarchieven en gespreksvectorarchieven hebben standaardverloopbeleid.

Bestanden toevoegen en vectorarchieven beheren

Het toevoegen van bestanden aan vectorarchieven is een asynchrone bewerking. Gebruik de helpers voor het maken en peilen in de officiële SDK's om ervoor te zorgen dat de opname is voltooid. Als u geen SDK gebruikt, pollt u het vectorarchief totdat de status is voltooid en blijven er geen bestanden in in_progress.

Bestanden kunnen ook worden toegevoegd aan een vectorarchief nadat deze is gemaakt door vectoropslagbestanden te maken. U kunt ook verschillende bestanden toevoegen aan een vectorarchief door batches van maximaal 500 bestanden te maken.

Wanneer u een bestand uploadt om een vectoropslag te maken, wordt het systeem automatisch:

  1. Segmenteert uw inhoud in beheerbare stukken.
  2. Converteert elk segment naar high-dimensionale vectoren met behulp van insluitingsmodellen.
  3. Slaat deze vectoren op in een geoptimaliseerde zoekindex.
  4. Hiermee maakt u koppelingen tussen de vectoren en de oorspronkelijke inhoud.

Bestanden verwijderen uit vectorarchieven

U kunt bestanden op twee verschillende manieren verwijderen uit een vectorarchief:

  • Verwijder het vectoropslagbestand.
  • Verwijder het onderliggende bestandsobject. Hiermee verwijdert u het bestand uit alle configuraties voor vectoropslag in alle agents en gesprekken in uw organisatie.

Levenscyclus beheren met verloopbeleid

Met verloopbeleid kunt u de levenscyclus van vectorstores beheren. U kunt dit beleid instellen bij het maken of bijwerken van het vectorarchiefobject.

Gespreksvectorarchieven hebben standaardverloopbeleid

Vectorarchieven die zijn gemaakt met behulp van gesprekshulpen hebben een standaardverloopbeleid van zeven dagen nadat ze voor het laatst actief waren (gedefinieerd als de laatste keer dat het vectorarchief werd gebruikt tijdens het genereren van reacties).

Wanneer een vectoropslag niet meer beschikbaar is, mislukt het genereren van reacties voor dat gesprek. Om het probleem op te lossen, maakt u een nieuwe vectoropslag met dezelfde bestanden en bevestigt u het opnieuw aan het gesprek. Zie Gespreksvectoropslag heeft standaard vervalbeleid voor meer informatie.

Ondersteunde bestandstypen en sleutellimieten

Zie Ondersteunde bestandstypen voor de lijst met ondersteunde bestandstypen en coderingsvereisten.

Belangrijke limieten om rekening mee te houden:

  • U kunt maximaal één vectoropslag koppelen aan een agent en maximaal één vectoropslag koppelen aan een gesprek.
  • De bestandsgrootte en tokenlimieten variëren per functie. Zie Quota en limieten.

Probleemoplossing

  • Uw vectorarchief is nog niet doorzoekbaar: wacht totdat de opname is voltooid. Gebruik SDK-polling-hulpmiddelen of peil de vectoropslag totdat de status 'voltooid' is.
  • Het genereren van reacties mislukt na een paar dagen: uw gespreksvectorarchief is mogelijk verlopen. Maak een nieuw vectorarchief opnieuw met dezelfde bestanden en plaats deze opnieuw bij elkaar.
  • Een bestand is verdwenen uit meerdere agents of gesprekken: mogelijk hebt u het onderliggende bestandsobject verwijderd, waardoor het bestand wordt verwijderd uit alle configuraties van vectorarchieven in uw organisatie.
  • Uploads of invoer mislukken: controleer de bestandsgrootte en tokenlimieten in Quota en limieten.

Verwante onderwerpen

  • Last updated on