Partilhar via


CLI (v2) Ligação Foundry Tools esquema YAML

APLICA-SE A: Azure CLI ml extension v2 (atual)

Nota

A sintaxe YAML detalhada neste documento é baseada no esquema JSON para a versão mais recente da extensão ML CLI v2. Esta sintaxe é garantida apenas para funcionar com a versão mais recente da extensão ML CLI v2. Você pode encontrar os esquemas para versões de extensão mais antigas em https://azuremlschemasprod.azureedge.net/.

Sintaxe YAML

Chave Tipo Descrição Valores permitidos Valor predefinido
$schema cadeia (de caracteres) O esquema YAML. Se você usar a extensão de código do Visual Studio do Aprendizado de Máquina do Azure para criar o arquivo YAML, inclua $schema na parte superior do arquivo para invocar o esquema e as completações de recursos.
name cadeia (de caracteres) Obrigatório. O nome da conexão.
description cadeia (de caracteres) A descrição da conexão.
tags objecto O dicionário de marcas de conexão.
type cadeia (de caracteres) Obrigatório. O tipo de conexão. azure_ai_services azure_ai_services
is_shared Booleano true se a conexão for compartilhada entre outros projetos no hub; caso contrário, false. true
endpoint cadeia (de caracteres) Obrigatório. A URL do ponto de extremidade.
api_key cadeia (de caracteres) A chave de API usada para autenticar a conexão. Se não for fornecida, a conexão será autenticada por meio do Microsoft Entra ID (autenticação sem credenciais).
ai_services_resource_id cadeia (de caracteres) Obrigatório. O ID de recurso Azure totalmente qualificado do recurso Foundry Tools.

Observações

Existem duas formas de criar ligações à Foundry Tools:

  • Uma ligação para todas as Foundry Tools, exceto Azure AI Search.
  • Uma ligação para cada ferramenta individual da Foundry.

O esquema descrito neste artigo é para uma ligação para todas as Ferramentas Foundry, exceto Azure AI Search.

Embora os az ml connection comandos possam ser usados para gerir tanto ligações Azure Machine Learning como Microsoft Foundry, a ligação Foundry Tools é específica para o Foundry.

Exemplos

Esses exemplos seriam na forma de arquivos YAML e usados a partir da CLI. Por exemplo, az ml connection create -f <file-name>.yaml.

YAML: Chave 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óximos passos