Dela via


Integrera Azure AI-tjänster med Service Connector

Den här sidan visar autentiseringsmetoder och klienter som stöds och visar exempelkod som du kan använda för att ansluta Azure AI Services till andra molntjänster med hjälp av Service Connector. Du kanske fortfarande kan ansluta till Azure AI Services med hjälp av andra metoder. På den här sidan visas även standardnamn och värden för miljövariabler som du får när du skapar tjänstanslutningen.

Beräkningstjänster som stöds

Service Connector kan användas för att ansluta följande beräkningstjänster till Azure AI Services:

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

Autentiseringstyper och klienttyper som stöds

Tabellen nedan visar vilka kombinationer av autentiseringsmetoder och klienter som stöds för att ansluta din beräkningstjänst till Azure AI Services med hjälp av Service Connector. Ett "Ja" anger att kombinationen stöds, medan ett "Nej" anger att den inte stöds.

Klienttyp Systemtilldelad hanterad identitet Användartilldelad hanterad identitet Hemlighet/anslutningssträng Tjänstens huvudnamn
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
None Ja Ja Ja Ja

Den här tabellen anger att alla kombinationer av klienttyper och autentiseringsmetoder i tabellen stöds. Alla klienttyper kan använda någon av autentiseringsmetoderna för att ansluta till Azure AI Services med hjälp av Service Connector.

Standardnamn för miljövariabler eller programegenskaper och exempelkod

Använd anslutningsinformationen nedan för att ansluta beräkningstjänster till Azure AI Services. Mer information om namngivningskonventioner finns i artikeln interna serviceanslutningsprogram .

Systemtilldelad hanterad identitet

Standardnamn för miljövariabel beskrivning Exempelvärde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-slutpunkt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenprovidertjänst https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-slutpunkt för tal till text (standard) https://<location>.stt.speech.microsoft.com

Exempelkod

Se stegen och koden nedan för att ansluta till Azure AI Services med hjälp av en systemtilldelad hanterad identitet.

Du kan använda Azure-klientbiblioteket för att få åtkomst till olika kognitiva API:er som Azure AI Services stöder. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure AI Services-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder koden nedan avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

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

Användartilldelad hanterad identitet

Standardnamn för miljövariabel beskrivning Exempelvärde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-slutpunkt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenprovidertjänst https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-slutpunkt för tal till text (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Ditt klient-ID <client-ID>

Exempelkod

Se stegen och koden nedan för att ansluta till Azure AI Services med hjälp av en användartilldelad hanterad identitet.

Du kan använda Azure-klientbiblioteket för att få åtkomst till olika kognitiva API:er som Azure AI Services stöder. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure AI Services-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder koden nedan avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

    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

Standardnamn för miljövariabel beskrivning Exempelvärde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-slutpunkt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenprovidertjänst https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-slutpunkt för tal till text (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Api-nyckel för Azure AI Services <api-key>

Exempelkod

Se stegen och koden nedan för att ansluta till Azure AI Services med hjälp av en anslutningssträng.

Du kan använda Azure-klientbiblioteket för att få åtkomst till olika kognitiva API:er som Azure AI Services stöder. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Hämta Azure AI Services-slutpunkten och nyckeln från miljövariablerna som lagts till av 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));
    

Tjänstens huvudnamn

Standardnamn för miljövariabel beskrivning Exempelvärde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-slutpunkt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenprovidertjänst https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-slutpunkt för tal till text (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Ditt klient-ID <client-ID>
AZURE_AISERVICES_CLIENTSECRET Din klienthemlighet <client-secret>
AZURE_AISERVICES_TENANTID Ditt klientorganisations-ID <tenant-ID>

Exempelkod

Se stegen och koden nedan för att ansluta till Azure AI Services med hjälp av en tjänst principaL.

Du kan använda Azure-klientbiblioteket för att få åtkomst till olika kognitiva API:er som Azure AI Services stöder. Vi använder Azure AI-Textanalys som exempel i det här exemplet. Se Autentisera begäranden till Azure AI-tjänster för att anropa de kognitiva API:erna direkt.

  1. Installera följande beroenden. Vi använder Azure.AI.TextAnalytics som exempel.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure AI Services-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder koden nedan avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.

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

Nästa steg

Följ självstudien nedan om du vill veta mer om Service Connector.