Delen via


Verbinding maken met Azure OpenAI in Foundry-modellen met behulp van serviceconnector

Deze pagina bevat informatie over ondersteunde verificatiemethoden en -clients. Het biedt voorbeeldcode die u kunt gebruiken om rekenservices te verbinden met Azure OpenAI in Foundry-modellen met behulp van serviceconnector. Op deze pagina worden ook de standaardnamen en waarden van omgevingsvariabelen vermeld die zijn verkregen bij het maken van serviceverbindingen.

Ondersteunde rekenservices

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

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

Ondersteunde verificatietypen en clienttypen

In deze tabel ziet u welke combinaties van verificatiemethoden en -clients worden ondersteund voor het verbinden van uw rekenservice met Azure OpenAI 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 OpenAI met behulp van serviceconnector.

Namen van standaardomgevingsvariabelen of toepassingseigenschappen en voorbeeldcode

Gebruik de volgende verbindingsgegevens om rekenservices te verbinden met Azure OpenAI. Zie Naamconventie voor configuratie voor meer informatie.

Door het systeem toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_OPENAI_BASE Azure OpenAI-eindpunt https://<Azure-OpenAI-name>.openai.azure.com/

Voorbeeldcode

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

  1. Installeer afhankelijkheden.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure OpenAI-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Wanneer u de volgende code gebruikt, moet u commentaar toevoegen aan het deel van het codefragment voor het verificatietype dat u wilt gebruiken.

    using Azure.AI.OpenAI;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_BASE");
    
    // 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_OPENAI_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_OPENAI_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    AzureOpenAIClient openAIClient = new(
      new Uri(endpoint),
      credential
    );
    

Door de gebruiker toegewezen beheerde identiteit

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_OPENAI_BASE Azure OpenAI-eindpunt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID Uw client-id <client-ID>

Voorbeeldcode

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

  1. Installeer afhankelijkheden.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure OpenAI-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Wanneer u de volgende code gebruikt, moet u commentaar toevoegen aan het deel van het codefragment voor het verificatietype dat u wilt gebruiken.

    using Azure.AI.OpenAI;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_BASE");
    
    // 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_OPENAI_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_OPENAI_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    AzureOpenAIClient openAIClient = new(
      new Uri(endpoint),
      credential
    );
    

verbindingsstring

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_OPENAI_BASE Azure OpenAI-eindpunt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_KEY Azure OpenAI API-sleutel <api-key>

Voorbeeldcode

Als u verbinding wilt maken met Azure OpenAI met behulp van een verbindingsreeks, raadpleegt u de volgende stappen en code.

  1. Installeer de volgende afhankelijkheden.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Core --version 1.40.0
    
  2. Haal het Azure OpenAI-eindpunt en de API-sleutel op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector.

    using Azure.AI.OpenAI;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_BASE")
    string key = Environment.GetEnvironmentVariable("AZURE_OPENAI_KEY");
    
    AzureOpenAIClient openAIClient = new(
      new Uri(endpoint),
      new AzureKeyCredential(key));
    

Service-principal

Naam van standaardomgevingsvariabele Beschrijving Voorbeeldwaarde
AZURE_OPENAI_BASE Azure OpenAI-eindpunt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID Uw client-id <client-ID>
AZURE_OPENAI_CLIENTSECRET Uw clientgeheim <client-secret>
AZURE_OPENAI_TENANTID Uw tenant-id <tenant-ID>

Voorbeeldcode

Raadpleeg de volgende stappen en code om verbinding te maken met Azure OpenAI met behulp van een service-principal.

  1. Installeer afhankelijkheden.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Verifieer met behulp van de Azure Identity-bibliotheek en haal het Azure OpenAI-eindpunt op uit de omgevingsvariabelen die zijn toegevoegd door Service Connector. Wanneer u de volgende code gebruikt, moet u commentaar toevoegen aan het deel van het codefragment voor het verificatietype dat u wilt gebruiken.

    using Azure.AI.OpenAI;
    using Azure.Identity;
    
    string endpoint = Environment.GetEnvironmentVariable("AZURE_OPENAI_BASE");
    
    // 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_OPENAI_CLIENTID");
    //     });
    
    // service principal 
    // var tenantId = Environment.GetEnvironmentVariable("AZURE_OPENAI_TENANTID");
    // var clientId = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTID");
    // var clientSecret = Environment.GetEnvironmentVariable("AZURE_OPENAI_CLIENTSECRET");
    // var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
    
    AzureOpenAIClient openAIClient = new(
      new Uri(endpoint),
      credential
    );