Hoe Azure AI Search te configureren voor antwoorden op uw vragen met hulp van GPT.

Azure AI Search is een ingebouwde agent-tool waarmee een agent je Azure AI Search-index kan doorzoeken en de geretourneerde documenten kan gebruiken in zijn antwoord.

Configuratie

Vereist

Om aan de slag te gaan, heb je een Azure AI Search endpoint URL, indexnaam en API-sleutel nodig. Definieer deze in je .env bestand:

AZURE_AI_SEARCH_SERVICE_ENDPOINT="..."
AZURE_AI_SEARCH_INDEX_NAME="..."
AZURE_AI_SEARCH_API_KEY="..."

AZURE_AI_SEARCH_SERVICE_ENDPOINT

Dit is de URL van het search endpoint. Deze kan worden verkregen vanaf de hoofdpagina van de search service in de Cognitive Search-beheerconsole (bijv. https://example.search.windows.net).

AZURE_AI_SEARCH_INDEX_NAME

Dit is de naam van de index die doorzocht moet worden (bijv. hotels-sample-index).

Dit is de authenticatiesleutel die moet worden gebruikt bij het gebruik van de search endpoint. Geef deze uit via de beheerconsole. Gebruik de Waarde (Value), niet de naam van de authenticatiesleutel.

Inleiding tot de tutorial

Maak een account aan of log in op de Azure Portal

1. Bezoek https://azure.microsoft.com/en-us/ en klik op Get started of Try Azure for Free om een account aan te maken en in te loggen.

2. Kies voor betalen per gebruik of Azure Free met $200.

Maak de Azure AI Search-service aan

1. Open je configuratiescherm.

2. Klik op Create a resource.

3. Zoek naar Azure Search in de balk en druk op enter.

4. Klik nu op Create.

5. Configureer de basisinstellingen, maak een nieuwe Resource Group aan of selecteer een bestaande, geef de Service Name een naam naar keuze en selecteer vervolgens de locatie.

6. Klik op Change Pricing Tier.

Selecteer nu de gratis optie of selecteer de optie van uw voorkeur (hieraan kunnen kosten verbonden zijn).

7. Klik op Review + create en wacht tot de resource is aangemaakt.

Maak je index aan

1. Klik op Import data.

2. Volg de Microsoft-handleiding: https://learn.microsoft.com/en-us/azure/search/search-get-started-portal, sla na afloop de naam die aan de index is gegeven ergens op.

3. Nu je je AZURE_AI_SEARCH_INDEX_NAME hebt, kopieer en bewaar deze op een veilige plek.

Het endpoint verkrijgen

1. In de Url: heb je je AZURE_AI_SEARCH_SERVICE_ENDPOINT, kopieer en bewaar deze op een veilige plek.

2. Klik in het linkerpaneel op keys.

3. Klik op Add en voer een naam in voor je sleutel.

4. Kopieer de sleutel om AZURE_AI_SEARCH_API_KEY te verkrijgen.

Voeg de Tool toe aan een Agent

Nadat je de omgevingsvariabelen hebt toegevoegd, herstart je LibreChat en voeg je Azure AI Search toe aan een agent.

Deployment	Command
Docker	`docker compose down && docker compose up -d`
Lokaal	Stop de server en voer daarna opnieuw `npm run backend` uit

Selecteer in LibreChat Agents, maak of bewerk een agent, open de Tools-lijst van de agent, selecteer Azure AI Search en sla de agent op.

Test het

Stel de agent een vraag die beantwoord zou moeten worden door je Azure AI Search-index. Als de tool te veel inhoud retourneert, pas dan AZURE_AI_SEARCH_SEARCH_OPTION_TOP en AZURE_AI_SEARCH_SEARCH_OPTION_SELECT aan.

Optioneel

Hieronder volgen configuratiewaarden die niet verplicht zijn, maar die als parameters kunnen worden opgegeven tijdens een zoekopdracht.

Als er zorgen zijn dat de zoekresultaatgegevens te groot zijn en de promptgrootte overschrijden, overweeg dan om de grootte van de zoekresultaatgegevens te verkleinen door gebruik te maken van AZURE_AI_SEARCH_SEARCH_OPTION_TOP en AZURE_AI_SEARCH_SEARCH_OPTION_SELECT.

Voor details over elke parameter, raadpleeg het volgende document: https://learn.microsoft.com/en-us/rest/api/searchservice/search-documents

AZURE_AI_SEARCH_API_VERSION=2023-10-01-Preview
AZURE_AI_SEARCH_SEARCH_OPTION_QUERY_TYPE=simple
AZURE_AI_SEARCH_SEARCH_OPTION_TOP=3
AZURE_AI_SEARCH_SEARCH_OPTION_SELECT=field1, field2, field3

Azure AI Search

Op deze pagina