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.
De Foundry SDK is een thin-client-SDK die alle Foundry-project-API's beschikbaar maakt via één projecteindpunt. SDK's op een hoger niveau bouwen erop voort, bijvoorbeeld het Agent Framework-pakket foundry is afhankelijk van de Foundry-SDK voor toegang tot Foundry-modellen, hulpprogramma's en projectconfiguratie.
| SDK | Waar is het voor? | Eindpunt |
|---|---|---|
| Foundry SDK | Thin-client SDK voor alle Foundry-project-API's. Toegang tot Foundry Models en platformhulpprogramma's (bestanden zoeken, code-interpreter, webzoekopdrachten, geheugen, SharePoint, WorkIQ, Fabric IQ, MCP). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| Agent Framework | Geïntegreerde indeling van meerdere agents voor gehoste agents en systemen met meerdere agents, beschikbaar in C#/.NET en Python. Het foundry pakket is afhankelijk van de Foundry SDK voor projecttoegang. |
Antwoord-API in het projecteindpunt, via FoundryChatClient. |
| OpenAI SDK | Volledig OpenAI API-oppervlak, inclusief insluitingen. Beste latentie en maximale OpenAI-compatibiliteit. | https://<resource-name>.openai.azure.com/openai/v1 |
| Anthropic SDK | Anthropic Claude-modellen geïmplementeerd in Foundry. | https://<resource-name>.services.ai.azure.com/anthropic |
| Foundry Tools SDKs | Vooraf gemaakte oplossingen (Vision, Speech, Content Safety en meer). | Toolspecifieke eindpunten. |
Kies uw SDK:
- Foundry SDK gebruiken bij het bouwen van apps met agents, evaluaties of Foundry-specifieke functies
- Agent Framework gebruiken voor gehoste agents of systemen met meerdere agents in code met behulp van de Antwoorden-API in C#/.NET of Python
- OpenAI SDK gebruiken wanneer maximale OpenAI-compatibiliteit of laagste latentie is vereist, bij het genereren van insluitingen of bij het gebruik van Foundry directe modellen via Chat-voltooiingen
- Gebruik Anthropic SDK bij het werken met Anthropic Claude modellen die zijn geïmplementeerd in Foundry
- Gebruik Foundry Tools SDK's bij het werken met specifieke AI-services (Vision, Speech, Language, enzovoort)
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 met /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:
Foundry User (rol met minimale rechten voor ontwikkeling)
Belangrijk
De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.
Foundry 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 is een thin-client-SDK waarmee u toegang krijgt tot alle Foundry-project-API's via één projecteindpunt:
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Het is de basis waarop andere Foundry-compatibele SDK's zijn gebouwd. Het Agent Framework-pakket foundry heeft bijvoorbeeld een afhankelijkheid van de Foundry SDK en gebruikt deze voor toegang tot Foundry-functionaliteit. U hoeft het projecteindpunt of de openAI-compatibele client niet zelf te koppelen wanneer u deze gebruikt FoundryChatClient.
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 | Gieterij klassiek | 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) | Gieterij klassiek | 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 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 Responses-API, agenten, evaluaties en fijnstelling maken allemaal gebruik van OpenAI-stijl aanvraag-/antwoordpatronen. Deze client is gericht op de Response-API in uw projecteindpunt, waarmee u toegang hebt tot Foundry-modellen uit de catalogus (inclusief niet-Azure-OpenAI directe modellen) plus platformhulpprogramma's: standaard OpenAI-hulpprogramma's zoals bestandszoekopdrachten, code-interpreter en webzoekopdrachten, naast foundry-exclusieve hulpprogramma's zoals geheugen, SharePoint, WorkIQ, Fabric IQ en MCP-servers. Het projecteindpunt verwerkt 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_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:
using Azure.AI.Extensions.OpenAI;
const string deploymentName = "gpt-5.2";
// Get an OpenAI-compatible client from the project
ProjectResponsesClient responseClient = projectClient.ProjectOpenAIClient.GetProjectResponsesClientForModel(deploymentName);
Response response = responsesClient.CreateResponse("What is the speed of light?");
Console.WriteLine(response.Output[0].Content[0].Text);
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 DefaultAzureCredential failed to retrieve a token ziet:
Verifieer of Azure CLI is aangemeld:
az account show az login # if not logged inControleer de RBAC-roltoewijzing:
Bevestig dat u ten minste de gebruikersrol Foundry in het Foundry-project hebt
Belangrijk
De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.
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 de resource- en projectnamen stroken met uw daadwerkelijke 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-versie komt 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, de beste latentie en maximale compatibiliteit met bestaande OpenAI-clients wilt. Dit eindpunt toont de Antwoorden-API op Azure OpenAI rechtstreeks en biedt toegang tot Azure OpenAI-modellen en Foundry-directe modellen, waaronder insluitingen, voltooiingen van chats en het genereren van afbeeldingen. Het biedt geen toegang tot Foundry-specifieke functies, zoals agents, evaluaties of Foundry-exclusieve platformhulpprogramma's. Gebruik hiervoor de Response-API in uw projecteindpunt via de Foundry SDK.
Tip
Gebruik het OpenAI SDK-eindpunt voor het genereren van insluitingen. Het projecteindpunt dat wordt gebruikt door de Foundry SDK stuurt momenteel geen insluitingsaanvragen.
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
Anthropic SDK
Gebruik de Anthropic SDK om te werken met Anthropic Claude modellen die zijn geïmplementeerd in Foundry. Claude-modellen maken gebruik van een afzonderlijk /anthropic-eindpunt en de Anthropic Messages-API, niet het openAI-compatibele eindpunt.
Het Anthropic-eindpunt voegt /anthropic toe aan uw resource-URL:
https://<resource-name>.services.ai.azure.com/anthropic
De Berichten-API is beschikbaar op:
https://<resource-name>.services.ai.azure.com/anthropic/v1/messages
from anthropic import AnthropicFoundry
from azure.identity import DefaultAzureCredential, get_bearer_token_provider
token_provider = get_bearer_token_provider(
DefaultAzureCredential(), "https://ai.azure.com/.default"
)
client = AnthropicFoundry(
azure_ad_token_provider=token_provider,
base_url="https://<resource-name>.services.ai.azure.com/anthropic",
)
message = client.messages.create(
model="claude-sonnet-4-6", # Replace with your deployment name
messages=[
{"role": "user", "content": "What are 3 things to visit in Seattle?"}
],
max_tokens=1048,
)
print(message.content)
De Anthropic SDK biedt geen systeemeigen C#-client. Gebruik de REST API met HttpClient om Claude-modellen aan te roepen.
using System.Net.Http.Headers;
using System.Text;
using System.Text.Json;
using Azure.Identity;
string endpoint = "https://<resource-name>.services.ai.azure.com/anthropic/v1/messages";
string deploymentName = "claude-sonnet-4-6"; // Replace with your deployment name
var credential = new DefaultAzureCredential();
var token = await credential.GetTokenAsync(
new Azure.Core.TokenRequestContext(["https://ai.azure.com/.default"]));
using var httpClient = new HttpClient();
httpClient.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", token.Token);
httpClient.DefaultRequestHeaders.Add("anthropic-version", "2023-06-01");
var requestBody = new
{
model = deploymentName,
messages = new[] { new { role = "user", content = "What are 3 things to visit in Seattle?" } },
max_tokens = 1048
};
var response = await httpClient.PostAsync(
endpoint,
new StringContent(JsonSerializer.Serialize(requestBody), Encoding.UTF8, "application/json"));
string result = await response.Content.ReadAsStringAsync();
Console.WriteLine(result);
import AnthropicFoundry from '@anthropic-ai/foundry-sdk';
import { getBearerTokenProvider, DefaultAzureCredential } from "@azure/identity";
const tokenProvider = getBearerTokenProvider(
new DefaultAzureCredential(),
'https://ai.azure.com/.default');
const client = new AnthropicFoundry({
azureADTokenProvider: tokenProvider,
baseURL: "https://<resource-name>.services.ai.azure.com/anthropic",
apiVersion: "2023-06-01"
});
const message = await client.messages.create({
model: "claude-sonnet-4-6", // Replace with your deployment name
messages: [{ role: "user", content: "What are 3 things to visit in Seattle?" }],
max_tokens: 1048,
});
console.log(message);
De Anthropic SDK biedt geen systeemeigen Java-client. Gebruik de REST API met HttpClient om Claude-modellen aan te roepen.
import com.azure.identity.DefaultAzureCredentialBuilder;
import com.azure.core.credential.TokenRequestContext;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
String endpoint = "https://<resource-name>.services.ai.azure.com/anthropic/v1/messages";
String deploymentName = "claude-sonnet-4-6"; // Replace with your deployment name
var credential = new DefaultAzureCredentialBuilder().build();
var token = credential.getToken(
new TokenRequestContext().addScopes("https://ai.azure.com/.default")).block();
String requestBody = """
{
"model": "%s",
"messages": [{"role": "user", "content": "What are 3 things to visit in Seattle?"}],
"max_tokens": 1048
}
""".formatted(deploymentName);
HttpClient httpClient = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(endpoint))
.header("Authorization", "Bearer " + token.getToken())
.header("Content-Type", "application/json")
.header("anthropic-version", "2023-06-01")
.POST(HttpRequest.BodyPublishers.ofString(requestBody))
.build();
HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
Zie Gebruik Anthropic Claude modellen in Microsoft Foundry voor meer informatie.
Agentenraamwerk
Microsoft Agent Framework is een opensource-SDK voor C#/.NET en Python die geïntegreerde indeling van meerdere agents en consistente abstracties biedt voor het bouwen van agents en systemen met meerdere agents. Het is de aanbevolen orkestratielaag voor gehoste agents in Foundry.
- Als u AutoGen of Semantic Kernel eerder hebt gebruikt voor indeling met meerdere agents (meerdere agents coördineren om samen te werken aan taken), kunt u Agent Framework beschouwen als de primaire indelingslaag. Het helpt u voorkomen dat u meerdere indelings-SDK's combineert die vergelijkbare coördinatietaken oplossen, waardoor conflicterende abstracties en afhankelijkheden kunnen worden toegevoegd.
- Als u al aanzienlijke bestaande indelingscode hebt, afhankelijk bent van productspecifieke functies of complexe migratievereisten ondervindt, evalueert u deze vereisten voordat u samengaat met Agent Framework.
Uw code uitvoeren als een gehoste agent
Het belangrijkste concept voor codegebaseerde agents in Foundry is Gehoste agents. Schrijf uw agent met Agent Framework, verpak die als een containerimage of een zipbestand van uw broncode en laat Foundry die uitvoeren met een beheerd eindpunt, automatische schaling op geïsoleerde Micro-VM's, een toegewezen Microsoft Entra-agentidentiteit, status op sessieniveau en end-to-end-observability.
Gehoste agents zijn de aanbevolen optie als u een door Foundry beheerd, via het netwerk bereikbaar eindpunt wilt dat door andere apps of agents kan worden aangeroepen. Zie Uw eerste gehoste agent implementeren.
Agents ontwikkelen in code buiten Foundry met de Responses API
Als u uw agent buiten Foundry host, in uw eigen proces of infrastructuur, kunt u ook Agent Framework gebruiken om de Response-API rechtstreeks aan te roepen in uw projecteindpunt . Agent Framework maakt verbinding via de FoundryChatClient provider, die zich richt op:
{project_endpoint}/openai/v1/responses
Door het projecteindpunt te gebruiken — in plaats van via een OpenAI-eindpunt op resourceniveau — krijgt uw agent:
- Foundry-modellen uit de catalogus (Azure OpenAI- en Foundry-directmodellen) via één API.
- Platformhulpprogramma's buiten de OpenAI-hulpprogrammaset, waaronder bestandszoekopdrachten, code-interpreter, geheugen, webzoekopdrachten, MCP-servers, SharePoint, WorkIQ en Fabric IQ.
- Projectgebonden gegevens, On-Behalf-Of (OBO)-toolauthenticatie en de tracering, inhoudsfilters en identiteitsconfiguratie van het project.
Dit patroon is additief voor gehoste agents, geen alternatief. Dezelfde Agent Framework-code kan de Response-API van uw eigen proces vandaag aanroepen en later worden verpakt als een gehoste agent wanneer u een door Foundry beheerd eindpunt wilt. Zie quickstart: Agents bouwen met behulp van de Response-API.
Zie Wat is Microsoft Foundry Agent Service? voor een volledige vergelijking van agenttypen en hostingopties.
Foundry Tools SDK’s
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 om toegang te krijgen tot Computer Vision, Inhoudsbeveiliging, Document Intelligence, Taal, Vertaling 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 eigen subdomein heeft ingesteld, vervang your-resource-name met your-custom-subdomain in alle eindpunt-voorbeelden.
Als uw workloads gebruikmaken van verouderende Azure AI Taal-functies, zoals sentimentanalyse, sleutelzinnenextractie, samenvatting, entiteitskoppeling, CLU of CQA, plan dan om naar alternatieven van Microsoft Foundry te migreren. 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 voor Speech en Translation Foundry Tools de eindpunten in de volgende tabellen. Vervang tijdelijke aanduidingen door uw resourcegegevens.
Spraakeindpunten
| Gereedschap voor Foundry | 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 |
| Aangepaste Stem | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Vertaal-eindpunten
| Gereedschap voor Foundry | Eindpunt |
|---|---|
| Vertalen van tekst | https://api.cognitive.microsofttranslator.com/ |
| Documentomzetting | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Taaleindpunten
| Gereedschap voor Foundry | 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:
- Sleutelzinnenextractie
- Sentimentanalyse en opinieonderzoek
- Aangepaste tekstclassificatie
- Gespreksmatig Taalbegrip (CLU)
- Aangepaste Vraagbeantwoording (CQA)
- Orchestratie werkstroom
- Samenvatting (extractief en abstractief, voor documenten en gesprekken)
- Entiteiten 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.