Compartilhar via


Esquema YAML de conexão de ferramentas de fundimento da CLI (v2)

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 Tipo Descrição Valores permitidos Valor padrão
$schema cadeia 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 cadeia Obrigatória. O nome da conexão.
description cadeia A descrição da conexão.
tags objeto O dicionário das marcas de conexão.
type cadeia Obrigatória. 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 Obrigatória. A URL do ponto de extremidade.
api_key cadeia 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 cadeia Obrigatória. A ID de recurso do Azure totalmente qualificada do recurso ferramentas de fundimento.

Comentários

Há duas maneiras de criar conexões com o Foundry Tools:

  • Uma conexão para todas as Ferramentas do Foundry, exceto o Azure AI Search.
  • Uma conexão para cada Ferramenta de Pesquisa individual.

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

Embora os az ml connection comandos possam ser usados para gerenciar conexões do Azure Machine Learning e do Microsoft Foundry, a conexão ferramentas de pesquisa é específica para o Foundry.

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