Quickstart: Azure AI Zoeken implementeren met Bicep

Notitie

Azure AI Zoeken is beschikbaar via de Azure-portal, REST API's en Azure-SDK's. Het vormt ook een basis voor Foundry IQ, de beheerde kennislaag die bedrijfsinhoud transformeert in herbruikbare, machtigingsbewuste knowledge bases voor agents in de Microsoft Foundry-portal.

In deze quickstart gebruikt u een Bicep-bestand om een Azure AI Zoeken-service te implementeren in de Azure-portal.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

De implementatie maakt alleen gebruik van de eigenschappen die zijn opgenomen in de sjabloon. Als u meer aanpassingen nodig hebt, zoals het instellen van netwerkbeveiliging, kunt u de service bijwerken als een taak na de implementatie. Als u een bestaande service wilt aanpassen met de minste stappen, gebruikt u Azure CLI of Azure PowerShell. Als u preview-functies evalueert, gebruikt u de REST API van Management.

Tip

Zie Bicep implementatie van Azure AI Zoeken voor een alternatieve Bicep sjabloon die Azure AI Zoeken implementeert met een vooraf geconfigureerde indexeerfunctie in Cosmos DB voor NoSQL. Er is geen Bicep sjabloonondersteuning voor Azure AI Zoeken gegevensvlakbewerkingen, zoals het maken van een index, maar u kunt een module toevoegen die REST API's aanroept. Het voorbeeld bevat een module waarmee een index, gegevensbronconnector en een indexeerfunctie worden gemaakt die met intervallen van vijf minuten wordt vernieuwd vanuit Cosmos DB.

Vereisten

Als u geen Azure-abonnement hebt, maakt u een gratis account voordat u begint.

Het Bicep-bestand controleren

In deze quickstart wordt een Bicep-bestand uit Azure-quickstartsjablonen gebruikt.

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

Het bestand Bicep definieert de volgende Azure resource:

Het Bicep-bestand implementeren

  1. Sla het Bicep-bestand op als main.bicep op uw lokale computer.

  2. Implementeer het Bicep-bestand met behulp van Azure CLI of Azure PowerShell.

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

    Notitie

    Vervang <de servicenaam> door de naam van de Search-service. De servicenaam mag alleen kleine letters, cijfers of streepjes bevatten. U kunt geen streepje gebruiken als de eerste twee tekens of het laatste teken. De naam heeft een minimale lengte van 2 tekens en een maximumlengte van 60 tekens.

    Wanneer de implementatie is voltooid, ziet u een bericht dat aangeeft dat de implementatie is voltooid.

Ingezette bronnen bekijken

Gebruik Azure Portal, Azure CLI of Azure PowerShell om de geïmplementeerde resources in de resourcegroep weer te geven.

az resource list --resource-group exampleRG

De hulpbronnen opschonen

Azure AI Zoeken is een factureerbare resource. Als u deze niet meer nodig hebt, verwijdert u deze uit uw abonnement om kosten te voorkomen. U kunt Azure Portal, Azure CLI of Azure PowerShell gebruiken om de resourcegroep en de bijbehorende resources te verwijderen.

az group delete --name exampleRG

In deze quickstart hebt u een Azure AI Zoeken-service gemaakt met behulp van een Bicep-bestand en vervolgens de implementatie gevalideerd. Zie de volgende artikelen voor meer informatie over Azure AI Zoeken en Azure Resource Manager: