Bagikan melalui


Menghubungkan ke Azure OpenAI dalam Foundry Models menggunakan Service Connector

Halaman ini menyediakan informasi tentang metode dan klien autentikasi yang didukung. Ini menyediakan kode sampel yang dapat Anda gunakan untuk menghubungkan layanan komputasi ke Azure OpenAI di Model Foundry menggunakan Konektor Layanan. Halaman ini juga mencantumkan nama dan nilai variabel lingkungan default yang diperoleh saat membuat koneksi layanan.

Layanan komputasi yang didukung

Konektor Layanan dapat digunakan untuk menyambungkan layanan komputasi berikut ke Azure OpenAI:

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

Jenis Autentikasi yang Didukung serta jenis klien

Tabel ini memperlihatkan kombinasi metode autentikasi dan klien mana yang didukung untuk menyambungkan layanan komputasi Anda ke Azure OpenAI menggunakan Konektor Layanan. "Ya" menunjukkan bahwa kombinasi didukung, sementara "Tidak" menunjukkan bahwa kombinasi tersebut tidak didukung.

Jenis klien Identitas terkelola yang ditetapkan sistem Identitas terkelola yang ditetapkan pengguna Rahasia/string koneksi Perwakilan layanan
.NET Ya Ya Ya Ya
Java Ya Ya Ya Ya
Node.js Ya Ya Ya Ya
Python Ya Ya Ya Ya
Tidak Ya Ya Ya Ya

Tabel ini menunjukkan bahwa semua kombinasi jenis klien dan metode autentikasi dalam tabel didukung. Semua jenis klien dapat menggunakan salah satu metode autentikasi untuk menyambungkan ke Azure OpenAI menggunakan Konektor Layanan.

Nama variabel lingkungan default atau properti aplikasi dan kode sampel

Gunakan detail koneksi berikut untuk menyambungkan layanan komputasi ke Azure OpenAI. Untuk informasi selengkapnya, lihat Konvensi penamaan konfigurasi.

Identitas terkelola yang ditetapkan sistem

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_OPENAI_BASE Titik akhir Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/

Kode Sampel

Untuk menyambungkan ke Azure OpenAI menggunakan identitas terkelola yang ditetapkan sistem, lihat langkah-langkah dan kode berikut.

  1. Instal dependensi.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan pustaka Azure Identity dan dapatkan titik akhir Azure OpenAI dari variabel lingkungan yang ditambahkan oleh Konektor Layanan. Saat Anda menggunakan kode berikut, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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

Identitas terkelola yang ditetapkan pengguna

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_OPENAI_BASE Titik Akhir Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID ID klien Anda <client-ID>

Kode Sampel

Untuk menyambungkan ke Azure OpenAI menggunakan identitas terkelola yang ditetapkan pengguna, lihat langkah dan kode berikut.

  1. Instal dependensi.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan pustaka Azure Identity dan dapatkan titik akhir Azure OpenAI dari variabel lingkungan yang ditambahkan oleh Konektor Layanan. Saat Anda menggunakan kode berikut, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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

String koneksi

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_OPENAI_BASE Titik Akhir Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_KEY Kunci API Azure OpenAI <api-key>

Kode Sampel

Untuk menyambungkan ke Azure OpenAI menggunakan string koneksi, lihat langkah dan kode berikut.

  1. Instal dependensi berikut.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Core --version 1.40.0
    
  2. Dapatkan titik akhir Azure OpenAI dan kunci API dari variabel lingkungan yang ditambahkan oleh Konektor Layanan.

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

Perwakilan layanan

Nama Variabel Lingkungan Deskripsi Sampel nilai
AZURE_OPENAI_BASE Titik Akhir Azure OpenAI https://<Azure-OpenAI-name>.openai.azure.com/
AZURE_OPENAI_CLIENTID ID klien Anda <client-ID>
AZURE_OPENAI_CLIENTSECRET Rahasia klien Anda <client-secret>
AZURE_OPENAI_TENANTID ID penyewa Anda <tenant-ID>

Kode Sampel

Untuk menyambungkan ke Azure OpenAI menggunakan perwakilan layanan, lihat langkah-langkah dan kode berikut.

  1. Instal dependensi.

    dotnet add package Azure.AI.OpenAI --prerelease
    dotnet add package Azure.Identity
    
  2. Autentikasi menggunakan pustaka Azure Identity dan dapatkan titik akhir Azure OpenAI dari variabel lingkungan yang ditambahkan oleh Konektor Layanan. Saat Anda menggunakan kode berikut, batalkan komentar bagian cuplikan kode untuk jenis autentikasi yang ingin Anda gunakan.

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