ai-agents-for-beginners

Azure AI Search Kurulum Rehberi

Bu rehber, Azure portalını kullanarak Azure AI Search kurmanıza yardımcı olacaktır. Azure AI Search hizmetinizi oluşturmak ve yapılandırmak için aşağıdaki adımları izleyin.

Önkoşullar

Başlamadan önce, aşağıdakilere sahip olduğunuzdan emin olun:

Adım 1: Bir Azure Depolama Hesabı Oluşturun

  1. Yeni bir Azure Depolama Hesabı oluşturmak için şu talimatı izleyin, Bir Azure depolama hesabı oluşturma. NOT: Depolama Hesabı türünün Standard General Purpose V2 olduğundan emin olun.

Adım 2: Bir Azure AI Search Hizmeti Oluşturun

  1. Azure portalına giriş yapın.
  2. Sol navigasyon panelinde, Kaynak oluştur seçeneğine tıklayın.
  3. Arama kutusuna “Azure AI Search” yazın ve sonuçlar listesinden Azure AI Search‘ü seçin.
  4. Oluştur butonuna tıklayın.
  5. Temel bilgiler sekmesinde aşağıdaki bilgileri sağlayın:
    • Abonelik: Azure aboneliğinizi seçin.
    • Kaynak grubu: Yeni bir kaynak grubu oluşturun veya var olan birini seçin.
    • Kaynak adı: Arama hizmetiniz için benzersiz bir ad girin.
    • Bölge: Kullanıcılarınıza en yakın bölgeyi seçin.
    • Fiyatlandırma katmanı: İhtiyaçlarınıza uygun bir fiyatlandırma katmanı seçin. Test için Ücretsiz katmanla başlayabilirsiniz.
  6. İncele + oluştur butonuna tıklayın.
  7. Ayarları gözden geçirin ve arama hizmetini oluşturmak için Oluştur butonuna tıklayın.

Adım 3: Azure AI Search Kullanımına Başlama

  1. Dağıtım tamamlandıktan sonra, Azure portalında arama hizmetinize gidin.
  2. Arama hizmeti genel bakış panelinde, URL’yi kopyalayın. Şu şekildedir https://<service-name>.search.windows.net.
  3. (Önerilen) Aşağıda Adım 4’te gösterildiği gibi Microsoft Entra ID (RBAC) ile anahtarsız erişimi etkinleştirin — anahtara gerek yok. Bu rehberdeki örnekler indeks oluşturma/güncelleme ve doküman yükleme işlemleri yapar; bu işlemler için Search Service Contributor ve Search Index Data Contributor rolleri gereklidir (veya, anahtarlı kimlik doğrulama için, birincil yönetici anahtarı — sorgu anahtarı değil). Sadece RBAC kullanamıyorsanız, Ayarlar > Anahtarlar panelini açın ve birincil yönetici anahtarını kopyalayın.
  4. Bir indeks oluşturmak, veri yüklemek ve arama yapmak için Hızlı başlangıç rehberi sayfasındaki adımları izleyin.

Adım 4: Azure AI Search Araçlarını Kullanın

Azure AI Search, arama yeteneklerinizi artırmak için çeşitli araçlarla entegre olur. Gelişmiş yapılandırmalar ve işlemler için Azure CLI, Python SDK, .NET SDK ve diğer araçları kullanabilirsiniz.

Azure CLI Kullanımı

  1. Azure CLI Kurulumu talimatlarını izleyerek Azure CLI’yı kurun.

  2. Azure CLI’ya aşağıdaki komutla giriş yapın:

    az login

  3. (Önerilen) Microsoft Entra ID (RBAC) ile anahtarsız erişimi etkinleştirin:

     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 etkinleştirildiğinde, aşağıdaki Python ve .NET SDK örnekleri DefaultAzureCredential ile kimlik doğrulaması yapar; bu, yerel geliştirme sırasında az login oturumunuzu kullanır — yönetici anahtarına gerek yoktur. Ayrıntılar için Rollerle Azure AI Search’e Bağlanma sayfasına bakın.

  4. (Yedek) Anahtarlı kimlik doğrulama — sadece RBAC kullanamıyorsanız, yönetici anahtarını da depolayın:

Azure AI Search örneği için hem uç noktayı hem de API anahtarını ortam değişkenlerine kaydedin.

Python SDK Kullanımı

  1. Azure Cognitive Search istemci kitaplığı ve Azure Identity for Python’u kurun:

    pip install azure-search-documents azure-identity

  2. Bir indeks oluşturmak ve dokümanları yüklemek için aşağıdaki Python kodunu kullanın:

     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 Kullanımı

  1. Bir indeks oluşturmak ve dokümanları yüklemek için aşağıdaki komutu çalıştırın:

     dotnet run ./AzureSearch.cs

    Aşağıdaki .NET örneği DefaultAzureCredential kullanır; yerel geliştirme sırasında Azure CLI oturumunuzdan az login yararlanabilir.

  2. İşte AzureSearch.cs için .NET kodu:

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

Daha fazla ayrıntı için aşağıdaki belgeleri inceleyin:

Sonuç

Azure AI Search’u Azure portalı ve entegre araçlar kullanarak başarıyla kurdunuz. Artık Azure AI Search’ün daha gelişmiş özelliklerini ve yeteneklerini keşfederek arama çözümlerinizi geliştirebilirsiniz.

Daha fazla yardım için Azure Cognitive Search belgeleri sayfasını ziyaret edin.

Feragatname: Bu belge, AI çeviri hizmeti Co-op Translator kullanılarak çevrilmiştir. Doğruluk için çaba sarf etsek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu ortaya çıkabilecek yanlış anlamalardan veya yanlış yorumlamalardan sorumlu değiliz.

This site is open source. Improve this page.