Den här sidan innehåller information om autentiseringsmetoder och klienter som stöds. Den innehåller exempelkod som du kan använda för att ansluta beräkningstjänster till Azure OpenAI i Foundry Models med hjälp av Service Connector. På den här sidan visas även standardnamn och värden för miljövariabler som hämtas när du skapar tjänstanslutningar.
Beräkningstjänster som stöds
Service Connector kan användas för att ansluta följande beräkningstjänster till Azure OpenAI:
- Azure App Service
- Azure Container Apps
- Azure Functions
- Azure Kubernetes Service (AKS)
- Azure Spring Apps
Autentiseringstyper och klienttyper som stöds
Den här tabellen visar vilka kombinationer av autentiseringsmetoder och klienter som stöds för att ansluta din beräkningstjänst till Azure OpenAI med hjälp av Service Connector. Ett "Ja" anger att kombinationen stöds, medan ett "Nej" anger att den inte stöds.
| Klienttyp |
Systemtilldelad hanterad identitet |
Användartilldelad hanterad identitet |
Hemlighet/anslutningssträng |
Tjänstens huvudnamn |
| .NET |
Ja |
Ja |
Ja |
Ja |
| Java |
Ja |
Ja |
Ja |
Ja |
| Node.js |
Ja |
Ja |
Ja |
Ja |
| Python |
Ja |
Ja |
Ja |
Ja |
| Ingen |
Ja |
Ja |
Ja |
Ja |
Den här tabellen anger att alla kombinationer av klienttyper och autentiseringsmetoder i tabellen stöds. Alla klienttyper kan använda någon av autentiseringsmetoderna för att ansluta till Azure OpenAI med hjälp av Service Connector.
Standardnamn för miljövariabler eller programegenskaper och exempelkod
Använd följande anslutningsinformation för att ansluta beräkningstjänster till Azure OpenAI. Mer information finns i Namngivningskonvention för konfiguration.
Systemtilldelad hanterad identitet
| Standardnamn för miljövariabel |
beskrivning |
Exempelvärde |
| AZURE_OPENAI_BASE |
Azure OpenAI-slutpunkt |
https://<Azure-OpenAI-name>.openai.azure.com/ |
Exempelkod
Om du vill ansluta till Azure OpenAI med hjälp av en systemtilldelad hanterad identitet läser du följande steg och kod.
Installera beroenden.
dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
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
);
Lägg till följande beroenden i din pom.xml-fil :
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-openai</artifactId>
<version>1.0.0-beta.6</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.11.4</version>
</dependency>
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .clientSecret(System.getenv("AZURE_OPENAI_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_OPENAI_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_OPENAI_BASE");
OpenAIClient client = new OpenAIClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
Installera beroenden.
pip install openai
pip install azure-identity
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import os
import OpenAI
from azure.identity import ManagedIdentityCredential, ClientSecretCredential, get_bearer_token_provider
# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_OPENAI_TENANTID')
# client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# client_secret = os.getenv('AZURE_OPENAI_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
token_provider = get_bearer_token_provider(
cred, "https://cognitiveservices.azure.com/.default"
)
endpoint = os.getenv('AZURE_OPENAI_BASE')
client = AzureOpenAI(
api_version="2024-02-15-preview",
azure_endpoint=endpoint,
azure_ad_token_provider=token_provider
)
Installera beroenden.
npm install --save @azure/identity
npm install @azure/openai
Autentisera med hjälp av @azure/identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_OPENAI_TENANTID;
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const clientSecret = process.env.AZURE_OPENAI_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_OPENAI_BASE;
const client = new OpenAIClient(endpoint, credential);
För andra språk kan du använda anslutningsinformationen som Service Connector anger till miljövariablerna för att ansluta till Azure OpenAI. Information om miljövariabler finns i Integrera Azure OpenAI med Service Connector.
Användartilldelad hanterad identitet
| Standardnamn för miljövariabel |
beskrivning |
Exempelvärde |
| AZURE_OPENAI_BASE |
Azure OpenAI-slutpunkt |
https://<Azure-OpenAI-name>.openai.azure.com/ |
| AZURE_OPENAI_CLIENTID |
Ditt klient-ID |
<client-ID> |
Exempelkod
Om du vill ansluta till Azure OpenAI med hjälp av en användartilldelad hanterad identitet läser du följande steg och kod.
Installera beroenden.
dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
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
);
Lägg till följande beroenden i din pom.xml-fil :
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-openai</artifactId>
<version>1.0.0-beta.6</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.11.4</version>
</dependency>
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .clientSecret(System.getenv("AZURE_OPENAI_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_OPENAI_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_OPENAI_BASE");
OpenAIClient client = new OpenAIClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
Installera beroenden.
pip install openai
pip install azure-identity
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import os
import OpenAI
from azure.identity import ManagedIdentityCredential, ClientSecretCredential, get_bearer_token_provider
# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_OPENAI_TENANTID')
# client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# client_secret = os.getenv('AZURE_OPENAI_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
token_provider = get_bearer_token_provider(
cred, "https://cognitiveservices.azure.com/.default"
)
endpoint = os.getenv('AZURE_OPENAI_BASE')
client = AzureOpenAI(
api_version="2024-02-15-preview",
azure_endpoint=endpoint,
azure_ad_token_provider=token_provider
)
Installera beroenden.
npm install --save @azure/identity
npm install @azure/openai
Autentisera med hjälp av @azure/identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_OPENAI_TENANTID;
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const clientSecret = process.env.AZURE_OPENAI_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_OPENAI_BASE;
const client = new OpenAIClient(endpoint, credential);
För andra språk kan du använda anslutningsinformationen som Service Connector anger till miljövariablerna för att ansluta till Azure OpenAI. Information om miljövariabler finns i Integrera Azure OpenAI med Service Connector.
Anslutningssträng
| Standardnamn för miljövariabel |
beskrivning |
Exempelvärde |
| AZURE_OPENAI_BASE |
Azure OpenAI-slutpunkt |
https://<Azure-OpenAI-name>.openai.azure.com/ |
| AZURE_OPENAI_KEY |
Azure OpenAI API-nyckel |
<api-key> |
Exempelkod
Om du vill ansluta till Azure OpenAI med hjälp av en anslutningssträng läser du följande steg och kod.
Installera följande beroenden.
dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Core --version 1.40.0
Hämta Azure OpenAI-slutpunkten och API-nyckeln från miljövariablerna som lagts till av 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));
Lägg till följande beroende i dinpom.xml-fil :
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-core</artifactId>
<version>1.49.1</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-openai</artifactId>
<version>1.0.0-beta.6</version>
</dependency>
Hämta Azure OpenAI-slutpunkten och API-nyckeln från miljövariablerna som lagts till av Service Connector.
String endpoint = System.getenv("AZURE_OPENAI_BASE");
String key = System.getenv("AZURE_OPENAI_KEY");
OpenAIClient client = new OpenAIClientBuilder()
.credential(new AzureKeyCredential(key))
.endpoint(endpoint)
.buildClient();
Installera följande beroenden.
pip install openai
pip install azure-core
Hämta Azure OpenAI-slutpunkten och API-nyckeln från miljövariablerna som lagts till av Service Connector.
import os
from openai import AzureOpenAI
from azure.core.credentials import AzureKeyCredential
key = os.environ['AZURE_OPENAI_KEY']
endpoint = os.environ['AZURE_OPENAI_BASE']
client = AzureOpenAI(
api_version="2024-02-15-preview",
azure_endpoint=endpoint,
api_key=key
)
Installera följande beroenden.
npm install @azure/openai
npm install @azure/core-auth
Hämta Azure OpenAI-slutpunkten och API-nyckeln från miljövariablerna som lagts till av Service Connector.
import { OpenAIClient } from "@azure/openai";
import { AzureKeyCredential } from "@azure/core-auth";
const endpoint = process.env.AZURE_OPENAI_BASE;
const credential = new AzureKeyCredential(process.env.AZURE_OPENAI_KEY);
const client = new OpenAIClient(endpoint, credential);
För andra språk kan du använda anslutningsinformationen som Service Connector anger till miljövariablerna för att ansluta till Azure OpenAI. Information om miljövariabler finns i Integrera Azure OpenAI med Service Connector.
Tjänstens huvudnamn
| Standardnamn för miljövariabel |
beskrivning |
Exempelvärde |
| AZURE_OPENAI_BASE |
Azure OpenAI-slutpunkt |
https://<Azure-OpenAI-name>.openai.azure.com/ |
| AZURE_OPENAI_CLIENTID |
Ditt klient-ID |
<client-ID> |
| AZURE_OPENAI_CLIENTSECRET |
Din klienthemlighet |
<client-secret> |
| AZURE_OPENAI_TENANTID |
Ditt klientorganisations-ID |
<tenant-ID> |
Exempelkod
Om du vill ansluta till Azure OpenAI med ett huvudnamn för tjänsten läser du följande steg och kod.
Installera beroenden.
dotnet add package Azure.AI.OpenAI --prerelease
dotnet add package Azure.Identity
Autentisera med hjälp av Azure Identity-biblioteket och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
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
);
Lägg till följande beroenden i din pom.xml-fil :
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-openai</artifactId>
<version>1.0.0-beta.6</version>
</dependency>
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-identity</artifactId>
<version>1.11.4</version>
</dependency>
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder().build();
// for user-assigned managed identity
// DefaultAzureCredential credential = new DefaultAzureCredentialBuilder()
// .managedIdentityClientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .build();
// for service principal
// ClientSecretCredential credential = new ClientSecretCredentialBuilder()
// .clientId(System.getenv("AZURE_OPENAI_CLIENTID"))
// .clientSecret(System.getenv("AZURE_OPENAI_CLIENTSECRET"))
// .tenantId(System.getenv("AZURE_OPENAI_TENANTID"))
// .build();
String endpoint = System.getenv("AZURE_OPENAI_BASE");
OpenAIClient client = new OpenAIClientBuilder()
.credential(credential)
.endpoint(endpoint)
.buildClient();
Installera beroenden.
pip install openai
pip install azure-identity
Autentisera med hjälp av azure-identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import os
import OpenAI
from azure.identity import ManagedIdentityCredential, ClientSecretCredential, get_bearer_token_provider
# Uncomment the following lines corresponding to the authentication type you want to use.
# system-assigned managed identity
# cred = ManagedIdentityCredential()
# user-assigned managed identity
# managed_identity_client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# cred = ManagedIdentityCredential(client_id=managed_identity_client_id)
# service principal
# tenant_id = os.getenv('AZURE_OPENAI_TENANTID')
# client_id = os.getenv('AZURE_OPENAI_CLIENTID')
# client_secret = os.getenv('AZURE_OPENAI_CLIENTSECRET')
# cred = ClientSecretCredential(tenant_id=tenant_id, client_id=client_id, client_secret=client_secret)
token_provider = get_bearer_token_provider(
cred, "https://cognitiveservices.azure.com/.default"
)
endpoint = os.getenv('AZURE_OPENAI_BASE')
client = AzureOpenAI(
api_version="2024-02-15-preview",
azure_endpoint=endpoint,
azure_ad_token_provider=token_provider
)
Installera beroenden.
npm install --save @azure/identity
npm install @azure/openai
Autentisera med hjälp av @azure/identity och hämta Azure OpenAI-slutpunkten från miljövariablerna som lagts till av Service Connector. När du använder följande kod avkommentarer du delen av kodfragmentet för den autentiseringstyp som du vill använda.
import { DefaultAzureCredential,ClientSecretCredential } from "@azure/identity";
// Uncomment the following lines corresponding to the authentication type you want to use.
// for system-assigned managed identity
// const credential = new DefaultAzureCredential();
// for user-assigned managed identity
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const credential = new DefaultAzureCredential({
// managedIdentityClientId: clientId
// });
// for service principal
// const tenantId = process.env.AZURE_OPENAI_TENANTID;
// const clientId = process.env.AZURE_OPENAI_CLIENTID;
// const clientSecret = process.env.AZURE_OPENAI_CLIENTSECRET;
// const credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
const endpoint = process.env.AZURE_OPENAI_BASE;
const client = new OpenAIClient(endpoint, credential);
För andra språk kan du använda anslutningsinformationen som Service Connector anger till miljövariablerna för att ansluta till Azure OpenAI. Information om miljövariabler finns i Integrera Azure OpenAI med Service Connector.
Relaterat innehåll