Schemat YAML połączenia usług Azure AI Services (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 | Type | Opis | Dozwolone wartości | Domyślna wartość |
|---|---|---|---|---|
$schema |
string | 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 |
string | Wymagany. Nazwa połączenia. | ||
description |
string | Opis połączenia. | ||
tags |
obiekt | Słownik tagów połączenia. | ||
type |
string | Wymagany. Typ połączenia. | azure_ai_services |
azure_ai_services |
is_shared |
boolean | true jeśli połączenie jest współużytkowane przez inne projekty w centrum; w przeciwnym razie, false. |
true |
|
endpoint |
string | Wymagany. Adres URL punktu końcowego. | ||
api_key |
string | 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 |
string | Wymagany. W pełni kwalifikowany identyfikator zasobu usługi Azure AI Services. |
Uwagi
Istnieją dwa sposoby tworzenia połączeń z usługami Azure AI:
- Jedno połączenie dla wszystkich usług Azure AI z wyjątkiem usługi Azure AI Search.
- Jedno połączenie dla każdej pojedynczej usługi Azure AI.
Schemat opisany w tym artykule dotyczy jednego połączenia dla wszystkich usług Azure AI z wyjątkiem usługi Azure AI Search.
az ml connection Chociaż polecenia mogą służyć do zarządzania połączeniami usług Azure Machine Learning i Azure AI Studio, połączenie usług Azure AI Services jest specyficzne dla usługi Azure AI Studio.
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/