ai-agents-for-beginners

Azure AI Search Telepítési Útmutató

Ez az útmutató segít az Azure AI Search beállításában az Azure portál használatával. Kövesse az alábbi lépéseket az Azure AI Search szolgáltatás létrehozásához és konfigurálásához.

Előfeltételek

Mielőtt elkezdené, győződjön meg arról, hogy a következőkkel rendelkezik:

Egy Azure-előfizetés. Ha nincs Azure-előfizetése, ingyenes fiókot hozhat létre a Azure Free Account oldalon.

1. lépés: Hozzon létre egy Azure Storage fiókot

Kövesse ezt az utasítást, Create an Azure storage account, hogy létrehozzon egy új Azure Storage fiókot. MEGJEGYZÉS: Győződjön meg róla, hogy a Storage Account típusa Standard General Purpose V2 legyen.

2. lépés: Hozzon létre egy Azure AI Search szolgáltatást

Jelentkezzen be az Azure portálra.
A bal oldali navigációs panelen kattintson a Create a resource lehetőségre.
A keresőmezőbe írja be, hogy “Azure AI Search”, majd válassza ki az Azure AI Search elemet az eredmények közül.
Kattintson a Create gombra.
Az Alapok fülön adja meg a következő információkat:
- Subscription: Válassza ki az Azure-előfizetését.
- Resource group: Hozzon létre egy új erőforráscsoportot, vagy válasszon ki egy meglévőt.
- Resource name: Adjon meg egy egyedi nevet a keresési szolgáltatásnak.
- Region: Válassza ki a felhasználóihoz legközelebbi régiót.
- Pricing tier: Válasszon egy díjszabási szintet, amely megfelel az igényeinek. Teszteléshez használhatja az ingyenes szintet.
Kattintson a Review + create gombra.
Ellenőrizze a beállításokat, majd kattintson a Create gombra a keresési szolgáltatás létrehozásához.

3. lépés: Kezdje el használni az Azure AI Search-t

A telepítés befejezése után navigáljon a keresési szolgáltatásához az Azure portálon.
A keresési szolgáltatás áttekintő paneljén másolja ki az URL-t. Ez így néz ki: https://<service-name>.search.windows.net.
(Ajánlott) Engedélyezze a kulcs nélküli hozzáférést Microsoft Entra ID-vel (RBAC), az alábbi 4. lépés szerint — kulcs nem szükséges. Az útmutatóban található példák indexeket hoznak létre/frissítenek és dokumentumokat töltenek fel, amelyekhez szükséges a Search Service Contributor és Search Index Data Contributor szerepkörök (vagy kulcs alapú hitelesítés esetén a primary admin key — nem a lekérdezési kulcs). Csak ha nem tudja használni az RBAC-ot, nyissa meg a Settings > Keys panelt és másolja ki a primary admin key-t.
Kövesse a Quickstart guide lépéseit egy index létrehozásához, adatok feltöltéséhez és keresés végrehajtásához.

4. lépés: Használja az Azure AI Search eszközöket

Az Azure AI Search különböző eszközökkel integrálódik, hogy növelje a keresési képességeit. Használhatja az Azure CLI-t, a Python SDK-t, a .NET SDK-t és más eszközöket fejlettebb konfigurációk és műveletek elvégzéséhez.

Azure CLI használata

Telepítse az Azure CLI-t az utasítások szerint a Install Azure CLI oldalon.
Jelentkezzen be az Azure CLI-be a következő paranccsal:
```
az login
```

(Ajánlott) Engedélyezze a kulcs nélküli hozzáférést Microsoft Entra ID-vel (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"

Az RBAC engedélyezésével az alábbi Python és .NET SDK minták DefaultAzureCredential-t használnak hitelesítésre, amely a helyi fejlesztés során az az login munkamenetet használja — adminisztrátori kulcs nem szükséges. Lásd: Connect to Azure AI Search using roles.

(Tartalék) Kulcs alapú hitelesítés — csak ha nem tudja használni az RBAC-ot, akkor tárolja a felügyelői kulcsot is:

Tárolja az Azure AI Search végpontját és API-kulcsát környezeti változóként.

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)

Python SDK használata

Telepítse az Azure Cognitive Search klienskönyvtárat és az Azure Identity-t Pythonhoz:
```
pip install azure-search-documents azure-identity
```

Használja az alábbi Python kódot index létrehozására és dokumentumok feltöltésére:

 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)

.NET SDK használata

Futtassa az alábbi parancsot index létrehozására és dokumentumok feltöltésére:
```
 dotnet run ./AzureSearch.cs
```
Az alábbi .NET minta az DefaultAzureCredential-at használja, amely képes használni az Azure CLI bejelentkezését az login alatt helyi fejlesztéskor.

Itt található az AzureSearch.cs .NET kódja:

 #: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}'.");

Részletesebb információkért tekintse meg az alábbi dokumentációkat:

Összegzés

Sikeresen beállította az Azure AI Search szolgáltatást az Azure portál használatával és integrált eszközökkel. Most már felfedezheti az Azure AI Search fejlettebb funkcióit és képességeit, hogy fokozza keresési megoldásait.

További segítségért látogasson el az Azure Cognitive Search documentation oldalra.

Jogi nyilatkozat: Ez a dokumentum az AI fordítási szolgáltatás, a Co-op Translator segítségével készült. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Fontos információk esetén professzionális emberi fordítást javasolunk. Nem vállalunk felelősséget semmilyen félreértésért vagy téves értelmezésért, amely ebből a fordításból ered.

This site is open source. Improve this page.