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.
Note
Dit document verwijst naar de Microsoft Foundry-portal (klassiek).
🔄 Schakel over naar de documentatie van Microsoft Foundry (nieuw) als u de nieuwe portal gebruikt.
Note
Dit document verwijst naar de Microsoft Foundry-portal (nieuw).
Het maken van een Foundry-resource ontgrendelt de toegang tot modellen, agents en hulpprogramma's via een uniforme set SDK's en eindpunten. In dit artikel wordt beschreven waar elke SDK voor is en voor welk eindpunt moet worden gebruikt.
| SDK | Waar het voor is | Eindpunt |
|---|---|---|
| Foundry SDK | Foundry-specifieke mogelijkheden met openAI-compatibele interfaces. Bevat toegang tot Foundry directe modellen via de antwoorden-API (niet chatvoltooiingen). | 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 die beschikbaar zijn via de API voor chatvoltooiing (niet antwoorden). | https://<resource-name>.openai.azure.com/openai/v1 |
| Foundry Tools SDKs | Vooraf gemaakte oplossingen (Vision, Speech, Content Safety en meer). | Hulpprogrammaspecifieke eindpunten (verschilt per service). |
| Agent Framework | Orkestratie van meerdere agenten in code. Cloudagnostisch. | Maakt gebruik van het project-eindpunt via de Foundry SDK. |
Note
Resourcetypen: Een Foundry-resource biedt alle eerder vermelde eindpunten. Een Azure OpenAI-resource biedt alleen het /openai/v1 eindpunt.
Verificatie: Voorbeelden hier gebruiken Microsoft Entra ID (DefaultAzureCredential). API-sleutels werken op /openai/v1. Geef de sleutel door als api_key in plaats van een tokenprovider.
Prerequisites
-
Een Azure-account met een actief abonnement. Als u nog geen azure-account hebt, maakt u een gratis Azure-account, inclusief een gratis proefabonnement.
Een van de volgende Azure RBAC-rollen hebt om Foundry-resources te maken en te beheren:
- Azure AI-gebruiker (rol met minimale bevoegdheden voor ontwikkeling)
- Azure AI-projectmanager (voor het beheren van Foundry-projecten)
- Inzender of eigenaar (voor machtigingen op abonnementsniveau)
Zie rolgebaseerd toegangsbeheer 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.
Important
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.
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>
Note
Als uw organisatie gebruikmaakt van een aangepast subdomein, vervangt u deze door <resource-name><your-custom-subdomain> in de eindpunt-URL.
Dit vereenvoudigt de configuratie van toepassingen. In plaats van meerdere eindpunten te beheren, configureert u er een.
Installeer de SDK
Note
Dit artikel is van toepassing op een Foundry-project. De code die hier wordt weergegeven, werkt niet voor een hubproject. Zie Typen projecten voor meer informatie.
Note
SDK-versies: De 2.x preview-SDK is gericht op de nieuwe Foundry-portal en API. De 1.x GA SDK is gericht op Foundry Classic. Zorg ervoor dat de voorbeelden die u volgt overeenkomen met het geïnstalleerde pakket.
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 stabiele pakketten voor klassieke Foundry-projecten te installeren.
pip install azure-ai-projects azure-identity openai
Voer deze opdrachten uit om de preview-pakketten voor Foundry-projecten te installeren.
pip install --pre azure-ai-projects
pip install azure-identity openai
De Azure AI Projects-clientbibliotheek voor Java (preview) is een geïntegreerde bibliotheek waarmee u meerdere clientbibliotheken tegelijk kunt gebruiken door verbinding te maken met één projecteindpunt.
Important
Items die in dit artikel zijn gemarkeerd (preview) zijn momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.
Voeg deze pakketten toe aan uw installatie:
com.azure.ai.projectscom.azure.core
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 huidige JavaScript-pakketten voor klassieke Foundry-projecten te installeren.
npm install @azure/ai-projects @azure/identity
Voer deze opdracht uit om de Preview JavaScript-pakketten voor Foundry-projecten te installeren.
npm install @azure/ai-projects@beta @azure/identity
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 opdracht uit om het Pakket Azure.AI.Projects toe te voegen aan uw .NET-project.
dotnet add package Azure.AI.Projects --version 1.2
De Foundry SDK gebruiken
De SDK biedt twee clienttypen omdat Foundry en OpenAI verschillende API-shapes hebben:
- Projectclient : gebruik 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 van alle aanvragen/antwoorden gebruiken openAI-aanvraag-/antwoordpatronen. Deze client biedt u ook toegang tot Foundry directe modellen (niet-Azure-OpenAI modellen die worden gehost in Foundry). Het project-eindpunt bedient dit verkeer op de
/openairoute.
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 = 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:
openai_client = project.inference.get_azure_openai_client(api_version="2024-10-21")
response = openai_client.responses.create(
model="gpt-5.2",
input="What is the speed of light?",
)
print(response.output_text)
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();
Maak een openAI-compatibele client op basis van uw project:
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Een projectclient maken:
import { AIProjectClient } from '@azure/ai-projects';
import { DefaultAzureCredential } from '@azure/identity';
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Maak een openAI-compatibele client op basis van uw project:
const openAIClient = await project.getOpenAIClient();
Een projectclient maken:
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());
Maak een openAI-compatibele client op basis van uw project:
#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
Wat u kunt doen met de Foundry SDK
- Access Foundry-modellen, waaronder Azure OpenAI
- De Foundry Agent-service gebruiken
- Cloudevaluaties uitvoeren
- App-tracering inschakelen
- Een model verfijnen
- Verkrijg eindpunten en sleutels voor Foundry Tools, lokale orkestratie en meer
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 de API voor chatvoltooiing). Het biedt geen toegang tot Foundry-specifieke functies, zoals agents en evaluaties.
Een OpenAI-client maken op basis van uw project
Dit codefragment gebruikt de AIProjectClient opdracht om een OpenAI-client aan te vragen die is gericht op uw project.
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_openai_client(api_version="2024-10-21")
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}")
In het volgende codefragment ziet u hoe u het Azure OpenAI-eindpunt /openai/v1 rechtstreeks gebruikt.
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))
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie.
Dit codefragment gebruikt de AIProjectClient opdracht om een OpenAI-client aan te vragen vanuit uw Foundry-project.
# Use the AIProjectClient to create an OpenAI client for your project
openai_client = project.get_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}")
In het volgende codefragment ziet u hoe u het Azure OpenAI-eindpunt /openai/v1 rechtstreeks gebruikt.
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))
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie
Important
Items die in dit artikel zijn gemarkeerd (preview) zijn momenteel beschikbaar als openbare preview. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Bepaalde functies worden mogelijk niet ondersteund of hebben mogelijk beperkte mogelijkheden. Voor meer informatie, zie Aanvullende Gebruiksvoorwaarden voor Microsoft Azure Previews.
Dit fragment haalt een OpenAIClient van de ProjectsClient gegevens op, zodat u OpenAI-aanvragen kunt verzenden via Foundry.
OpenAIClient openAIClient = projectClient.getOpenAIClient();
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK.
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK
Dit codefragment maakt gebruik van de projectclient om een OpenAI-client te maken die u voor alle aanvragen opnieuw kunt gebruiken.
// Use the AIProjectClient to create an OpenAI client for your project
const openAIClient = await project.getOpenAIClient();
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK.
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK
Installeer het OpenAI-pakket:
Voer deze opdracht uit om de OpenAI-clientbibliotheek toe te voegen aan uw .NET-project.
dotnet add package OpenAI
Wanneer dit lukt, bevestigt de .NET CLI dat het OpenAI pakket is geïnstalleerd.
Het volgende codefragment laat zien hoe u de OpenAI-client rechtstreeks maakt met behulp van het Azure OpenAI v1-eindpunt.
Dit codefragment configureert
DefaultAzureCredential, bouwtOpenAIClientOptionsen maakt eenResponseClientvoor het Azure OpenAI v1-eindpunt.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.
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK.
Zie ondersteunde programmeertalen van Azure OpenAI voor meer informatie over het gebruik van de OpenAI SDK
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 cloudprovider-agnostische 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, Inhoudsveiligheid, Document Intelligence, Taal, Vertaling en Hulpprogramma's voor Token Foundry.
Eindpunt van Foundry Tools: https://<your-resource-name>.cognitiveservices.azure.com/
Note
Eindpunten gebruiken uw resourcenaam of een aangepast subdomein. Als uw organisatie een aangepast subdomein heeft ingesteld, vervang your-resource-name door your-custom-subdomain in alle voorbeelden van eindpunten.
Gebruik voor Speech and Translation Foundry Tools de eindpunten in de volgende tabellen. Vervang tijdelijke aanduidingen door uw resourcegegevens.
Spraakeindpunten
| Gietwerktuig | Eindpunt |
|---|---|
| Spraak-naar-tekst (standaard) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Tekst naar spraak (neurale netwerken) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Custom Voice | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Vertaaleindpunten
| Gietwerktuig | Eindpunt |
|---|---|
| Tekstomzetting | https://api.cognitive.microsofttranslator.com/ |
| Documentvertaling | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
De volgende secties bevatten quickstartkoppelingen voor de Foundry Tools SDK's en referentie-informatie.
