Compartir a través de

Esquema YAML de conexión de las herramientas de Foundry de la CLI (v2)

SE APLICA A:Extensión de ML de la CLI de Azure v2 (actual)

Nota:

La sintaxis de YAML que se detalla en este documento se basa en el esquema JSON de la versión más reciente de la extensión ML de la CLI v2. Se garantiza que esta sintaxis solo funciona con la versión más reciente de la extensión ML de la CLI v2. Dispone de los esquemas de las versiones de anteriores de la extensión en https://azuremlschemasprod.azureedge.net/.

Sintaxis de YAML

Clave Tipo Descripción Valores permitidos Valor predeterminado
$schema cuerda / cadena Esquema de YAML. Si usa la extensión Visual Studio Code de Azure Machine Learning para crear el archivo YAML, incluya $schema en la parte superior del archivo para invocar las finalizaciones del esquema y los recursos.
name cuerda / cadena Necesario. Nombre de la conexión.
description cuerda / cadena Descripción de la conexión.
tags objeto Diccionario de etiquetas de la conexión.
type cuerda / cadena Necesario. Tipo de conexión. azure_ai_services azure_ai_services
is_shared booleano true si la conexión se comparte entre otros proyectos del centro; de lo contrario, false. true
endpoint cuerda / cadena Necesario. La dirección URL del extremo.
api_key cuerda / cadena Clave de API usada para autenticar la conexión. Si no se proporciona, la conexión se autentica a través de Microsoft Entra ID (autenticación sin credenciales).
ai_services_resource_id cuerda / cadena Necesario. Identificador completo del recurso de Azure Foundry Tools.

Comentarios

Hay dos maneras de crear conexiones a Foundry Tools:

  • Una conexión para todas las herramientas de Foundry, excepto Azure AI Search.
  • Una conexión para cada herramienta de foundry individual.

El esquema descrito en este artículo es para una conexión para todas las herramientas de Foundry, excepto Azure AI Search.

Aunque los az ml connection comandos se pueden usar para administrar conexiones de Azure Machine Learning y Microsoft Foundry, la conexión de Foundry Tools es específica de Foundry.

Ejemplos

Estos ejemplos tendrían formato de archivos YAML y se usarían desde la CLI. Por ejemplo, az ml connection create -f <file-name>.yaml.

YAML: clave de API

#AzureAIServiceConnection.yml

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

YAML: Id. de Microsoft Entra

#AzureAIServiceConnection.yml

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

Pasos siguientes

  • Last updated on