ai-agents-for-beginners

Водич за подешавање Azure AI претраге

Овај водич ће вам помоћи да подесите Azure AI претрагу користећи Azure портал. Следите кораке у наставку да бисте креирали и конфигурисали ваш Azure AI претраживачки сервис.

Захтеви

Пре него што почнете, уверите се да имате следеће:

Azure претплату. Ако немате Azure претплату, можете направити бесплатан налог на Azure Free Account.

Корак 1: Креирајте Azure Storage налог

Пратите ова упутства, Create an Azure storage account, да бисте креирали нови Azure Storage налог. НАПОМЕНА: Обавезно изаберите тип Storage Account као Standard General Purpose V2.

Корак 2: Креирајте Azure AI претраживачки сервис

Пријавите се у Azure портал.
У левом навигационом менију кликните на Create a resource.
У пољу за претрагу укуцајте “Azure AI Search” и изаберите Azure AI Search из листе резултата.
Кликните на дугме Create.
На картици Basics, унесите следеће информације:
- Subscription: Изаберите вашу Azure претплату.
- Resource group: Креирајте нову ресурсну групу или изаберите постојећу.
- Resource name: Унесите јединствено име за ваш претраживачки сервис.
- Region: Изаберите регију која је најближа вашим корисницима.
- Pricing tier: Изаберите план цена који одговара вашим захтевима. Можете почети са бесплатним (Free) планом за тестирање.
Кликните Review + create.
Прегледајте подешавања и кликните Create да бисте креирали претраживачки сервис.

Корак 3: Почетак рада са Azure AI претрагом

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

Корак 4: Коришћење алата за Azure AI претрагу

Azure AI претрага се интегрише са различитим алатима за унапређење ваших претраживачких могућности. Можете користити 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 претраживачки инстанс у променљиве окружења.

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 претрагу користећи Azure портал и интегрисане алате. Сада можете истражити напредније функције и могућности Azure AI претраге да побољшате ваша претраживачка решења.

За даљу помоћ, посетите Azure Cognitive Search documentation.

Изјава о одрицању одговорности: Овај документ је преведен коришћењем услуге за аутоматски превод Co-op Translator. Иако тежимо тачности, имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати ауторитативним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешна тумачења која произилазе из коришћења овог превода.

This site is open source. Improve this page.