Delen via


Azure AI-services integreren met Service Connector

Op deze pagina ziet u ondersteunde verificatiemethoden en -clients en ziet u voorbeeldcode die u kunt gebruiken om Azure AI Services te verbinden met andere cloudservices met behulp van Service Connector. Mogelijk kunt u nog steeds verbinding maken met Azure AI Services met behulp van andere methoden. Op deze pagina worden ook de standaardnamen en waarden van omgevingsvariabelen weergegeven die u krijgt wanneer u de serviceverbinding maakt.

Ondersteunde rekenservices

Serviceconnector kan worden gebruikt om de volgende rekenservices te verbinden met Azure AI Services:

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

Ondersteunde verificatietypen en clienttypen

In de onderstaande tabel ziet u welke combinaties van verificatiemethoden en clients worden ondersteund voor het verbinden van uw rekenservice met Azure AI Services met behulp van Service Connector. Een 'Ja' geeft aan dat de combinatie wordt ondersteund, terwijl een 'Nee' aangeeft dat deze niet wordt ondersteund.

Client-type Door het systeem toegewezen beheerde identiteit Door de gebruiker toegewezen beheerde identiteit Geheim/verbindingsreeks Service-principal
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
Geen Ja Ja Ja Ja

Deze tabel geeft aan dat alle combinaties van clienttypen en verificatiemethoden in de tabel worden ondersteund. Alle clienttypen kunnen elk van de verificatiemethoden gebruiken om verbinding te maken met Azure AI Services met behulp van Service Connector.

Namen van standaardomgevingsvariabelen of toepassingseigenschappen en voorbeeldcode

Gebruik de onderstaande verbindingsgegevens om rekenservices te verbinden met Azure AI Services. Raadpleeg het artikel Over interne serviceconnector voor meer informatie over naamconventies .

Door het systeem toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-eindpunt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-eindpunt voor spraak-naar-tekst (standard) https://<location>.stt.speech.microsoft.com

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure AI Services met behulp van een door het systeem toegewezen beheerde identiteit.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door Azure AI Services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI Services-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Door de gebruiker toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-eindpunt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-eindpunt voor spraak-naar-tekst (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Uw client-id <client-ID>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure AI Services met behulp van een door de gebruiker toegewezen beheerde identiteit.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door Azure AI Services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI Services-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

    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

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-eindpunt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-eindpunt voor spraak-naar-tekst (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_KEY Api-sleutel voor Azure AI Services <api-key>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure AI Services met behulp van een verbindingsreeks.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door Azure AI Services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Core --version 1.40.0
    
  2. Haal het Azure AI Services-eindpunt en de sleutel op uit de omgevingsvariabelen die zijn toegevoegd door 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));
    

Service-principal

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_AISERVICES_OPENAI_BASE Azure OpenAI-eindpunt https://<your-Azure-AI-Services-endpoint>.openai.azure.com/
AZURE_AISERVICES_COGNITIVESERVICES_ENDPOINT Azure Cognitive Services-tokenproviderservice https://<your-Azure-AI-Services-endpoint>.cognitiveservices.azure.com/
AZURE_AISERVICES_SPEECH_ENDPOINT Api-eindpunt voor spraak-naar-tekst (standard) https://<location>.stt.speech.microsoft.com
AZURE_AISERVICES_CLIENTID Uw client-id <client-ID>
AZURE_AISERVICES_CLIENTSECRET Uw clientgeheim <client-secret>
AZURE_AISERVICES_TENANTID Uw tenant-id <tenant-ID>

Voorbeeldcode

Raadpleeg de stappen en code hieronder om verbinding te maken met Azure AI Services met behulp van een serviceprincipaL.

U kunt de Azure-clientbibliotheek gebruiken voor toegang tot verschillende cognitieve API's die door Azure AI Services worden ondersteund. We gebruiken Azure AI Text Analytics als voorbeeld in dit voorbeeld. Raadpleeg Aanvragen verifiëren bij Azure AI-services om de cognitieve API's rechtstreeks aan te roepen.

  1. Installeer de volgende afhankelijkheden. We gebruiken Azure.AI.TextAnalytics als voorbeeld.

    dotnet add package Azure.AI.TextAnalytics
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure AI Services-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Als u de onderstaande code gebruikt, moet u het gedeelte van het codefragment verwijderen voor het verificatietype dat u wilt gebruiken.

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

Volgende stappen

Volg de onderstaande zelfstudie voor meer informatie over Service Connector.