ai-agents-for-beginners

Ръководство за настройка на Azure AI Search

Това ръководство ще ви помогне да настроите Azure AI Search чрез портала на Azure. Следвайте стъпките по-долу, за да създадете и конфигурирате вашата услуга Azure AI Search.

Предварителни условия

Преди да започнете, уверете се, че разполагате със следното:

Абонамент за Azure. Ако нямате абонамент за Azure, можете да създадете безплатен акаунт на Azure Free Account.

Стъпка 1: Създаване на акаунт за съхранение на Azure

Следвайте това ръководство, Create an Azure storage account, за да създадете нов акаунт за съхранение в Azure. ЗАБЕЛЕЖКА: Уверете се, че типът на акаунта за съхранение е Standard General Purpose V2.

Стъпка 2: Създаване на услуга Azure AI Search

Влезте в портала на Azure.
В лявото навигационно меню, кликнете върху Create a resource.
В полето за търсене въведете “Azure AI Search” и изберете Azure AI Search от списъка с резултати.
Натиснете бутона Create.
В таба Basics въведете следната информация:
- Subscription: Изберете своя абонамент за Azure.
- Resource group: Създайте нова ресурсна група или изберете съществуваща.
- Resource name: Въведете уникално име за вашата услуга за търсене.
- Region: Изберете регион, най-близък до вашите потребители.
- Pricing tier: Изберете ценови план, който отговаря на вашите нужди. Можете да започнете с безплатния план за тестове.
Натиснете Review + create.
Прегледайте настройките и кликнете Create, за да създадете услугата за търсене.

Стъпка 3: Започване с Azure AI Search

След като разгръщането приключи, отидете в услугата за търсене в портала на Azure.
В панела с общ преглед на услугата за търсене, копирайте URL адреса. Той трябва да изглежда като https://<service-name>.search.windows.net.
(Препоръчително) Активирайте достъп без ключ чрез Microsoft Entra ID (RBAC), както е показано в Стъпка 4 по-долу — не е необходим ключ. Примерите в това ръководство създават/актуализират индекси и качват документи, което изисква ролите Search Service Contributor и Search Index Data Contributor (или при удостоверяване с ключ — primary admin key — не query ключа). Само ако не можете да използвате RBAC, отворете панела Settings > Keys и копирайте primary admin key.
Следвайте стъпките в страницата Quickstart guide, за да създадете индекс, да качите данни и да извършите търсене.

Стъпка 4: Използване на инструментите на Azure AI Search

Azure AI Search се интегрира с различни инструменти за подобряване на функционалността за търсене. Можете да използвате Azure CLI, Python SDK, .NET SDK и други инструменти за по-напреднали конфигурации и операции.

Използване на Azure CLI

Инсталирайте Azure CLI, като следвате инструкциите на Install Azure CLI.
Влезте в Azure CLI с командата:
```
az login
```

(Препоръчително) Активирайте достъп без ключ чрез 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"

С активиран RBAC, примерите с Python и .NET SDK по-долу се удостоверяват с DefaultAzureCredential, който използва вашата сесия az login по време на локална разработка — не е необходим администраторски ключ. Вижте Connect to Azure AI Search using roles.

(Алтернатива) Удостоверяване с ключ — само ако не може да използвате RBAC, съхранете и администраторския ключ:

Запазете както крайна точка, така и API ключ за Azure AI Search инстанцията като променливи на средата.

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

Инсталирайте клиентската библиотека Azure Cognitive Search и Azure Identity за Python:
```
pip install azure-search-documents azure-identity
```

Използвайте следния Python код, за да създадете индекс и да качите документи:

 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

Изпълнете следната команда, за да създадете индекс и да качите документи:
```
 dotnet run ./AzureSearch.cs
```
Примерът с .NET по-долу използва DefaultAzureCredential, който може да използва вашето влизане през Azure CLI от az login по време на локална разработка.

Ето .NET кодът на 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}'.");

За по-подробна информация, вижте следната документация:

Заключение

Успешно сте настроили Azure AI Search чрез портала на Azure и интегрираните инструменти. Сега можете да разгледате по-напреднали функции и възможности на Azure AI Search, за да подобрите вашите решения за търсене.

За допълнителна помощ посетете документацията за Azure Cognitive Search.

Отказ от отговорност: Този документ е преведен с помощта на AI преводачески услуга Co-op Translator. Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Ние не носим отговорност за каквито и да е недоразумения или неправилни тълкувания, произтичащи от използването на този превод.

This site is open source. Improve this page.