Freigeben über


Herstellen einer Verbindung mit Azure OpenAI in Foundry-Modellen mithilfe von Service Connector

Diese Seite enthält Informationen zu unterstützten Authentifizierungsmethoden und Clients. Es stellt Beispielcode bereit, den Sie verwenden können, um Computedienste mit Azure OpenAI in Foundry-Modellen mithilfe von Service Connector zu verbinden. Auf dieser Seite werden auch die Namen und Werte der Standardumgebungsvariablen aufgelistet, die beim Erstellen von Dienstverbindungen abgerufen werden.

Unterstützte Computedienste

Service Connector kann verwendet werden, um die folgenden Computedienste mit Azure OpenAI zu verbinden:

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

Unterstützte Authentifizierungstypen und Clienttypen

Diese Tabelle zeigt, welche Kombinationen von Authentifizierungsmethoden und Clients für die Verbindung Ihres Computediensts mit Azure OpenAI mithilfe von Service Connector unterstützt werden. Ein "Ja" gibt an, dass die Kombination unterstützt wird, während ein "Nein" angibt, dass sie nicht unterstützt wird.

Clienttyp Systemseitig zugewiesene verwaltete Identität Benutzerseitig zugewiesene verwaltete Identität Geheimnis/Verbindungszeichenfolge Dienstprinzipal
.NET Ja Ja Ja Ja
Java Ja Ja Ja Ja
Node.js Ja Ja Ja Ja
Python Ja Ja Ja Ja
Keine Ja Ja Ja Ja

In der Tabelle wird angegeben, dass alle Kombinationen von Clienttypen und Authentifizierungsmethoden in der Tabelle unterstützt werden. Alle Clienttypen können jede der Authentifizierungsmethoden verwenden, um mithilfe von Service Connector eine Verbindung mit Azure OpenAI herzustellen.

Namen von Standard-Umgebungsvariablen oder Anwendungseigenschaften und Beispielcode

Verwenden Sie die folgenden Verbindungsdetails, um Computedienste mit Azure OpenAI zu verbinden. Weitere Informationen finden Sie unter Konfigurationsbenennungskonvention.

Systemseitig zugewiesene verwaltete Identität

Name der Standard-Umgebungsvariable BESCHREIBUNG Beispielwert
AZURE_OPENAI_BASE Azure OpenAI-Endpunkt https://<Azure-OpenAI-name>.openai.azure.com/

Beispielcode

Informationen zum Herstellen einer Verbindung mit Azure OpenAI mithilfe einer vom System zugewiesenen verwalteten Identität finden Sie in den folgenden Schritten und Code.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Azure OpenAI-Endpunkt aus den vom Dienstconnector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeausschnitts für den Authentifizierungstyp auf, den Sie verwenden möchten.

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

Benutzerseitig zugewiesene verwaltete Identität

Name der Standard-Umgebungsvariable BESCHREIBUNG Beispielwert
AZURE_OPENAI_BASE Azure OpenAI-Endpunkt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID Ihre Client-ID <client-ID>

Beispielcode

Informationen zum Herstellen einer Verbindung mit Azure OpenAI mithilfe einer vom Benutzer zugewiesenen verwalteten Identität finden Sie in den folgenden Schritten und Code.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Azure OpenAI-Endpunkt aus den vom Dienstconnector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeausschnitts für den Authentifizierungstyp auf, den Sie verwenden möchten.

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

Verbindungszeichenfolge

Name der Standard-Umgebungsvariable BESCHREIBUNG Beispielwert
AZURE_OPENAI_BASE Azure OpenAI-Endpunkt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_KEY Azure OpenAI-API-Schlüssel <api-key>

Beispielcode

Informationen zum Herstellen einer Verbindung mit Azure OpenAI mithilfe einer Verbindungszeichenfolge finden Sie in den folgenden Schritten und Code.

  1. Installieren Sie die folgenden Abhängigkeiten.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Core --version 1.40.0
    
  2. Rufen Sie den Azure OpenAI-Endpunkt und -API-Schlüssel aus den vom Dienstconnector hinzugefügten Umgebungsvariablen ab.

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

Dienstprinzipal

Name der Standard-Umgebungsvariable BESCHREIBUNG Beispielwert
AZURE_OPENAI_BASE Azure OpenAI-Endpunkt https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID Ihre Client-ID <client-ID>
AZURE_OPENAI_CLIENTSECRET Ihr geheimer Clientschlüssel <client-secret>
AZURE_OPENAI_TENANTID Ihre Mandanten-ID <tenant-ID>

Beispielcode

Informationen zum Herstellen einer Verbindung mit Azure OpenAI mithilfe eines Dienstprinzipals finden Sie in den folgenden Schritten und Code.

  1. Installieren Sie Abhängigkeiten.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Authentifizieren Sie sich mithilfe der Azure Identity-Bibliothek, und rufen Sie den Azure OpenAI-Endpunkt aus den vom Dienstconnector hinzugefügten Umgebungsvariablen ab. Wenn Sie den folgenden Code verwenden, heben Sie die Auskommentierung des Teils des Codeausschnitts für den Authentifizierungstyp auf, den Sie verwenden möchten.

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