Szybki start: wdrażanie usługi Wyszukiwanie AI platformy Azure przy użyciu aplikacji Bicep

Uwaga

Wyszukiwanie AI platformy Azure jest dostępna za pośrednictwem portalu Azure, interfejsów API REST i Azure SDKs. Jest także podstawą Foundry IQ — zarządzanej warstwy wiedzy, która przekształca treści przedsiębiorstwa w bazy wiedzy wielokrotnego użytku z uwzględnieniem uprawnień dla agentów w portalu Microsoft Foundry.

W tym przewodniku Szybki start użyj pliku Bicep, aby wdrożyć usługę Wyszukiwanie AI platformy Azure w portalu Azure.

Bicep to język specyficzny dla domeny (DSL), który używa składni deklaratywnej do wdrażania zasobów platformy Azure. Zapewnia zwięzłą składnię, niezawodne bezpieczeństwo typów i obsługę ponownego użycia kodu. Bicep oferuje najlepsze środowisko tworzenia rozwiązań infrastruktury jako kodu na platformie Azure.

Wdrożenie używa tylko właściwości zawartych w szablonie. Jeśli potrzebujesz większej liczby dostosowań, takich jak konfigurowanie zabezpieczeń sieci, możesz zaktualizować usługę jako zadanie po wdrożeniu. Aby dostosować istniejącą usługę za pomocą najmniejszych kroków, użyj interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell. Jeśli oceniasz funkcje w wersji zapoznawczej, użyj interfejsu REST API do zarządzania.

Wskazówka

Aby uzyskać alternatywny szablon Bicep, który wdraża Wyszukiwanie AI platformy Azure ze wstępnie skonfigurowanym indeksatorem w usłudze Cosmos DB na potrzeby NoSQL, zobacz Bicep wdrażanie Wyszukiwanie AI platformy Azure. Nie ma obsługi szablonów Bicep dla operacji płaszczyzny danych Wyszukiwanie AI platformy Azure, takich jak tworzenie indeksu, ale można dodać moduł wywołujący interfejsy API REST. Przykład zawiera moduł, który tworzy indeks, łącznik źródła danych i indeksator, który odświeża dane z Cosmos DB w 5-minutowych odstępach czasu.

Wymagania wstępne

Jeśli nie masz subskrypcji platformy Azure, przed rozpoczęciem utwórz bezpłatne konto.

Przejrzyj plik Bicep

Ten szybki start używa pliku Bicep z Azure Quickstart Templates.

@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
  }
}

Plik Bicep definiuje następujący zasób Azure:

Wdróż plik Bicep

  1. Zapisz plik Bicep jako main.bicep na komputerze lokalnym.

  2. Wdróż plik Bicep przy użyciu Azure CLI lub Azure PowerShell.

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

    Uwaga

    Zastąp <ciąg service-name> nazwą usługi wyszukiwania. Nazwa usługi musi zawierać tylko małe litery, cyfry lub kreski. Nie można użyć kreski jako pierwszych dwóch znaków ani ostatniego znaku. Nazwa ma minimalną długość 2 znaków i maksymalną długość 60 znaków.

    Po zakończeniu wdrażania zostanie wyświetlony komunikat informujący o pomyślnym wdrożeniu.

Przeglądanie wdrożonych zasobów

Użyj witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby wyświetlić listę wdrożonych zasobów w grupie zasobów.

az resource list --resource-group exampleRG

Czyszczenie zasobów

Usługa Wyszukiwanie AI platformy Azure to zasób rozliczany. Jeśli nie potrzebujesz go już, usuń go z subskrypcji, aby uniknąć naliczania opłat. Aby usunąć grupę zasobów i jej zasoby, możesz użyć witryny Azure Portal, interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell.

az group delete --name exampleRG

Treści powiązane

W tym przewodniku Szybki start utworzono usługę Wyszukiwanie AI platformy Azure przy użyciu pliku Bicep, a następnie sprawdzono wdrożenie. Aby dowiedzieć się więcej o usłudze Wyszukiwanie AI platformy Azure i usłudze Azure Resource Manager, zobacz następujące artykuły:

  • Ostatnia aktualizacja o