Sdílet prostřednictvím


Integrace služeb Azure AI s konektorem Service Connector

Tato stránka ukazuje podporované metody ověřování a klienty a ukazuje ukázkový kód, který můžete použít k připojení služeb Azure AI k jiným cloudovým službám pomocí konektoru služby. Stále se můžete připojit ke službám Azure AI pomocí jiných metod. Tato stránka také zobrazuje výchozí názvy proměnných prostředí a hodnoty, které získáte při vytváření připojení služby.

Podporované výpočetní služby

Konektor služby se dá použít k připojení následujících výpočetních služeb ke službám Azure AI:

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

Podporované typy ověřování a typy klientů

Následující tabulka ukazuje, které kombinace metod ověřování a klientů se podporují pro připojení výpočetní služby ke službám Azure AI pomocí konektoru služby. "Ano" označuje, že kombinace je podporována, zatímco "Ne" označuje, že není podporována.

Typ klienta Spravovaná identita přiřazená systémem Spravovaná identita přiřazená uživatelem Tajný kód/připojovací řetězec Instanční objekt
.NET Ano Ano Ano Yes
Java Ano Ano Ano Yes
Node.js Ano Ano Ano Yes
Python Ano Ano Ano Yes
Nic Ano Ano Ano Yes

Tato tabulka označuje, že jsou podporovány všechny kombinace typů klientů a metod ověřování v tabulce. Všechny typy klientů můžou pro připojení ke službám Azure AI pomocí konektoru služby použít některou z metod ověřování.

Výchozí názvy proměnných prostředí nebo vlastnosti aplikace a ukázkový kód

Pomocí níže uvedených podrobností o připojení připojte výpočetní služby ke službám Azure AI. Další informace o konvencích vytváření názvů najdete v interním článku o konektoru služby.

Spravovaná identita přiřazená systémem

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_AISERVICES_OPENAI_BASE Koncový bod Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Služba zprostředkovatele tokenů Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Koncový bod rozhraní API pro převod řeči na text (Standard) https://<location>.stt.speech.microsoft.com

Ukázkový kód

Pokud se chcete připojit ke službám Azure AI pomocí spravované identity přiřazené systémem, projděte si následující postup a kód.

Klientskou knihovnu Azure můžete použít pro přístup k různým kognitivním rozhraním API, která podporují služby Azure AI Services. Jako příklad v této ukázce používáme Analýza textu Azure AI. Projděte si žádosti o ověření ve službách Azure AI a volejte přímo kognitivní rozhraní API.

  1. Nainstalujte následující závislosti. Jako příklad použijeme Azure.AI.TextAnalytics .

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny identit Azure a získejte koncový bod služby Azure AI Services z proměnných prostředí přidaných konektorem služby Service Connector. Při použití následujícího kódu odkomentujte část fragmentu kódu pro typ ověřování, který chcete použít.

    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);
    

Spravovaná identita přiřazená uživatelem

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_AISERVICES_OPENAI_BASE Koncový bod Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Služba zprostředkovatele tokenů Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Koncový bod rozhraní API pro převod řeči na text (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID ID klienta <client-ID>

Ukázkový kód

Projděte si následující kroky a kód a připojte se ke službám Azure AI pomocí spravované identity přiřazené uživatelem.

Klientskou knihovnu Azure můžete použít pro přístup k různým kognitivním rozhraním API, která podporují služby Azure AI Services. Jako příklad v této ukázce používáme Analýza textu Azure AI. Projděte si žádosti o ověření ve službách Azure AI a volejte přímo kognitivní rozhraní API.

  1. Nainstalujte následující závislosti. Jako příklad použijeme Azure.AI.TextAnalytics .

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny identit Azure a získejte koncový bod služby Azure AI Services z proměnných prostředí přidaných konektorem služby Service Connector. Při použití následujícího kódu odkomentujte část fragmentu kódu pro typ ověřování, který chcete použít.

    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

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_AISERVICES_OPENAI_BASE Koncový bod Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Služba zprostředkovatele tokenů Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Koncový bod rozhraní API pro převod řeči na text (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Klíč rozhraní API služby Azure AI Services <api-key>

Ukázka kódu

Informace o připojení ke službám Azure AI pomocí připojovací řetězec najdete v následujících krocích a kódu.

Klientskou knihovnu Azure můžete použít pro přístup k různým kognitivním rozhraním API, která podporují služby Azure AI Services. Jako příklad v této ukázce používáme Analýza textu Azure AI. Projděte si žádosti o ověření ve službách Azure AI a volejte přímo kognitivní rozhraní API.

  1. Nainstalujte následující závislosti. Jako příklad použijeme Azure.AI.TextAnalytics .

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Získejte koncový bod služby Azure AI Services a klíč z proměnných prostředí přidaných konektorem služby Service Connector.

    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));
    

Instanční objekt

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_AISERVICES_OPENAI_BASE Koncový bod Azure OpenAI https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Služba zprostředkovatele tokenů Azure Cognitive Services https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Koncový bod rozhraní API pro převod řeči na text (Standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID ID klienta <client-ID>
AZURE_AISERVICES_CLIENTSECRET Tajný klíč klienta <client-secret>
AZURE_AISERVICES_TENANTID ID vašeho tenanta <tenant-ID>

Ukázkový kód

Informace o připojení ke službám Azure AI pomocí principaL služby najdete v následujících krocích a kódu.

Klientskou knihovnu Azure můžete použít pro přístup k různým kognitivním rozhraním API, která podporují služby Azure AI Services. Jako příklad v této ukázce používáme Analýza textu Azure AI. Projděte si žádosti o ověření ve službách Azure AI a volejte přímo kognitivní rozhraní API.

  1. Nainstalujte následující závislosti. Jako příklad použijeme Azure.AI.TextAnalytics .

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny identit Azure a získejte koncový bod služby Azure AI Services z proměnných prostředí přidaných konektorem služby Service Connector. Při použití následujícího kódu odkomentujte část fragmentu kódu pro typ ověřování, který chcete použít.

    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);
    

Další kroky

Další informace o konektoru Service Connector najdete v níže uvedeném kurzu.