Compartilhar via

Esquema YAML da conexão da CLI (v2) dos Serviços de IA do Azure

  • Artigo

APLICA-SE A: Extensão de ML da CLI do Azurev2 (atual)

Observação

A sintaxe YAML detalhada neste documento baseia-se no esquema JSON da última versão da extensão de ML da CLI v2. Essa sintaxe só tem a garantia de funcionar com a última versão da extensão de ML da CLI v2. Encontre os esquemas para as versões mais antigas da extensão em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave Type Descrição Valores permitidos Valor padrão
$schema string O esquema YAML. Se você usar a extensão do Visual Studio Code do Azure Machine Learning para criar o arquivo YAML, inclua $schema na parte superior do seu arquivo para invocar as conclusões de esquema e recursos.
name string Obrigatória. O nome da conexão.
description string A descrição da conexão.
tags objeto O dicionário das marcas de conexão.
type string Obrigatória. O tipo de conexão. azure_ai_services azure_ai_services
is_shared boolean true se a conexão for compartilhada entre outros projetos no hub; caso contrário, false. true
endpoint string Obrigatória. A URL do ponto de extremidade.
api_key string A chave de API usada para autenticar a conexão. Se não for fornecida, a conexão será autenticada por meio da ID do Microsoft Entra (autenticação sem credenciais).
ai_services_resource_id string Obrigatória. A ID de recurso do Azure totalmente qualificada do recurso dos Serviços de IA do Azure.

Comentários

Existem duas maneiras de criar conexões com os Serviços de IA do Azure:

  • Uma conexão para todos os Serviços de IA do Azure, exceto o Azure AI Search.
  • Uma conexão para cada Serviço de IA do Azure individual.

O esquema descrito nesse artigo destina-se a uma conexão para todos os Serviços de IA do Azure, exceto a Pesquisa de IA do Azure.

Embora os comandos az ml connection possam ser usados para gerenciar tanto as conexões do Azure Machine Learning quanto as do Estúdio de IA do Azure, a conexão dos Serviços de IA do Azure é específica para o Estúdio de IA do Azure.

Exemplos

Esses exemplos estão na forma de arquivos YAML e são usados pela CLI. Por exemplo, az ml connection create -f <file-name>.yaml.

YAML: chave de API

#AzureAIServiceConnection.yml

name: myazai_ei
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/
api_key: XXXXXXXXXXXXXXX

YAML: Microsoft Entra ID

#AzureAIServiceConnection.yml

name: myazai_apk
type: azure_ai_services
endpoint: https://contoso.cognitiveservices.azure.com/

Próximas etapas