Udostępnij za pośrednictwem


Nawiązywanie połączenia z zasobem wielosłużowym usługi Azure AI za pomocą łącznika usługi

Ta strona zawiera informacje na temat obsługiwanych metod uwierzytelniania i klientów oraz przykładowego kodu służącego do łączenia zasobu wieloskładnikowego usługi Azure AI z innymi usługami w chmurze przy użyciu łącznika usługi. Ta strona zawiera również listę domyślnych nazw zmiennych środowiskowych i wartości uzyskanych podczas tworzenia połączenia z usługą.

Obsługiwane usługi obliczeniowe

Łącznik usługi może służyć do łączenia następujących usług obliczeniowych z zasobem wielosługi usługi Azure AI:

  • Azure App Service
  • Azure Container Apps
  • Azure Functions
  • Azure Kubernetes Service (AKS)
  • Azure Spring Apps

Obsługiwane typy uwierzytelniania i typy klientów

W poniższej tabeli przedstawiono metody uwierzytelniania i klientów obsługiwanych do łączenia usługi obliczeniowej z zasobem wieloskładnikowym usługi Azure AI przy użyciu łącznika usługi. Wartość "Tak" wskazuje, że kombinacja jest obsługiwana, a wartość "Nie" wskazuje, że nie jest obsługiwana.

Typ klienta Tożsamość zarządzana przypisana przez system Tożsamość zarządzana przypisana przez użytkownika Wpis tajny/parametry połączenia Jednostka usługi
.NET Tak Tak Tak Tak
Java Tak Tak Tak Tak
Node.js Tak Tak Tak Tak
Python Tak Tak Tak Tak
None Tak Tak Tak Tak

Ta tabela wskazuje, że obsługiwane są wszystkie kombinacje typów klientów i metod uwierzytelniania w tabeli. Wszystkie typy klientów mogą używać dowolnej z metod uwierzytelniania w celu nawiązania połączenia z zasobem wieloskładnikowym usługi Azure AI przy użyciu łącznika usługi.

Domyślne nazwy zmiennych środowiskowych lub właściwości aplikacji i przykładowy kod

Skorzystaj z poniższych szczegółów połączenia, aby połączyć usługi obliczeniowe z zasobem wielosłużowym usługi Azure AI. Aby uzyskać więcej informacji na temat konwencji nazewnictwa, zapoznaj się z artykułem Dotyczącym wewnętrznych łączników usług.

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z zasobem wielosłużeniowym usługi azure AI przy użyciu tożsamości zarządzanej przypisanej przez system.

Bibliotekę klienta platformy Azure można używać do uzyskiwania dostępu do różnych interfejsów API poznawczych, które obsługuje wielosób usługi Azure AI. W tym przykładzie używamy usługi Azure AI analiza tekstu. Zapoznaj się z tematem Authentication requests to Azure AI services (Uwierzytelnianie żądań w usługach Azure AI), aby bezpośrednio wywołać interfejsy API poznawcze.

  1. Zainstaluj następujące zależności. Azure.AI.TextAnalytics Używamy jako przykładu.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Uwierzytelnianie przy użyciu biblioteki tożsamości platformy Azure i uzyskiwanie punktu końcowego zasobów wielosłużeniowych usługi Azure AI z zmiennych środowiskowych dodanych przez łącznik usługi. Korzystając z poniższego kodu, usuń komentarz z części fragmentu kodu dla typu uwierzytelniania, którego chcesz użyć.

    using Azure.AI.TextAnalytics;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
    
    // Uncomment the following lines corresponding to the authentication type you want to use.
    // system-assigned managed identity
    // var credential = new DefaultAzureCredential();
    
    // user-assigned managed identity
    // var credential = new DefaultAzureCredential(
    //     new DefaultAzureCredentialOptions
    //     {
    //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    TextAnalyticsClient languageServiceClient = new(
      new Uri(endpoint),
      credential);
    

Tożsamość zarządzana przypisana przez użytkownika

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Identyfikator klienta <client-ID>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z zasobem wielosób usługi azure AI przy użyciu tożsamości zarządzanej przypisanej przez użytkownika.

Bibliotekę klienta platformy Azure można używać do uzyskiwania dostępu do różnych interfejsów API poznawczych, które obsługuje wielosób usługi Azure AI. W tym przykładzie używamy usługi Azure AI analiza tekstu. Zapoznaj się z tematem Authentication requests to Azure AI services (Uwierzytelnianie żądań w usługach Azure AI), aby bezpośrednio wywołać interfejsy API poznawcze.

  1. Zainstaluj następujące zależności. Azure.AI.TextAnalytics Używamy jako przykładu.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Uwierzytelnianie przy użyciu biblioteki tożsamości platformy Azure i uzyskiwanie punktu końcowego zasobów wielosłużeniowych usługi Azure AI z zmiennych środowiskowych dodanych przez łącznik usługi. Korzystając z poniższego kodu, usuń komentarz z części fragmentu kodu dla typu uwierzytelniania, którego chcesz użyć.

    using Azure.AI.TextAnalytics;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
    
    // Uncomment the following lines corresponding to the authentication type you want to use.
    // system-assigned managed identity
    // var credential = new DefaultAzureCredential();
    
    // user-assigned managed identity
    // var credential = new DefaultAzureCredential(
    //     new DefaultAzureCredentialOptions
    //     {
    //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    TextAnalyticsClient languageServiceClient = new(
      new Uri(endpoint),
      credential);
    

Connection string

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_KEY Klucz interfejsu API zasobu obejmującego wiele usług platformy Azure AI <api-key>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z zasobem wielosłużowym usługi azure AI przy użyciu parametry połączenia.

Bibliotekę klienta platformy Azure można używać do uzyskiwania dostępu do różnych interfejsów API poznawczych, które obsługuje wielosób usługi Azure AI. W tym przykładzie używamy usługi Azure AI analiza tekstu. Zapoznaj się z tematem Authentication requests to Azure AI services (Uwierzytelnianie żądań w usługach Azure AI), aby bezpośrednio wywołać interfejsy API poznawcze.

  1. Zainstaluj następujące zależności. Azure.AI.TextAnalytics Używamy jako przykładu.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Pobierz punkt końcowy i klucz zasobu wielosłużytowego usługi Azure AI ze zmiennych środowiskowych dodanych przez łącznik usługi.

    using Azure.AI.TextAnalytics;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT")
    string key = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_KEY");
    
    TextAnalyticsClient languageServiceClient = new(
      new Uri(endpoint),
      new AzureKeyCredential(key));
    

Jednostka usługi

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<cognitive-service-name>.cognitiveservices.azure.com/
AZURE_COGNITIVESERVICES_CLIENTID Identyfikator klienta <client-ID>
AZURE_COGNITIVESERVICES_CLIENTSECRET Klucz tajny klienta <client-secret>
AZURE_COGNITIVESERVICES_TENANTID Identyfikator dzierżawy <tenant-ID>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z zasobem wielosłużowym usługi Azure AI przy użyciu usługi principaL.

Bibliotekę klienta platformy Azure można używać do uzyskiwania dostępu do różnych interfejsów API poznawczych, które obsługuje wielosób usługi Azure AI. W tym przykładzie używamy usługi Azure AI analiza tekstu. Zapoznaj się z tematem Authentication requests to Azure AI services (Uwierzytelnianie żądań w usługach Azure AI), aby bezpośrednio wywołać interfejsy API poznawcze.

  1. Zainstaluj następujące zależności. Azure.AI.TextAnalytics Używamy jako przykładu.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Uwierzytelnianie przy użyciu biblioteki tożsamości platformy Azure i uzyskiwanie punktu końcowego zasobów wielosłużeniowych usługi Azure AI z zmiennych środowiskowych dodanych przez łącznik usługi. Korzystając z poniższego kodu, usuń komentarz z części fragmentu kodu dla typu uwierzytelniania, którego chcesz użyć.

    using Azure.AI.TextAnalytics;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_ENDPOINT");
    
    // Uncomment the following lines corresponding to the authentication type you want to use.
    // system-assigned managed identity
    // var credential = new DefaultAzureCredential();
    
    // user-assigned managed identity
    // var credential = new DefaultAzureCredential(
    //     new DefaultAzureCredentialOptions
    //     {
    //         ManagedIdentityClientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_COGNITIVESERVICES_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    TextAnalyticsClient languageServiceClient = new(
      new Uri(endpoint),
      credential);