Início rápido: implantar IA do Azure Search usando Bicep

Observação

Pesquisa de IA do Azure  está disponível por meio do portal Azure, APIs REST e SDKs do Azure. Ele também sustenta o IQ do Foundry, a camada de conhecimento gerenciado que transforma o conteúdo da empresa em bases de conhecimento reutilizáveis e com reconhecimento de permissão para agentes no portal do Microsoft Foundry.

Neste início rápido, use um arquivo Bicep para implantar um serviço de Pesquisa de IA do Azure  no portal Azure.

O Bicep é uma linguagem específica de domínio (DSL) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

A implantação usa apenas as propriedades incluídas no modelo. Se você precisar de mais personalização, como configurar a segurança de rede, poderá atualizar o serviço como uma tarefa pós-implantação. Para personalizar um serviço existente com o menor número de etapas, use a CLI do Azure ou o Azure PowerShell. Se você estiver avaliando a versão prévia do recurso, use a API REST de Gerenciamento.

Dica

Para obter um modelo de Bicep alternativo que implanta Pesquisa de IA do Azure  com um indexador pré-configurado no Cosmos DB para NoSQL, consulte Bicep implantação de Pesquisa de IA do Azure . Não há suporte Bicep modelo para operações de plano de dados Pesquisa de IA do Azure , como a criação de um índice, mas você pode adicionar um módulo que chama APIs REST. O exemplo inclui um módulo que cria um índice, um conector de fonte de dados e um indexador que é atualizado do Cosmos DB em intervalos de 5 minutos.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Examinar o arquivo Bicep

Este início rápido usa um arquivo Bicep dos Modelos de Início Rápido do 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
  }
}

O arquivo Bicep define o seguinte recurso de Azure:

Implante o arquivo Bicep

  1. Salve o arquivo Bicep como main.bicep no computador local.

  2. Implante o arquivo Bicep usando a CLI do Azure ou 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>

    Observação

    Substitua <service-name> pelo nome do serviço Pesquisa. O nome do serviço deve conter apenas letras minúsculas, dígitos ou traços. Você não pode usar um traço como os dois primeiros caracteres ou o último caractere. O nome tem um comprimento mínimo de 2 caracteres e um comprimento máximo de 60 caracteres.

    Quando a implantação for concluída, uma mensagem será exibida indicando que a implantação foi realizada com sucesso.

Revisar os recursos implantados

Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para listar os recursos implantados no grupo de recursos.

az resource list --resource-group exampleRG

Limpar os recursos

O Pesquisa de IA do Azure  é um recurso faturável. Se você não precisar mais dela, exclua-a de sua assinatura para evitar encargos. Quando não for mais necessário, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir o grupo de recursos e seus recursos.

az group delete --name exampleRG

Conteúdo relacionado

Neste início rápido, você criou um serviço do Pesquisa de IA do Azure  usando um arquivo Bicep e validou a implantação. Para saber mais sobre o Pesquisa de IA do Azure  e o Azure Resource Manager, confira os seguintes artigos:

  • Last updated on