Microsoft Foundry SDK's en eindpunten

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)
  • Taalruntime geïnstalleerd:
    • Node.js: node --version (≥18)
  • Taalruntime geïnstalleerd:
    • .NET: dotnet --version (≥6.0)
  • Taalruntime geïnstalleerd:
    • Java: java --version (≥11)

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-projects
azure-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.Projects
Azure.AI.Projects.Agents
Azure.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 /openai route.

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

Probleemoplossing

Authenticatiefouten

Als u DefaultAzureCredential failed to retrieve a token ziet:

  1. Verifieer of Azure CLI is aangemeld:

    az account show
    az login  # if not logged in
    
  2. Controleer 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.

    • Zie Assign Azure roles

  3. Voor beheerde identiteit in productie:

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  # .NET
    
  • Opnieuw 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

  1. 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.

Door C# ondersteunde Foundry Tools

Gereedschap voor Foundry Beschrijving Snelstartgidsen en referentiedocumentatie
Spraakpictogram Spraak Voeg spraak-naar-tekst, tekst-naar-spraak, vertaling en sprekeridentificatiemogelijkheden toe aan toepassingen. Snelstart voor spraak-naar-tekst

Snelstart voor tekst-naar-spraak

Snelstartgids voor spraakomzetting

Speech SDK voor .NET

Speech NuGet-pakket (Speech CLI)
Taalpictogram Taal Toepassingen bouwen met mogelijkheden voor natuurlijke taalkennis. Ondersteunde functies: Taaldetectie, PII-detectie, Text Analytics voor Gezondheid, Voorgebouwde NER en Aangepaste NER. Buiten gebruik gesteld op 31 maart 2029: Sentimentanalyse en Meninganalyse, Sleuteltermextractie, Samenvatting, Entity Linking, CQA en CLU. Quickstart voor het beantwoorden van aangepaste vragen (CQA)(buiten gebruik stellen 31 maart 2029)

Quickstart voor entiteitskoppeling(wordt buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor taaldetectie

Quickstart voor sleuteltermextractie(uitgefaseerd op 31 maart 2029)

Snelstart voor het herkennen van benoemde entiteiten (NER)

Quickstart voor het detecteren van persoonlijk identificeerbare informatie (PII)

Quickstart voor sentimentanalyse en opinieanalyse(buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor tekst-, document- en gespreksamenvattinggebruik (niet meer beschikbaar vanaf 31 maart 2029)

Een snelstartgids voor het gebruik van Tekstanalyse voor gezondheid

Language SDK voor .NET (tekstanalyse)

Language NuGet-pakket (tekstanalyse)

Language SDK voor .NET (vragen beantwoorden)

Language NuGet-pakket (vraag beantwoorden)

Migrate from Language Studio to Microsoft Foundry voor hulp bij het migreren van workloads met buiten gebruik stellen van functies
Translator-pictogram Translator Gebruik door AI gemaakte vertaaltechnologie om meer dan 100 in gebruik zijnde, risicovolle en bedreigde talen en dialecten te vertalen. Translator SDK voor .NET (tekst)

Translator NuGet-pakket (tekst)

Translator SDK voor .NET (batch)

Translator NuGet-pakket (batch)
Azure AI Zoeken pictogram Azure AI Zoeken Breng met AI gemaakte cloudzoekopdrachten naar uw mobiele en web-apps. Agent-gebaseerde quickstart voor ophalen gebruiken

Snelle start voor vectorzoek

Klassieke generatieve zoekopdracht (RAG) met de quickstart voor basisgegevens

Snelstartgids voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chatten met Azure OpenAI-modellen met behulp van uw eigen gegevens in een snelstartgids

Azure AI Zoeken SDK voor .NET

Azure AI Zoeken NuGet-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelle start voor tekstinhoud analyseren

Een quickstart voor een tekstblocklist gebruiken

Quickstartgids voor het analyseren van afbeeldingsinhoud

Content Safety SDK voor .NET

Content Safety NuGet-pakket
Document intelligence-pictogram Document intelligence Documenten omzetten in intelligente gegevensgestuurde oplossingen. Snelstart voor Document Intelligence

Document Intelligence SDK voor .NET

Document Intelligence NuGet-pakket
Vision-icoon Vision Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De snelstartgids voor de Face-service gebruiken

Vision SDK voor .NET

Vision NuGet-pakket

Java ondersteunde Foundry Tools

Gereedschap voor Foundry Beschrijving Snelstartgidsen en referentiedocumentatie
Spraakpictogram Spraak Voeg spraak-naar-tekst, tekst-naar-spraak, vertaling en sprekeridentificatiemogelijkheden toe aan toepassingen. Snelstart voor spraak-naar-tekst

Snelstart voor tekst-naar-spraak

Snelstartgids voor spraakomzetting

Speech SDK voor Java

Speech Maven-pakket
Taalpictogram Taal Toepassingen bouwen met mogelijkheden voor natuurlijke taalkennis. Ondersteunde functies: Taaldetectie, PII-detectie, Text Analytics voor Gezondheid, Voorgebouwde NER en Aangepaste NER. Buiten gebruik gesteld op 31 maart 2029: Sentimentanalyse en Meninganalyse, Sleuteltermextractie, Samenvatting, Entity Linking, CQA en CLU. Quickstart voor entiteitskoppeling(wordt buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor taaldetectie

Quickstart voor sleuteltermextractie(uitgefaseerd op 31 maart 2029)

Snelstart voor het herkennen van benoemde entiteiten (NER)

Quickstart voor het detecteren van persoonlijk identificeerbare informatie (PII)

Quickstart voor sentimentanalyse en opinieanalyse(buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor tekst-, document- en gespreksamenvattinggebruik (niet meer beschikbaar vanaf 31 maart 2029)

Een snelstartgids voor het gebruik van Tekstanalyse voor gezondheid

Language SDK voor Java (tekstanalyse)

Language Maven-pakket

Migrate from Language Studio to Microsoft Foundry voor hulp bij het migreren van workloads met buiten gebruik stellen van functies
Translator-pictogram Translator Gebruik door AI gemaakte vertaaltechnologie om meer dan 100 in gebruik zijnde, risicovolle en bedreigde talen en dialecten te vertalen. Translator SDK voor Java (tekst)

Translator Maven-pakket (tekst)
Azure AI Zoeken pictogram Azure AI Zoeken Breng met AI gemaakte cloudzoekopdrachten naar uw mobiele en web-apps. Agent-gebaseerde quickstart voor ophalen gebruiken

Snelle start voor vectorzoek

Klassieke generatieve zoekopdracht (RAG) met de quickstart voor basisgegevens

Snelstartgids voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chatten met Azure OpenAI-modellen met behulp van uw eigen gegevens in een snelstartgids

Azure AI Zoeken SDK voor Java

Azure AI Zoeken Maven-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelle start voor tekstinhoud analyseren

Een quickstart voor een tekstblocklist gebruiken

Quickstartgids voor het analyseren van afbeeldingsinhoud

Content Safety SDK voor Java

Content Safety Maven-pakket
Document intelligence-pictogram Document intelligence Documenten omzetten in intelligente gegevensgestuurde oplossingen. Snelstart voor Document Intelligence

Document Intelligence SDK voor Java

Document Intelligence Maven-pakket
Vision-icoon Vision Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Quickstart voor afbeeldingsanalyse

De snelstartgids voor de Face-service gebruiken

Vision SDK voor Java

Vision Maven-pakket

Foundry Tools ondersteund voor JavaScript

Gereedschap voor Foundry Beschrijving Snelstartgidsen en referentiedocumentatie
Spraakpictogram Spraak Voeg spraak-naar-tekst, tekst-naar-spraak, vertaling en sprekeridentificatiemogelijkheden toe aan toepassingen. Snelstart voor spraak-naar-tekst

Snelstart voor tekst-naar-spraak

Snelstartgids voor spraakomzetting

Speech-SDK voor JavaScript

Spraak npm-pakket
Taalpictogram Taal Toepassingen bouwen met mogelijkheden voor natuurlijke taalkennis. Ondersteunde functies: Taaldetectie, PII-detectie, Text Analytics voor Gezondheid, Voorgebouwde NER en Aangepaste NER. Buiten gebruik gesteld op 31 maart 2029: Sentimentanalyse en Meninganalyse, Sleuteltermextractie, Samenvatting, Entity Linking, CQA en CLU. Quickstart voor entiteitskoppeling(wordt buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor taaldetectie

Quickstart voor sleuteltermextractie(uitgefaseerd op 31 maart 2029)

Snelstart voor het herkennen van benoemde entiteiten (NER)

Quickstart voor het detecteren van persoonlijk identificeerbare informatie (PII)

Quickstart voor sentimentanalyse en opinieanalyse(buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor tekst-, document- en gespreksamenvattinggebruik (niet meer beschikbaar vanaf 31 maart 2029)

Een snelstartgids voor het gebruik van Tekstanalyse voor gezondheid

Taal-SDK voor JavaScript (tekstanalyse)

Taal npm-pakket

Migrate from Language Studio to Microsoft Foundry voor hulp bij het migreren van workloads met buiten gebruik stellen van functies
Translator-pictogram Translator Gebruik door AI gemaakte vertaaltechnologie om meer dan 100 in gebruik zijnde, risicovolle en bedreigde talen en dialecten te vertalen. Translator SDK voor JavaScript (tekst)

Translator npm-pakket (tekst)
Azure AI Zoeken pictogram Azure AI Zoeken Breng met AI gemaakte cloudzoekopdrachten naar uw mobiele en web-apps. Agent-gebaseerde quickstart voor ophalen gebruiken

Snelle start voor vectorzoek

Klassieke generatieve zoekopdracht (RAG) met de quickstart voor basisgegevens

Snelstartgids voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chatten met Azure OpenAI-modellen met behulp van uw eigen gegevens in een snelstartgids

Azure AI Zoeken SDK voor JavaScript

Azure AI Zoeken npm-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelle start voor tekstinhoud analyseren

Een quickstart voor een tekstblocklist gebruiken

Quickstartgids voor het analyseren van afbeeldingsinhoud

Content Safety NPM-pakket
Document intelligence-pictogram Document intelligence Documenten omzetten in intelligente gegevensgestuurde oplossingen. Snelstart voor Document Intelligence

Document Intelligence SDK voor JavaScript

Document Intelligence NPM-pakket
Vision-icoon Vision Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De snelstartgids voor de Face-service gebruiken

Vision-SDK voor JavaScript

Vision NPM-pakket

Door Python ondersteunde Foundry-tools

Gereedschap voor Foundry Beschrijving Snelstartgidsen en referentiedocumentatie
Spraakpictogram Spraak Voeg spraak-naar-tekst, tekst-naar-spraak, vertaling en sprekeridentificatiemogelijkheden toe aan toepassingen. Snelstart voor spraak-naar-tekst

Snelstart voor tekst-naar-spraak

Snelstartgids voor spraakomzetting

Speech SDK voor Python

Speech PyPi-pakket
Taalpictogram Taal Toepassingen bouwen met mogelijkheden voor natuurlijke taalkennis. Ondersteunde functies: Taaldetectie, PII-detectie, Text Analytics voor Gezondheid, Voorgebouwde NER en Aangepaste NER. Buiten gebruik gesteld op 31 maart 2029: Sentimentanalyse en Meninganalyse, Sleuteltermextractie, Samenvatting, Entity Linking, CQA en CLU. Quickstart voor het beantwoorden van aangepaste vragen (CQA)(buiten gebruik stellen 31 maart 2029)

Quickstart voor entiteitskoppeling(wordt buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor taaldetectie

Quickstart voor sleuteltermextractie(uitgefaseerd op 31 maart 2029)

Snelle start met het detecteren van benoemde entiteiten (NER)

Quickstart voor het detecteren van persoonlijk identificeerbare informatie (PII)

Quickstart voor sentimentanalyse en opinieanalyse(buiten gebruik gesteld op 31 maart 2029)

Snelstartgids voor tekst-, document- en gespreksamenvattinggebruik (niet meer beschikbaar vanaf 31 maart 2029)

Een snelstartgids voor het gebruik van Tekstanalyse voor gezondheid

Language SDK voor Python (tekstanalyse)

Programmeertaal PyPi-pakket (tekstanalyse)

Language SDK voor Python (vragen beantwoorden)

Taal PyPi-pakket (antwoord op vraag)

Language SDK voor Python (taalgesprekken)(buiten gebruik stellen van 31 maart 2029)

Language-PyPi-pakket (taalgesprekken)(uit de circulatie nemen op 31 maart 2029)

Migrate from Language Studio to Microsoft Foundry voor hulp bij het migreren van workloads met buiten gebruik stellen van functies
Translator-pictogram Translator Gebruik door AI gemaakte vertaaltechnologie om meer dan 100 in gebruik zijnde, risicovolle en bedreigde talen en dialecten te vertalen. Translator SDK voor Python (tekst)

Translator PyPi-pakket (tekst)

Translator SDK voor Python (batch)

Translator PyPI-pakket (batch)
Azure AI Zoeken pictogram Azure AI Zoeken Breng met AI gemaakte cloudzoekopdrachten naar uw mobiele en web-apps. Snel verbinding maken met een zoekservice

Agent-gebaseerde quickstart voor ophalen gebruiken

Snelle start voor vectorzoek

Klassieke generatieve zoekopdracht (RAG) met de quickstart voor basisgegevens

Snelstartgids voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chatten met Azure OpenAI-modellen met behulp van uw eigen gegevens in een snelstartgids

Azure AI Zoeken SDK voor Python

Azure AI Zoeken PyPi-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelle start voor tekstinhoud analyseren

Een quickstart voor een tekstblocklist gebruiken

Quickstartgids voor het analyseren van afbeeldingsinhoud

Content Safety SDK voor Python

Content Safety PyPi-pakket
Document intelligence-pictogram Document intelligence Documenten omzetten in intelligente gegevensgestuurde oplossingen. Snelstart voor Document Intelligence

Document Intelligence SDK voor Python

Document Intelligence PyPi-pakket
Vision-icoon Vision Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De snelstartgids voor de Face-service gebruiken

Vision SDK voor Python

Vision PyPi-pakket