Not
Åtkomst till denna sida kräver auktorisation. Du kan prova att logga in eller byta katalog.
Åtkomst till denna sida kräver auktorisation. Du kan prova att byta katalog.
En Foundry-resurs ger enhetlig åtkomst till modeller, agenter och verktyg. Den här artikeln förklarar vilken SDK och slutpunkt som ska användas för ditt scenario.
| SDK | Vad är det för | Endpoint |
|---|---|---|
| Foundry SDK | Foundry-specifika funktioner med OpenAI-kompatibla gränssnitt. Innehåller åtkomst till Foundry-direktmodeller via Responses API (inte slutförande av chattar). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| OpenAI SDK | De senaste OpenAI SDK-modellerna och funktionerna med den fullständiga OpenAI API-ytan. Direktmodeller från Foundry är tillgängliga genom Chat Completions API (inte Responses). | https://<resource-name>.openai.azure.com/openai/v1 |
| SDK:er för Foundry Tools | Fördefinierade lösningar (vision, tal, innehållssäkerhet med mera). | Verktygsspecifika slutpunkter (varierar beroende på tjänst). |
| Agent Framework | Orkestrering med flera agenter i kod. Molnoberoende | Använder projektslutpunkten via Foundry SDK. |
Välj ditt SDK:
- Använda Foundry SDK när du skapar appar med agenter, utvärderingar eller Foundry-specifika funktioner
- Använd OpenAI SDK när maximal OpenAI-kompatibilitet krävs, eller använda Foundry-direktmodeller via chattens slutföranden
- Använd Foundry Tools SDK:er när du arbetar med specifika AI-tjänster (vision, tal, språk osv.)
- Använda Agent Framework när du skapar system med flera agenter i kod (lokal orkestrering)
Anmärkning
Resurstyper: En Foundry-resurs innehåller alla slutpunkter som tidigare angavs. En Azure OpenAI-resurs tillhandahåller endast /openai/v1 slutpunkten.
Autentisering: Exempel här använder Microsoft Entra-ID (DefaultAzureCredential). API-nycklar fungerar på /openai/v1. Skicka nyckeln som api_key i stället för en tokenprovider.
Förutsättningar
-
Ett Azure-konto med en aktiv prenumeration. Om du inte har ett skapar du ett kostnadsfritt Azure-konto, som innehåller en kostnadsfri utvärderingsprenumeration.
Ha någon av följande Azure RBAC-roller för att skapa och hantera Foundry-resurser:
- Azure AI-användare (minst privilegierad roll för utveckling)
- Azure AI Project Manager (för att hantera Foundry-projekt)
- Deltagare eller ägare (för behörigheter på prenumerationsnivå)
Mer information om varje rolls behörigheter finns i Rollbaserad åtkomstkontroll för Microsoft Foundry.
Installera nödvändiga språkkörningar, globala verktyg och VS Code-tillägg enligt beskrivningen i Förbereda utvecklingsmiljön.
Viktigt!
Kontrollera att utvecklingsmiljön är klar innan du börjar.
Den här artikeln fokuserar på scenariospecifika steg som SDK-installation , autentisering och körning av exempelkod.
Verifiera förutsättningar
Bekräfta innan du fortsätter:
- [ ] Azure-prenumerationen är aktiv:
az account show - [ ] Du har den RBAC-roll som krävs: Kontrollera Azure-portalen → Foundry-resursen → Åtkomstkontroll (IAM)
- [ ] Språkkörning installerad:
- Python:
python --version(≥3.8) - Node.js:
node --version(≥18) - .NET:
dotnet --version(≥6.0) - Java:
java --version(≥11)
- Python:
Foundry SDK
Foundry SDK ansluter till en enda projektslutpunkt som ger åtkomst till de mest populära Foundry-funktionerna:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Anmärkning
Om din organisation använder en anpassad underdomän ersätter du <resource-name> med <your-custom-subdomain> i slutpunkts-URL:en.
Den här metoden förenklar programkonfigurationen. I stället för att hantera flera slutpunkter konfigurerar du en.
Installera SDK:n
Anmärkning
SDK-versioner: SDK:n för förhandsversionen av 2.x riktar sig mot den nya Foundry-portalen och API:et. 1.x GA SDK riktar sig till Foundry Classic. Kontrollera att exemplen som du följer matchar det installerade paketet.
| SDK-version | Portalversion | Tillstånd | Python-paket |
|---|---|---|---|
| 2.x (förhandsversion) | Foundry (ny) | Preview | azure-ai-projects>=2.0.0b1 --pre |
| 1.x (GA) | Foundry Klassisk | Stabil | azure-ai-projects==1.0.0 |
Azure AI Projects-klientbiblioteket för Python är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör dessa kommandon för att installera förhandsversionspaketen för Foundry-projekt.
pip install --pre azure-ai-projects
pip install azure-identity openai
| SDK-version | Portalversion | Tillstånd | Java-paket |
|---|---|---|---|
| 1.0.0-beta.3 1.0.0-beta.1 |
Foundry (ny) | Preview | azure-ai-projectsazure-ai-agents |
| SDK-version | Portalversion | Tillstånd | JavaScript-paket |
|---|---|---|---|
| 2.0.0-beta.4 (förhandsversion) | Foundry (ny) | Preview | @azure/ai-projects 'prerelease' |
| 1.0.1 | Foundry Klassisk | Stabil | @azure/ai-projects |
| SDK-version | Portalversion | Tillstånd | .NET-paket |
|---|---|---|---|
| 1.2.0-beta.5 (förhandsversion) | Foundry (ny) | Preview | Azure.AI.ProjectsAzure.AI.Projects.Openai |
| 1.x (GA) | Foundry Klassisk | Stabil | Azure.AI.Projects |
Azure AI Projects-klientbiblioteket för Java (förhandsversion) är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Viktigt!
Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
Lägg till dessa paket i installationen för Foundry-projekt.
package com.azure.ai.agents;
import com.azure.core.util.Configuration;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.models.responses.Response;
import com.openai.models.responses.ResponseCreateParams;
Azure AI Projects-klientbiblioteket för JavaScript är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör det här kommandot för att installera JavaScript-förhandsversionspaketen för Foundry-projekt.
npm install @azure/ai-projects@beta @azure/identity dotenv
Azure AI Projects-klientbiblioteket för .NET är ett enhetligt bibliotek som gör att du kan använda flera klientbibliotek tillsammans genom att ansluta till en enda projektslutpunkt.
Kör det här kommandot för att lägga till Paketet Azure.AI.Projects i ditt .NET-projekt.
dotnet add package Azure.AI.Projects --prerelease
dotnet add package Azure.AI.Projects.OpenAI --prerelease
dotnet add package Azure.Identity
Användning av Foundry SDK
SDK:n exponerar två klienttyper eftersom Foundry och OpenAI har olika API-former:
- Projektklient – Använd för Foundry-inbyggda åtgärder där OpenAI inte har någon motsvarighet. Exempel: visa anslutningar, hämta projektegenskaper, aktivera spårning.
-
OpenAI-kompatibel klient – Använd för Foundry-funktioner som bygger på OpenAI-begrepp. Svars-API: et, agenter, utvärderingar och finjustering använder alla mönster för begäran/svar i OpenAI-stil. Den här klienten ger dig också åtkomst till Foundry-direktmodeller (icke-Azure-OpenAI modeller som finns i Foundry). Projektslutpunkten hanterar den här trafiken på
/openaivägen.
De flesta appar använder båda klienterna. Använd projektklienten för konfiguration och använd sedan Den OpenAI-kompatibla klienten för att köra agenter, utvärderingar och anropa modeller (inklusive Foundry-direktmodeller).
Skapa en projektklient:
from azure.identity import DefaultAzureCredential
from azure.ai.projects import AIProjectClient
project_client = AIProjectClient(
endpoint="https://<resource-name>.services.ai.azure.com/api/projects/<project-name>",
credential=DefaultAzureCredential())
Skapa en OpenAI-kompatibel klient från projektet:
with project_client.get_openai_client() as openai_client:
response = openai_client.responses.create(
model="gpt-5.2",
input="What is the size of France in square miles?",
)
print(f"Response output: {response.output_text}")
Förväntade utdata:
Response output: France has an area of approximately 213,011 square miles (551,695 square kilometers).
Skapa en projektklient:
import com.azure.ai.projects.ProjectsClient;
import com.azure.ai.projects.ProjectsClientBuilder;
import com.azure.identity.DefaultAzureCredentialBuilder;
String endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
ProjectsClient projectClient = new ProjectsClientBuilder()
.credential(new DefaultAzureCredentialBuilder().build())
.endpoint(endpoint)
.buildClient();
```**Create and use an OpenAI-compatible client from your project:**
```java
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Skapa en projektklient:
import { DefaultAzureCredential } from "@azure/identity";
import { AIProjectClient } from "@azure/ai-projects";
import "dotenv/config";
const projectEndpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deploymentName = "gpt-5.2";
const project = new AIProjectClient(projectEndpoint, new DefaultAzureCredential());
Skapa en OpenAI-kompatibel klient från projektet:
const openAIClient = await project.getOpenAIClient();
const response = await openAIClient.responses.create({
model: deploymentName,
input: "What is the size of France in square miles?",
});
console.log(`Response output: ${response.output_text}`);
Skapa en projektklient:
using Azure.AI.Projects.OpenAI;
using Azure.Identity;
using OpenAI.Responses;
string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new(
endpoint: new Uri(endpoint),
tokenProvider: new DefaultAzureCredential());
Skapa en OpenAI-kompatibel klient från projektet:
#pragma warning disable OPENAI001
OpenAIResponseClient responseClient = projectClient.OpenAI.GetProjectResponsesClientForModel("gpt-5.2");
OpenAIResponse response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());
#pragma warning restore OPENAI001
Vad du kan göra med Foundry SDK
- Access Foundry-modeller, inklusive Azure OpenAI
- Använd Foundry-Agenttjänsten
- Köra molnutvärderingar
- Aktivera appspårning
- Finjustera en modell
- Hämta slutpunkter och nycklar för Foundry Tools, lokal orkestrering med mera
Felsökning
Autentiseringsfel
Om du ser DefaultAzureCredential failed to retrieve a token:
Kontrollera att Azure CLI är autentiserat:
az account show az login # if not logged inKontrollera RBAC-rolltilldelning:
- Bekräfta att du har minst Azure AI-användarrollen i Foundry-projektet
- Se Tilldela Azure-roller
För hanterad identitet i produktion:
- Kontrollera att den hanterade identiteten har tilldelats rätt roll
- Se Konfigurera hanterade identiteter
Fel vid slutpunktskonfiguration
Om du ser Connection refused eller 404 Not Found:
- Kontrollera att resurs- och projektnamnen matchar din faktiska distribution
-
Kontrollera formatet för slutpunkts-URL: Bör vara
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
För anpassade underdomäner: Ersätt
<resource-name>med din anpassade underdomän
SDK-versionskonflikter
Om kodexempel misslyckas med AttributeError eller ModuleNotFoundError:
-
Kontrollera SDK-versionen:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NET - Verifiera monikerjustering: 2.x SDK kräver Foundry-portalen, 1.x SDK kräver foundry classic
- Installera om med rätt versionsflaggor: Se installationskommandon i varje språkavsnitt ovan
OpenAI SDK
Använd OpenAI SDK när du vill ha den fullständiga OpenAI API-ytan och maximal klientkompatibilitet. Den här slutpunkten ger åtkomst till Azure OpenAI-modeller och Foundry-direktmodeller (via Svars-API). Den ger inte åtkomst till Foundry-specifika funktioner som agenter och utvärderingar.
Följande kodfragment visar hur du använder Azure OpenAI-slutpunkten /openai/v1 direkt.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
client = OpenAI(
base_url = "https://<resource-name>.openai.azure.com/openai/v1/",
api_key=token_provider,
)
response = client.responses.create(
model="model_deployment_name",
input= "What is the size of France in square miles?"
)
print(response.model_dump_json(indent=2))
Förväntade utdata:
{
"id": "resp_abc123",
"object": "response",
"created": 1234567890,
"model": "gpt-5.2",
"output_text": "France has an area of approximately 213,011 square miles (551,695 square kilometers)."
}
Mer information finns i Programmeringsspråk som stöds av Azure OpenAI
Viktigt!
Objekt markerade (förhandsversion) i den här artikeln är för närvarande i offentlig förhandsversion. Den här förhandsversionen tillhandahålls utan ett serviceavtal och vi rekommenderar det inte för produktionsarbetsbelastningar. Vissa funktioner kanske inte stöds eller kan vara begränsade. Mer information finns i Kompletterande villkor för användning av Microsoft Azure-förhandsversioner.
Följande kodfragment visar hur du använder Azure OpenAI-slutpunkten /openai/v1 direkt.
import com.azure.identity.AuthenticationUtil;
import com.azure.identity.DefaultAzureCredential;
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.credential.BearerTokenCredential;
import java.util.function.Supplier;
DefaultAzureCredential tokenCredential = new DefaultAzureCredentialBuilder().build();
String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
Supplier<String> bearerTokenSupplier = AuthenticationUtil.getBearerTokenSupplier(
tokenCredential, "https://cognitiveservices.azure.com/.default");
OpenAIClient openAIClient = OpenAIOkHttpClient.builder()
.baseUrl(endpoint)
.credential(BearerTokenCredential.create(bearerTokenSupplier))
.build();
ResponseCreateParams responseCreateParams = ResponseCreateParams.builder()
.input("What is the speed of light?")
.model(deploymentName)
.build();
Response response = openAIClient.responses().create(responseCreateParams);
System.out.println("Response output: " + response.getOutputText());
Mer information om hur du använder OpenAI SDK finns i Programmeringsspråk som stöds av Azure OpenAI
const endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
const scope = "https://cognitiveservices.azure.com/.default";
const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);
const client = new OpenAI({ baseURL: endpoint, apiKey: azureADTokenProvider });
const response = await client.responses.create({
model: deploymentName,
input: "What is the size of France in square miles?",
});
console.log(`Response output: ${response.output_text}`);
Mer information om hur du använder OpenAI SDK finns i Programmeringsspråk som stöds av Azure OpenAI
- Installera OpenAI-paketet: Kör det här kommandot för att lägga till OpenAI-klientbiblioteket i .NET-projektet.
dotnet add package OpenAI ```When it succeeds, the .NET CLI confirms that it installed the `OpenAI` package. This snippet configures `DefaultAzureCredential`, builds `OpenAIClientOptions`, and creates a `ResponseClient` for the Azure OpenAI v1 endpoint. ```csharp using Azure.Identity; using Azure.Core; using OpenAI; using System; using System.ClientModel.Primitives; #pragma warning disable OPENAI001 const string directModelEndpoint = "https://<resource-name>.openai.azure.com/openai/v1/"; const string deploymentName = "gpt-5.2"; BearerTokenPolicy tokenPolicy = new( new DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"); OpenAIResponseClient client = new( model: deploymentName, authenticationPolicy: tokenPolicy, // To use Entra // credential: new ApiKeyCredential("<YOUR-AZURE-OPENAI-API-KEY>") // To use APIKEY options: new OpenAIClientOptions() { Endpoint = new($"{directModelEndpoint}"), }); ResponseCreationOptions options = new ResponseCreationOptions { Temperature = (float)0.7, }; OpenAIResponse modelDirectResponse = client.CreateResponse( [ ResponseItem.CreateUserMessageItem("What is the size of France in square miles?"), ], options); Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.GetOutputText()}"); #pragma warning restore OPENAI001 // The ResponseClient lets you interact with models and services in your project.
Mer information om hur du använder OpenAI SDK finns i Programmeringsspråk som stöds av Azure OpenAI
Använda Agent Framework för lokal orkestrering
Microsoft Agent Framework är en SDK med öppen källkod för att skapa system med flera agenter i kod (till exempel .NET och Python) med ett molnleverantörsagnostiskt gränssnitt.
Använd Agent Framework när du vill definiera och samordna agenter lokalt. Koppla den till Foundry SDK när du vill att dessa agenter ska köras mot Foundry-modeller eller när du vill att Agent Framework ska orkestrera agenter som finns i Foundry.
Mer information finns i Översikt över Microsoft Agent Framework.
SDK:er för Foundry Tools
Foundry Tools (tidigare Azure AI Services) är fördefinierade punktlösningar med dedikerade SDK:er. Använd följande slutpunkter för att arbeta med Foundry Tools.
Vilken slutpunkt ska du använda?
Välj en slutpunkt baserat på dina behov:
Använd Azure AI Services-slutpunkten för att komma åt verktygen Visuellt innehåll, Innehållssäkerhet, Dokumentinformation, Språk, Översättning och Token Foundry.
Slutpunkt för Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Anmärkning
Slutpunkter använder antingen ditt resursnamn eller en anpassad underdomän. Om din organisation har konfigurerat en anpassad underdomän ersätter du your-resource-name med your-custom-subdomain i alla slutpunktsexempel.
För verktyg för tal- och översättningsprogram använder du slutpunkterna i följande tabeller. Ersätt platshållarna med din resursinformation.
Talgränssnitt
| Gjutningsverktyg | Endpoint |
|---|---|
| Tal till text (standard) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Text till tal (neuralt) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Custom Voice | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Översättningsslutpunkter
| Gjutningsverktyg | Endpoint |
|---|---|
| Textöversättning | https://api.cognitive.microsofttranslator.com/ |
| Dokumentöversättning | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Följande avsnitt innehåller snabbstartslänkar för Foundry Tools SDK:er och referensinformation.
