Panduan Cepat: Menerapkan Pencarian Azure AI menggunakan Bicep

Catatan

Pencarian Azure AI tersedia melalui portal Azure, REST API, dan Azure SDK. Ini juga mendukung Foundry IQ, lapisan pengetahuan terkelola yang mengubah konten perusahaan menjadi pangkalan pengetahuan yang dapat digunakan kembali dan sadar izin untuk agen di portal Microsoft Foundry.

Dalam mulai cepat ini, gunakan file Bicep untuk menyebarkan layanan Pencarian Azure AI di portal Azure.

Bicep adalah bahasa pemrogram khusus domain (DSL) yang menggunakan sintaks deklaratif untuk menyebarkan sumber daya Azure. Bicep menyediakan sintaks ringkas, keamanan tipe yang andal, dan dukungan untuk pemanfaatan ulang kode. Bicep menawarkan pengalaman penulisan terbaik untuk solusi infrastructure-as-code di Azure.

Penyebaran hanya menggunakan properti yang disertakan dalam templat. Jika Anda memerlukan lebih banyak penyesuaian, seperti menyiapkan keamanan jaringan, Anda dapat memperbarui layanan sebagai tugas pasca-penyebaran. Untuk mengkustomisasi layanan yang sudah ada dengan langkah-langkah terkecil, gunakan Azure CLI atau Azure PowerShell. Jika Anda mengevaluasi fitur pratinjau, gunakan API REST Manajemen.

Tip

Untuk templat Bicep alternatif yang menyebarkan Pencarian Azure AI dengan pengindeks yang telah dikonfigurasi sebelumnya ke Cosmos DB untuk NoSQL, lihat Bicep penyebaran Pencarian Azure AI. Tidak ada dukungan templat Bicep untuk operasi bidang data Pencarian Azure AI seperti membuat indeks, tetapi Anda dapat menambahkan modul yang memanggil REST API. Sampel mencakup modul yang membuat indeks, konektor sumber data, dan pengindeks yang di-refresh dari Cosmos DB pada interval 5 menit.

Prasyarat

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Tinjau file Bicep

Petunjuk awal ini menggunakan file Bicep dari Templat Petunjuk Awal Azure.

@description('Service name must only contain lowercase letters, digits or dashes, cannot use dash as the first two or last one characters, cannot contain consecutive dashes, and is limited between 2 and 60 characters in length.')
@minLength(2)
@maxLength(60)
param name string

@allowed([
  'free'
  'basic'
  'standard'
  'standard2'
  'standard3'
  'storage_optimized_l1'
  'storage_optimized_l2'
])
@description('The pricing tier of the search service you want to create (for example, basic or standard).')
param sku string = 'standard'

@description('Replicas distribute search workloads across the service. You need at least two replicas to support high availability of query workloads (not applicable to the free tier).')
@minValue(1)
@maxValue(12)
param replicaCount int = 1

@description('Partitions allow for scaling of document count as well as faster indexing by sharding your index over multiple search units.')
@allowed([
  1
  2
  3
  4
  6
  12
])
param partitionCount int = 1

@description('Applicable only for SKUs set to standard3. You can set this property to enable a single, high density partition that allows up to 1000 indexes, which is much higher than the maximum indexes allowed for any other SKU.')
@allowed([
  'default'
  'highDensity'
])
param hostingMode string = 'default'

@description('Location for all resources.')
param location string = resourceGroup().location

resource search 'Microsoft.Search/searchServices@2020-08-01' = {
  name: name
  location: location
  sku: {
    name: sku
  }
  properties: {
    replicaCount: replicaCount
    partitionCount: partitionCount
    hostingMode: hostingMode
  }
}

File Bicep menentukan sumber daya Azure berikut:

Menerapkan file Bicep

  1. Simpan file Bicep sebagai main.bicep di komputer lokal Anda.

  2. Sebarkan file Bicep dengan menggunakan Azure CLI atau Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters serviceName=<service-name>

    Catatan

    Ganti <nama> layanan dengan nama layanan Pencarian. Nama layanan hanya boleh berisi huruf kecil, digit, atau tanda hubung. Anda tidak dapat menggunakan tanda hubung sebagai dua karakter pertama atau karakter terakhir. Nama ini memiliki panjang minimum 2 karakter dan panjang maksimum 60 karakter.

    Setelah penyebaran selesai, Anda akan melihat pesan yang menunjukkan sebar berhasil.

Meninjau sumber daya yang disebarkan

Gunakan portal Microsoft Azure, Azure CLI, atau Azure PowerShell untuk mencantumkan sumber daya yang disebarkan di grup sumber daya.

az resource list --resource-group exampleRG

Membersihkan sumber daya

Pencarian Azure AI adalah sumber daya yang dapat ditagih. Jika Anda tidak lagi membutuhkannya, hapus dari langganan Anda untuk menghindari biaya. Anda dapat menggunakan portal Azure, Azure CLI, atau Azure PowerShell untuk menghapus grup sumber daya dan sumber dayanya.

az group delete --name exampleRG

Konten terkait

Dalam panduan mulai cepat ini, Anda membuat layanan Pencarian Azure AI menggunakan file Bicep dan kemudian memvalidasi penyebaran. Untuk mempelajari selengkapnya tentang Pencarian Azure AI dan Azure Resource Manager, lihat artikel berikut ini:

  • Terakhir diperbarui pada