Avvio rapido: distribuire Azure AI Search con Bicep

Note

Azure AI Search è disponibile tramite il portale di Azure, le API REST e Azure SDK. È inoltre alla base di Foundry IQ, il livello di conoscenza gestito che trasforma il contenuto aziendale in knowledge base riutilizzabili e con riconoscimento delle autorizzazioni per gli agenti nel portale di Microsoft Foundry.

In questa guida introduttiva usare un file Bicep per distribuire un servizio Azure AI Search nel portale di Azure.

Bicep è un linguaggio specifico del dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, sicurezza dei tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

La distribuzione usa solo le proprietà incluse nel modello. Se sono necessarie altre personalizzazioni, ad esempio la configurazione della sicurezza di rete, è possibile aggiornare il servizio come attività post-distribuzione. Per personalizzare un servizio esistente con il numero minimo di passaggi, usare l’Interfaccia della riga di comando di Azure o Azure PowerShell. Se si stanno valutando le funzionalità di anteprima, usare l'API REST di gestione.

Suggerimento

Per un modello di Bicep alternativo che distribuisce Azure AI Search con un indicizzatore preconfigurato in Cosmos DB per NoSQL, vedere Bicep distribuzione di Azure AI Search. Non è disponibile alcun supporto Bicep modello per le operazioni del piano dati Azure AI Search come la creazione di un indice, ma è possibile aggiungere un modulo che chiama le API REST. L'esempio include un modulo che crea un indice, un connettore di origine dati e un indicizzatore che viene aggiornato da Cosmos DB a intervalli di 5 minuti.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

Esaminare il file Bicep

Questa guida introduttiva usa un file Bicep dai modelli di avvio rapido di 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
  }
}

Il file Bicep definisce la risorsa Azure seguente:

Distribuire il file Bicep

  1. Salvare il file Bicep come main.bicep nel computer locale.

  2. Distribuire il file Bicep usando interfaccia della riga di comando di Azure (o Azure PowerShell).

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

    Note

    Sostituire <service-name> con il nome del servizio di ricerca. Il nome del servizio deve contenere solo lettere minuscole, cifre o trattini. Non è possibile usare un trattino come primi due caratteri o come ultimo carattere. Il nome ha una lunghezza minima di 2 caratteri e una lunghezza massima di 60 caratteri.

    Al termine della distribuzione, viene visualizzato un messaggio che indica che la distribuzione è riuscita.

Esaminare le risorse distribuite

Usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per elencare le risorse distribuite nel gruppo di risorse.

az resource list --resource-group exampleRG

Pulire le risorse

Azure AI Search è una risorsa fatturabile. Se non è più necessario, eliminarlo dalla sottoscrizione per evitare addebiti. È possibile usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per eliminare il gruppo di risorse e le relative risorse.

az group delete --name exampleRG

Contenuti correlati

In questo avvio rapido, hai creato un servizio Azure AI Search usando un file Bicep e quindi hai convalidato l'implementazione. Per altre informazioni su Ricerca intelligenza artificiale di Azure e Azure Resource Manager, vedere gli articoli seguenti:

  • Ultimo aggiornamento: