Szybki start: wdrażanie IQ rozwiązania Foundry (Wyszukiwanie AI platformy Azure) przy użyciu Bicep

Uwaga

Foundry IQ (Wyszukiwanie AI platformy Azure) udostępnia bezpośrednie interfejsy API indeksowania i zapytań, a także interfejsy API wyższego poziomu dla źródeł wiedzy i baz wiedzy do zarządzanego pobierania. Użyj portalu Azure, interfejsów API REST lub Azure SDKs, aby skonfigurować te funkcje lub połączyć agentów z bazami wiedzy w portalu Microsoft Foundry.

W tym przewodniku Szybki start użyjesz pliku Bicep, aby wdrożyć usługę Foundry IQ (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 zobaczyć alternatywny szablon Bicep, który wdraża Foundry IQ ze wstępnie skonfigurowanym indekserem do usługi Cosmos DB for NoSQL, zobacz Wdrożenie Foundry IQ za pomocą Bicep. Nie ma Bicep obsługi szablonów dla operacji płaszczyzny danych IQ rozwiązania Foundry, 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 platformy 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 znaków service-name> nazwą usługi Foundry IQ. 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 Foundry IQ jest zasobem rozliczanym. 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

W tym przewodniku Szybki start utworzono usługę Foundry IQ przy użyciu pliku Bicep, a następnie zweryfikowano wdrożenie. Aby dowiedzieć się więcej na temat Foundry IQ i Azure Resource Manager, zobacz następujące artykuły: