Sdílet prostřednictvím


Připojení ke službě Azure OpenAI pomocí konektoru služby

Tato stránka obsahuje informace o podporovaných metodách ověřování a klientech spolu s ukázkovým kódem pro připojení služby Azure OpenAI Service k dalším cloudovým službám pomocí konektoru služby. Tato stránka obsahuje také výchozí názvy proměnných prostředí a hodnoty získané při vytváření připojení služeb.

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ě Azure OpenAI:

  • 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ě Azure OpenAI Service 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ě Azure OpenAI 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ě Azure OpenAI. Další informace o konvencích vytváření názvů najdete v článku interních informací o konektoru service connectoru .

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

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_OPENAI_BASE Koncový bod služby Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/

Ukázkový kód

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

  1. Nainstalujte závislosti.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny Identit Azure a získejte koncový bod Azure OpenAI z proměnných prostředí přidaných konektorem služby. 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.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
    );
    

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

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_OPENAI_BASE Koncový bod služby Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID ID klienta <client-ID>

Ukázkový kód

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

  1. Nainstalujte závislosti.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny Identit Azure a získejte koncový bod Azure OpenAI z proměnných prostředí přidaných konektorem služby. 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.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
    );
    

Connection string

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_OPENAI_BASE Koncový bod služby Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_KEY Klíč rozhraní API služby Azure OpenAI <api-key>

Ukázka kódu

Pokud se chcete připojit ke službě Azure OpenAI pomocí připojovací řetězec, projděte si následující postup a kód.

  1. Nainstalujte následující závislosti.

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

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

Instanční objekt

Výchozí název proměnné prostředí Popis Ukázková hodnota
AZURE_OPENAI_BASE Koncový bod služby Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID ID klienta <client-ID>
AZURE_OPENAI_CLIENTSECRET Tajný klíč klienta <client-secret>
AZURE_OPENAI_TENANTID ID vašeho tenanta <tenant-ID>

Ukázkový kód

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

  1. Nainstalujte závislosti.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Ověřte se pomocí knihovny Identit Azure a získejte koncový bod Azure OpenAI z proměnných prostředí přidaných konektorem služby. 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.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
    );