Udostępnij przez


Schemat YAML w narzędziu Foundry Tools (wersja 2)

DOTYCZY: Rozszerzenie interfejsu wiersza polecenia platformy Azure ml w wersji 2 (bieżąca)

Uwaga

Składnia YAML szczegółowo w tym dokumencie jest oparta na schemacie JSON dla najnowszej wersji rozszerzenia interfejsu wiersza polecenia uczenia maszynowego w wersji 2. Ta składnia jest gwarantowana tylko do pracy z najnowszą wersją rozszerzenia interfejsu wiersza polecenia uczenia maszynowego w wersji 2. Schematy dla starszych wersji rozszerzeń można znaleźć pod adresem https://azuremlschemasprod.azureedge.net/.

Składnia YAML

Klucz Typ Opis Dozwolone wartości Domyślna wartość
$schema ciąg Schemat YAML. Jeśli używasz rozszerzenia programu Visual Studio Code usługi Azure Machine Learning do tworzenia pliku YAML, dołącz $schema go w górnej części pliku do wywoływania uzupełniania schematu i zasobów.
name ciąg Wymagany. Nazwa połączenia.
description ciąg Opis połączenia.
tags obiekt Słownik tagów połączenia.
type ciąg Wymagany. Typ połączenia. azure_ai_services azure_ai_services
is_shared typ logiczny (boolowski) true jeśli połączenie jest współużytkowane przez inne projekty w centrum; w przeciwnym razie, false. true
endpoint ciąg Wymagany. Adres URL punktu końcowego.
api_key ciąg Klucz interfejsu API używany do uwierzytelniania połączenia. Jeśli nie zostanie podane, połączenie jest uwierzytelniane za pośrednictwem identyfikatora Entra firmy Microsoft (uwierzytelniania bez poświadczeń).
ai_services_resource_id ciąg Wymagany. W pełni kwalifikowany identyfikator zasobu platformy Azure zasobu narzędzia Foundry Tools.

Uwagi

Istnieją dwa sposoby tworzenia połączeń z narzędziami foundry:

  • Jedno połączenie dla wszystkich narzędzi Foundry z wyjątkiem usługi Azure AI Search.
  • Jedno połączenie dla każdego pojedynczego narzędzia foundry.

Schemat opisany w tym artykule dotyczy jednego połączenia dla wszystkich narzędzi Foundry z wyjątkiem usługi Azure AI Search.

az ml connection Polecenia mogą służyć do zarządzania połączeniami usług Azure Machine Learning i Microsoft Foundry, ale połączenie narzędzi Foundry jest specyficzne dla rozwiązania Foundry.

Przykłady

Te przykłady są w postaci plików YAML i używane z interfejsu wiersza polecenia. Na przykład az ml connection create -f <file-name>.yaml.

YAML: klucz interfejsu 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/

Następne kroki