Udostępnij za pośrednictwem


Integrowanie usług Azure AI z łącznikiem usługi

Na tej stronie przedstawiono obsługiwane metody uwierzytelniania i klientów oraz pokazano przykładowy kod, którego można użyć do łączenia usług Azure AI z innymi usługami w chmurze przy użyciu łącznika usług. Nadal możesz nawiązać połączenie z usługami Azure AI przy użyciu innych metod. Ta strona zawiera również domyślne nazwy zmiennych środowiskowych i wartości uzyskiwane podczas tworzenia połączenia z usługą.

Obsługiwane usługi obliczeniowe

Łącznik usług może służyć do łączenia następujących usług obliczeniowych z usługami 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 kombinacje metod uwierzytelniania i klientów obsługiwanych do łączenia usługi obliczeniowej z usługami Azure AI Przy użyciu łącznika usługi Service Connector. 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 metody uwierzytelniania w celu nawiązania połączenia z usługami Azure AI Przy użyciu łącznika usług.

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

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

Tożsamość zarządzana przypisana przez system

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_AISERVICES_OPENAI_BASE Punkt końcowy usługi Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Punkt końcowy interfejsu API zamiany mowy na tekst (standardowy) https://<location>.stt.speech.microsoft.com

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z usługami 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ługują usługi Azure AI Services. 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 usług Azure AI Services ze 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_AISERVICES_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_AISERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_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_AISERVICES_OPENAI_BASE Punkt końcowy usługi Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Punkt końcowy interfejsu API zamiany mowy na tekst (standardowy) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Identyfikator klienta <client-ID>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z usługami 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ługują usługi Azure AI Services. 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 usług Azure AI Services ze 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_AISERVICES_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_AISERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_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_AISERVICES_OPENAI_BASE Punkt końcowy usługi Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Punkt końcowy interfejsu API zamiany mowy na tekst (standardowy) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Klucz interfejsu API usług Azure AI Services <api-key>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z usługami 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ługują usługi Azure AI Services. 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 usługi Azure AI Services i klucz ze zmiennych środowiskowych dodanych przez łącznik usługi.

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

Jednostka usługi

Domyślna nazwa zmiennej środowiskowej opis Przykładowa wartość
AZURE_AISERVICES_OPENAI_BASE Punkt końcowy usługi Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Usługa dostawcy tokenów usług Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Punkt końcowy interfejsu API zamiany mowy na tekst (standardowy) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Identyfikator klienta <client-ID>
AZURE_AISERVICES_CLIENTSECRET Klucz tajny klienta <client-secret>
AZURE_AISERVICES_TENANTID Identyfikator dzierżawy <tenant-ID>

Przykładowy kod

Zapoznaj się z poniższymi krokami i kodem, aby nawiązać połączenie z usługami 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ługują usługi Azure AI Services. 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 usług Azure AI Services ze 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_AISERVICES_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_AISERVICES_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_AISERVICES_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    TextAnalyticsClient languageServiceClient = new(
      new Uri(endpoint),
      credential);
    

Następne kroki

Postępuj zgodnie z samouczkiem wymienionym poniżej, aby dowiedzieć się więcej o łączniku usługi.