Esquema YAML da conexão da CLI (v2) dos Serviços de IA do Azure
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/