Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Een Foundry-resource biedt geïntegreerde toegang tot modellen, agents en hulpprogramma's. In dit artikel wordt uitgelegd welke SDK en welk eindpunt voor uw scenario moeten worden gebruikt.
| SDK | Waar is het voor? | Eindpunt |
|---|---|---|
| Foundry SDK | Foundry-specifieke mogelijkheden met openAI-compatibele interfaces. Bevat toegang tot Foundry directe modellen via de Responses API (niet Chat Completion). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| OpenAI SDK | Nieuwste OpenAI SDK-modellen en -functies met het volledige OpenAI API-oppervlak. Foundry directe modellen beschikbaar via de API voor chatvoltooiingen (niet Antwoorden). | https://<resource-name>.openai.azure.com/openai/v1 |
| Foundry Tools SDK's | Vooraf gemaakte oplossingen (Vision, Speech, Content Safety en meer). | Tool-specifieke eindpunten (verschilt per dienst). |
| Agent Framework | Orkestratie van meerdere agents in code. Cloudagnostisch. | Maakt gebruik van het projecteindpunt via de Foundry SDK. |
Kies uw SDK:
- Foundry SDK gebruiken bij het bouwen van apps met agents, evaluaties of Foundry-specifieke functies
- OpenAI SDK gebruiken wanneer maximale OpenAI-compatibiliteit is vereist, of directe Foundry-modellen gebruiken via chatvoltooiingen
- Gebruik Foundry Tools SDK's bij het werken met specifieke AI-services (Vision, Speech, Language, enzovoort)
- Agent Framework gebruiken bij het bouwen van systemen met meerdere agents in code (lokale indeling)
Opmerking
Resourcetypen: Een Foundry-resource biedt alle eerder vermelde eindpunten. Een Azure OpenAI-resource biedt alleen het /openai/v1-eindpunt.
Authentication: Voorbeelden gebruiken hier Microsoft Entra ID (DefaultAzureCredential). API-sleutels werken op /openai/v1. Geef de sleutel door als api_key in plaats van een tokenprovider.
Voorwaarden
-
Een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u een vrij Azure-account, inclusief een gratis proefabonnement.
Zorg voor een van de volgende Azure RBAC-rollen voor het maken en beheren van Foundry-resources:
- Azure AI-gebruiker (rol met minimale bevoegdheden voor ontwikkeling)
- Azure AI Project Manager (voor het beheren van Foundry-projecten)
- Inzender of eigenaar (voor machtigingen op abonnementsniveau)
Zie Toegangsbeheer op basis van rollen voor Microsoft Foundry voor meer informatie over de machtigingen van elke rol.
Installeer de vereiste taalruntimes, globale hulpprogramma's en VS Code-extensies, zoals beschreven in Uw ontwikkelomgeving voorbereiden.
Belangrijk
Voordat u begint, moet u ervoor zorgen dat uw ontwikkelomgeving gereed is.
Dit artikel is gericht op scenariospecifieke stappen, zoals SDK-installatie , verificatie en het uitvoeren van voorbeeldcode.
Vereisten controleren
Voordat u doorgaat, bevestigt u:
- Azure-abonnement is actief:
az account show - U hebt de vereiste RBAC-rol: controleer Azure portal → Foundry-resource → Toegangsbeheer (IAM)
- Taalruntime geïnstalleerd:
- Python:
python --version(≥3.8)
- Python:
- Taalruntime geïnstalleerd:
- Node.js:
node --version(≥18)
- Node.js:
- Taalruntime geïnstalleerd:
- .NET:
dotnet --version(≥6.0)
- .NET:
- Taalruntime geïnstalleerd:
- Java:
java --version(≥11)
- Java:
Foundry SDK
De Foundry SDK maakt verbinding met één projecteindpunt dat toegang biedt tot de populairste Foundry-mogelijkheden:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Opmerking
Als uw organisatie gebruikmaakt van een aangepast subdomein, vervangt u deze door <resource-name><your-custom-subdomain> in de eindpunt-URL.
Deze aanpak vereenvoudigt de configuratie van toepassingen. In plaats van meerdere eindpunten te beheren, configureert u er een.
De SDK installeren
| SDK-versie | Portalversie | Status | Python-pakket |
|---|---|---|---|
| 2.x | Foundry (nieuw) | Stabiel | azure-ai-projects>=2.0.0 |
| 1.x | Foundry (klassiek) | Stabiel | azure-ai-projects==1.0.0 |
De Azure AI Projects-clientbibliotheek voor Python is een geïntegreerde bibliotheek waarmee u meerdere clientbibliotheken tegelijk kunt gebruiken door verbinding te maken met één projecteindpunt.
Voer deze opdracht uit om de pakketten voor Foundry-projecten te installeren.
pip install "azure-ai-projects>=2.0.0"
| SDK-versie | Portalversie | Status | Java-pakket |
|---|---|---|---|
| 2.0.0 | Foundry (nieuw) | Stabiel | azure-ai-projectsazure-ai-agents |
| SDK-versie | Portalversie | Status | JavaScript-pakket |
|---|---|---|---|
| 2.0.1 | Foundry (nieuw) | Stabiel | @azure/ai-projects |
| 1.0.1 | Foundry Classic | Stabiel | @azure/ai-projects |
| SDK-versie | Portalversie | Status | .NET-pakket |
|---|---|---|---|
| 2.0.0 (GA) | Foundry (nieuw) | Stabiel | Azure.AI.ProjectsAzure.AI.Projects.AgentsAzure.AI.Extensions.OpenAI |
| 1.1.0 (GA) | Foundry Classic | Stabiel | Azure.AI.Projects |
Belangrijk
Installeer Azure.AI.Projects.OpenAI (preview) niet naast Azure.AI.Extensions.OpenAI (GA). Beide pakketten definiëren dezelfde typen in verschillende naamruimten, waardoor dubbelzinnige verwijzingsfouten optreden. Gebruik alleen Azure.AI.Extensions.OpenAI voor agentscenario's.
De Azure AI Projects-clientbibliotheek voor Java is een geïntegreerde bibliotheek waarmee u meerdere clientbibliotheken tegelijk kunt gebruiken door verbinding te maken met één projecteindpunt.
Voeg deze pakketten toe aan uw installatie voor Foundry-projecten.
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;
De Azure AI Projects-clientbibliotheek voor JavaScript is een geïntegreerde bibliotheek waarmee u meerdere clientbibliotheken tegelijk kunt gebruiken door verbinding te maken met één projecteindpunt.
Voer deze opdracht uit om de JavaScript-pakketten voor Foundry-projecten te installeren.
npm install @azure/ai-projects @azure/identity dotenv
De Azure AI Projects-clientbibliotheek voor .NET is een geïntegreerde bibliotheek waarmee u meerdere clientbibliotheken tegelijk kunt gebruiken door verbinding te maken met één projecteindpunt.
Voer deze opdrachten uit om de vereiste pakketten toe te voegen aan uw .NET project.
dotnet add package Azure.AI.Projects
dotnet add package Azure.AI.Projects.Agents
dotnet add package Azure.AI.Extensions.OpenAI
dotnet add package Azure.Identity
De Foundry SDK gebruiken
De SDK biedt twee clienttypen omdat Foundry en OpenAI verschillende API-shapes hebben:
- Project client : gebruiken voor foundry-native bewerkingen waarbij OpenAI geen equivalent heeft. Voorbeelden: verbindingen weergeven, projecteigenschappen ophalen, tracering inschakelen.
-
OpenAI-compatibele client : gebruik voor Foundry-functionaliteit die voortbouwt op OpenAI-concepten. De Antwoorden-API, agents, evaluaties en het afstemmen maken allemaal gebruik van OpenAI-achtige aanvraag-/antwoordpatronen. Deze client biedt u ook toegang tot Foundry directe modellen (niet-Azure-OpenAI modellen die worden gehost in Foundry). Het projecteinde behandelt dit verkeer op de route
/openai.
De meeste apps gebruiken beide clients. Gebruik de projectclient voor installatie en configuratie en gebruik vervolgens de openAI-compatibele client voor het uitvoeren van agents, evaluaties en aanroepende modellen (inclusief Directe Foundry-modellen).
Een projectclient maken:
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())
Maak een openAI-compatibele client op basis van uw project:
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}")
Verwachte uitvoer:
Response output: France has an area of approximately 213,011 square miles (551,695 square kilometers).
Een projectclient maken:
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();
Een projectclient maken:
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());
Maak een openAI-compatibele client op basis van uw project:
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}`);
Een projectclient maken:
using Azure.AI.Projects;
using Azure.AI.Extensions.OpenAI;
using Azure.Identity;
string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new(
endpoint: new Uri(endpoint),
tokenProvider: new DefaultAzureCredential());
Maak een openAI-compatibele client op basis van uw project:
var responseClient = projectClient.ProjectOpenAIClient.GetProjectResponsesClientForModel("gpt-5.2");
var response = responseClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.GetOutputText());
Wat u kunt doen met de Foundry SDK
- Access Foundry Models, waaronder Azure OpenAI
- De Foundry Agent-service gebruiken
- Batch-evaluaties uitvoeren
- App-tracering inschakelen
- Een model verfijnen
- Eindpunten en sleutels ophalen voor Foundry Tools, lokale orkestratie en meer
Probleemoplossing
Authenticatiefouten
Als u het volgende ziet DefaultAzureCredential failed to retrieve a token:
Verify Azure CLI is geverifieerd:
az account show az login # if not logged inControleer de RBAC-roltoewijzing:
- Bevestig dat u ten minste de Azure AI-gebruikersrol in het Foundry-project hebt
- Zie Assign Azure roles
Voor beheerde identiteit in productie:
- Zorg ervoor dat aan de beheerde identiteit de juiste rol is toegewezen
- Zie Beheerde identiteiten configureren
Configuratiefouten voor eindpunten
Als u het volgende ziet Connection refused of 404 Not Found:
- Controleer of resource- en projectnaam overeenkomen met uw werkelijke implementatie
-
Indeling van eindpunt-URL controleren: moet zijn
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
Voor aangepaste subdomeinen: Vervangen
<resource-name>door uw aangepaste subdomein
SDK-versies komen niet overeen
Als codevoorbeelden mislukken met AttributeError of ModuleNotFoundError:
Sdk-versie controleren:
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NETOpnieuw installeren met de juiste versievlagmen: zie installatieopdrachten in elke sectie hierboven
OpenAI SDK
Gebruik de OpenAI SDK wanneer u het volledige OpenAI API-oppervlak en de maximale clientcompatibiliteit wilt. Dit eindpunt biedt toegang tot Azure OpenAI-modellen en Foundry directe modellen (via response-API). Het biedt geen toegang tot Foundry-specifieke functies, zoals agents en evaluaties.
In het volgende codefragment ziet u hoe u het Azure OpenAI-/openai/v1-eindpunt rechtstreeks gebruikt.
from openai import OpenAI
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.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))
Verwachte uitvoer:
{
"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)."
}
Zie Azure Ondersteunde programmeertalen van OpenAI voor meer informatie
In het volgende codefragment ziet u hoe u het Azure OpenAI-/openai/v1-eindpunt rechtstreeks gebruikt.
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://ai.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());
Zie voor meer informatie over het gebruik van de OpenAI SDK Azure ondersteunde programmeertalen van OpenAI
const endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
const scope = "https://ai.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}`);
Zie voor meer informatie over het gebruik van de OpenAI SDK Azure ondersteunde programmeertalen van OpenAI
- Installeer het OpenAI-pakket: voer deze opdracht uit om de OpenAI-clientbibliotheek toe te voegen aan uw .NET project.
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 `ResponsesClient` for the Azure OpenAI v1 endpoint. ```csharp using Azure.Identity; using OpenAI; using OpenAI.Responses; 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://ai.azure.com/.default"); OpenAIClient openAIClient = new( authenticationPolicy: tokenPolicy, options: new OpenAIClientOptions() { Endpoint = new($"{directModelEndpoint}"), }); ResponsesClient client = openAIClient.GetResponsesClient(); CreateResponseOptions options = new() { Model = deploymentName, InputItems = { ResponseItem.CreateUserMessageItem("What is the size of France in square miles?") }, Temperature = (float)0.7, }; var modelDirectResponse = client.CreateResponse(options); Console.WriteLine($"[ASSISTANT]: {modelDirectResponse.Value.GetOutputText()}"); #pragma warning restore OPENAI001
Zie voor meer informatie over het gebruik van de OpenAI SDK Azure ondersteunde programmeertalen van OpenAI
Agent Framework gebruiken voor lokale orkestratie
Microsoft Agent Framework is een opensource-SDK voor het bouwen van systemen met meerdere agents in code (bijvoorbeeld .NET en Python) met een cloudprovideragnostische interface.
Gebruik Agent Framework als u agents lokaal wilt definiëren en organiseren. Koppel deze aan de Foundry-SDK wanneer u wilt dat deze agents worden uitgevoerd op Foundry-modellen of wanneer u wilt dat Agent Framework agents in Foundry organiseert die worden gehost in Foundry.
Zie het overzicht van Microsoft Agent Framework voor meer informatie.
Foundry Tools SDKs
Foundry Tools (voorheen Azure AI Services) zijn vooraf samengestelde puntoplossingen met toegewezen SDK's. Gebruik de volgende eindpunten om te werken met Foundry Tools.
Welk eindpunt moet u gebruiken?
Kies een eindpunt op basis van uw behoeften:
Gebruik het Azure AI Services-eindpunt voor toegang tot Computer Vision, Content Safety, Document Intelligence, Language, Translation en Token Foundry Tools.
Eindpunt van Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Opmerking
Eindpunten gebruiken uw resourcenaam of een aangepast subdomein. Als uw organisatie een aangepast subdomein instelt, vervang your-resource-name door your-custom-subdomain in alle eindpuntvoorbeelden.
Indien uw workloads gebruikmaken van uitgefaseerde Azure AI Taal-functies, zoals sentimentanalyse, sleuteltermextractie, samenvatting, entiteitskoppeling, CLU of CQA, moet u plannen om te migreren naar alternatieven van Microsoft Foundry. Voor nieuwe ontwikkeling kunt u overwegen om de Foundry SDK of het openAI-compatibele eindpunt te gebruiken, zoals eerder in dit artikel is beschreven. Zie Migrate from Language Studio to Microsoft Foundry.
Gebruik de eindpunten in de volgende tabellen voor Spraak- en Vertaal Foundry Tools. Vervang tijdelijke aanduidingen door uw resourcegegevens.
Spraakeindpunten
| Gereedschap voor Gieterij | Eindpunt |
|---|---|
| Spraak-naar-tekst (standaard) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Tekst-naar-spraak (Neuraal) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Custom Voice | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
VertaalEindpunten
| Gereedschap voor Gieterij | Eindpunt |
|---|---|
| Vertalen van tekst | https://api.cognitive.microsofttranslator.com/ |
| Documentomzetting | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Taaleindpunten
| Gereedschap voor Gieterij | Eindpunt |
|---|---|
| Tekstanalyse | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com |
Belangrijk
Op 20 maart 2027 wordt Azure Language Studio buiten gebruik gesteld en gemigreerd naar Microsoft Foundry. Alle mogelijkheden en toekomstige verbeteringen zijn beschikbaar in Microsoft Foundry.
Op 31 maart 2029 worden de volgende Azure taalmogelijkheden buiten gebruik gesteld (einde van de ondersteuning). Vóór die datum moeten gebruikers bestaande workloads migreren en nieuwe projecten onboarden naar Microsoft Foundry-modellen voor verbeterde integratie van natuurlijke taal en vereenvoudigde toepassingsintegratie:
- Extractie van sleutelzinnen
- Sentimentanalyse en opinieanalyse
- Aangepaste tekstclassificatie
- Gespreksbegrip (CLU)
- Aangepaste Vragen Beantwoorden (CQA)
- Indelingswerkstroom
- Samenvatting (extractief en abstractief, voor documenten en gesprekken)
- Entiteit Koppelen
Belangrijkste functies met continue ondersteuning: Taaldetectie, PII-detectie, Text Analytics voor status, vooraf gedefinieerde NER en aangepaste NER.
Zie Migrate from Language Studio to Microsoft Foundry voor migratieopties.
