ai-agents-for-beginners

Azure AI Search Installatiehandleiding

Deze handleiding helpt u bij het instellen van Azure AI Search met behulp van de Azure-portal. Volg de onderstaande stappen om uw Azure AI Search-service te maken en te configureren.

Vereisten

Zorg ervoor dat u het volgende hebt voordat u begint:

Een Azure-abonnement. Als u geen Azure-abonnement hebt, kunt u een gratis account aanmaken op Azure Free Account.

Stap 1: Maak een Azure Storage-account aan

Volg deze instructie, Maak een Azure storage-account aan, om een nieuw Azure Storage-account aan te maken. OPMERKING: Zorg ervoor dat het type Storage-account Standard General Purpose V2 is.

Stap 2: Maak een Azure AI Search-service aan

Meld u aan bij de Azure-portal.
Klik in het navigatievenster aan de linkerkant op Een resource maken.
Typ in het zoekvak “Azure AI Search” en selecteer Azure AI Search uit de lijst met resultaten.
Klik op de knop Maken.
Vul in het tabblad Basisinformatie de volgende gegevens in:
- Abonnement: Selecteer uw Azure-abonnement.
- Resourcegroep: Maak een nieuwe resourcegroep aan of selecteer een bestaande.
- Naam resource: Voer een unieke naam in voor uw zoekservice.
- Regio: Selecteer de regio die het dichtst bij uw gebruikers ligt.
- Prijsniveau: Kies een prijsniveau dat bij uw behoeften past. U kunt beginnen met het gratis niveau voor testen.
Klik op Controleren + maken.
Controleer de instellingen en klik op Maken om de zoekservice te maken.

Stap 3: Aan de slag met Azure AI Search

Zodra de implementatie voltooid is, navigeer naar uw zoekservice in de Azure-portal.
Kopieer in het overzichtspaneel van de zoekservice de URL. Deze ziet er ongeveer zo uit: https://<service-name>.search.windows.net.
(Aanbevolen) Schakel sleutelvrije toegang in met Microsoft Entra ID (RBAC) zoals getoond in Stap 4 hieronder — er is geen sleutel nodig. De voorbeelden in deze handleiding maken indexen aan/bij of uploaden documenten, waarvoor de rollen Zoekservice-bijdrager en Zoekindex Gegevensbijdrager vereist zijn (of, bij op sleutel gebaseerde authenticatie, de primaire beheerderssleutel — niet de query-sleutel). Alleen als u RBAC niet kunt gebruiken, opent u het paneel Instellingen > Sleutels en kopieert u de primaire beheerderssleutel.
Volg de stappen op de Quickstart-gids pagina om een index te maken, gegevens te uploaden en een zoekopdracht uit te voeren.

Stap 4: Gebruik Azure AI Search-tools

Azure AI Search integreert met diverse tools om uw zoekmogelijkheden uit te breiden. U kunt Azure CLI, Python SDK, .NET SDK en andere tools gebruiken voor geavanceerde configuraties en bewerkingen.

Gebruik van Azure CLI

Installeer de Azure CLI door de instructies te volgen op Azure CLI installeren.
Meld u aan bij Azure CLI met het commando:
```
az login
```

(Aanbevolen) Schakel sleutelvrije toegang in met Microsoft Entra ID (RBAC):

 az search service update --name <service-name> --resource-group <resource-group> --auth-options aadOrApiKey
 az role assignment create --assignee <your-user-or-principal-id> --role "Search Service Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
 az role assignment create --assignee <your-user-or-principal-id> --role "Search Index Data Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
 # az search service show has no "endpoint" field; build the URL from the service name.
 export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"

Met ingeschakelde RBAC authenticeren de Python- en .NET SDK-voorbeelden hieronder met DefaultAzureCredential, die uw az login sessie gebruikt tijdens lokale ontwikkeling — er is geen beheerderssleutel nodig. Zie Verbind met Azure AI Search via rollen.

(Terugval) Authenticatie op sleutelbasis — alleen als u geen RBAC kunt gebruiken, sla ook de beheerderssleutel op:

Sla zowel eindpunt als API-sleutel voor Azure AI Search-instantie op als omgevingsvariabelen.

zsh / bash

# az search service show has no "endpoint" field; build the URL from the service name.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
export AZURE_SEARCH_API_KEY=$(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)

PowerShell

# az search service show has no "endpoint" field; build the URL from the service name.
$env:AZURE_SEARCH_SERVICE_ENDPOINT = "https://<service-name>.search.windows.net"
$env:AZURE_SEARCH_API_KEY = $(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)

Gebruik van Python SDK

Installeer de clientbibliotheek Azure Cognitive Search en Azure Identity voor Python:
```
pip install azure-search-documents azure-identity
```

Gebruik de volgende Python-code om een index te maken en documenten te uploaden:

 import os
 from azure.identity import DefaultAzureCredential
 from azure.search.documents import SearchClient
 from azure.search.documents.indexes import SearchIndexClient
 from azure.search.documents.indexes.models import SearchIndex, SimpleField, edm

 service_endpoint = os.getenv("AZURE_SEARCH_SERVICE_ENDPOINT")
 index_name = "sample-index"

 # Keyless (recommended): uses your `az login` identity via Entra ID RBAC.
 # Requires the "Search Service Contributor" and "Search Index Data Contributor" roles.
 credential = DefaultAzureCredential()
 # Fallback (key-based auth):
 # from azure.core.credentials import AzureKeyCredential
 # credential = AzureKeyCredential(os.getenv("AZURE_SEARCH_API_KEY"))
 index_client = SearchIndexClient(service_endpoint, credential)

 fields = [
     SimpleField(name="id", type=edm.String, key=True),
     SimpleField(name="content", type=edm.String, searchable=True),
 ]

 index = SearchIndex(name=index_name, fields=fields)

 index_client.create_index(index)

 search_client = SearchClient(service_endpoint, index_name, credential)

 documents = [
     {"id": "1", "content": "Hello world"},
     {"id": "2", "content": "Azure Cognitive Search"}
 ]

 search_client.upload_documents(documents)

Gebruik van .NET SDK

Voer de volgende opdracht uit om een index te maken en documenten te uploaden:
```
 dotnet run ./AzureSearch.cs
```
Het .NET-voorbeeld hieronder gebruikt DefaultAzureCredential, dat uw Azure CLI-aanmelding van az login kan gebruiken tijdens lokale ontwikkeling.

Hier is de .NET-code van AzureSearch.cs:

 #:package Azure.Search.Documents@11.*
 #:package Azure.Identity@1.21.0
 #:property PublishAot=false

 using Azure;
 using Azure.Identity;
 using Azure.Search.Documents;
 using Azure.Search.Documents.Indexes;
 using Azure.Search.Documents.Indexes.Models;

 var serviceEndpoint = new Uri(Environment.GetEnvironmentVariable("AZURE_SEARCH_SERVICE_ENDPOINT")!);
 var indexName = "sample-index";

 // Keyless (recommended): uses your `az login` identity via Entra ID RBAC.
 // Requires the "Search Service Contributor" and "Search Index Data Contributor" roles.
 var credential = new DefaultAzureCredential();
 // Fallback (key-based auth): the `using Azure;` directive above already imports
 // AzureKeyCredential; replace the credential line above with:
 // var credential = new AzureKeyCredential(Environment.GetEnvironmentVariable("AZURE_SEARCH_API_KEY")!);
 var indexClient = new SearchIndexClient(serviceEndpoint, credential);

 var fields = new List<SearchField>()
 {
     new SimpleField("id", SearchFieldDataType.String) { IsKey = true },
     new SearchableField("content")
 };

 var index = new SearchIndex(name: indexName, fields: fields);

 var response = await indexClient.CreateOrUpdateIndexAsync(index);
 Console.WriteLine($"Index '{response.Value.Name}' ready.");

 var searchClient = new SearchClient(serviceEndpoint, indexName, credential);

 var documents = new[]
 {
     new { id = "1", content = "Hello world" },
     new { id = "2", content = "Azure Cognitive Search" }
 };

 var result = await searchClient.UploadDocumentsAsync(documents);
 Console.WriteLine($"Uploaded {result.Value.Results.Count} documents to index '{response.Value.Name}'.");

Voor meer gedetailleerde informatie, raadpleeg de volgende documentatie:

Conclusie

U hebt Azure AI Search met succes ingesteld met behulp van de Azure-portal en geïntegreerde tools. U kunt nu meer geavanceerde functies en mogelijkheden van Azure AI Search verkennen om uw zoekoplossingen te verbeteren.

Voor verdere hulp, bezoek de Azure Cognitive Search-documentatie.

Disclaimer: Dit document is vertaald met behulp van de AI vertaaldienst Co-op Translator. Hoewel we streven naar nauwkeurigheid, dient u er rekening mee te houden dat geautomatiseerde vertalingen fouten of onnauwkeurigheden kunnen bevatten. Het originele document in de oorspronkelijke taal moet worden beschouwd als de gezaghebbende bron. Voor kritieke informatie wordt professionele menselijke vertaling aanbevolen. Wij zijn niet aansprakelijk voor eventuele misverstanden of verkeerde interpretaties die voortvloeien uit het gebruik van deze vertaling.

This site is open source. Improve this page.