Microsoft Foundry SDK's en eindpunten (klassiek)

Momenteel weergeven:Foundry -portalversie - (klassiek)Overschakelen naar versie voor de nieuwe Foundry-portal

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 Volledige OpenAI API-functionaliteit, inclusief embeddings en Foundry-modellen die door Azure worden verkocht via Chat Completions. 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 modellen die worden verkocht door Azure via voltooiingen van chats
  • 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.

  • Beschik voor uw taak over de vereiste Azure RBAC-rol met het kleinst mogelijke bereik:

    • Foundry User in het Foundry-project voor dagelijkse 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 in het Foundry-project om een bestaand project en de verbindingen ervan te beheren.

    • Eigenaar van het Foundry-account op de Foundry-resource om projecten te maken of resources op accountniveau te beheren. Wijs deze rol alleen toe aan de doelresourcegroep wanneer u een Foundry-resource moet maken.

      Activeer de toewijzing van de resourcegroep precies op tijd via Microsoft Entra Privileged Identity Management (PIM) en deactiveer deze na het inrichten. Dagelijkse ontwikkelaars en runtimegebruikers hebben deze toewijzing met verhoogde bevoegdheid niet nodig.

    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.

Vereisten controleren

Controleer voordat u doorgaat of elke controle het opgegeven resultaat retourneert:

  • Controleer of de Azure CLI gebruikmaakt van het beoogde abonnement en de tenant:

    az account show --query "{subscription:name, tenant:tenantId}" --output table
    

    De opdracht wordt succesvol uitgevoerd en toont het verwachte abonnement en de tenant.

  • Controleer of uw lokale referentie een Foundry-toegangstoken kan aanvragen zonder het token weer te geven:

    az account get-access-token --resource https://ai.azure.com --query expiresOn --output tsv
    

    De opdracht wordt succesvol voltooid en geeft de vervaltijd van het token weer. Als dit mislukt, voert u az login uit onder een identiteit die over de vereiste Foundry-rol beschikt.

  • Controleer of u de vereiste RBAC-rol hebt in de Azure-portal onder Toegangsbeheer voor Foundry-resources>(IAM).

  • Voer python --versionuit. Het commando wordt succesvol afgesloten en meldt Python 3.9 of hoger.
  • Voer node --versionuit. De opdracht wordt succesvol voltooid en meldt Node.js 22 of nieuwer.
  • Voer dotnet --versionuit. De opdracht wordt succesvol voltooid en geeft .NET 8 of hoger aan.
  • Voer java --versionuit. De opdracht wordt succesvol voltooid en meldt Java 17 of hoger.
  • Controleer of het projecteindpunt de volgende indeling heeft: https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.

  • Controleer of de gpt-5-mini implementatie gereed is:

    az cognitiveservices account deployment show \
      --name <resource-name> \
      --resource-group <resource-group> \
      --deployment-name gpt-5-mini \
      --query properties.provisioningState \
      --output tsv
    

    De opdracht retourneert Succeeded. Gebruik de geïmplementeerde naam in de codevoorbeelden als uw implementatie een andere naam heeft.

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

Opmerking

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.

Opmerking

SDK-versies: In dit artikel wordt de installatie van de 1.x SDK beschreven. Zorg ervoor dat de voorbeelden die u volgt overeenkomen met het geïnstalleerde pakket. Schakel over naar de nieuwe Foundry-portaldocumentatie om het artikel voor 2.x weer te geven.

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 1.x-pakketten voor klassieke Foundry-projecten te installeren.

pip install openai azure-identity azure-ai-projects==1.0.0
SDK-versie Portalversie Status Java-pakket
1.x Gieterij classic Gepensioneerd Er is geen ondersteund Java-pakket beschikbaar is voor dit klassieke pad. Gebruik com.azure:azure-ai-projects:2.2.0 met een bestaand Foundry-project.
SDK-versie Portalversie Status JavaScript-pakket
1.0.1 Gieterij classic Stabiel @azure/ai-projects
SDK-versie Portalversie Status .NET-pakket
1.1.0 (GA) Gieterij classic Stabiel Azure.AI.Projects

Het Java SDK-pad voor Foundry classic wordt buiten gebruik gesteld. De klassieke 1.x-project-SDK heeft geen algemene beschikbaarheid voor Java bereikt en het buiten gebruik gestelde azure-ai-inference preview-pakket is geen ondersteunde vervanging.

Belangrijk

Start of migreer Java ontwikkeling niet op het klassieke SDK-pad. Schakel over naar de huidige Foundry SDK-handleiding en gebruik de GA-Azure AI Projects-clientbibliotheek voor Java met een huidig Foundry-project.

Voor een huidig Foundry-project voegt u de volgende afhankelijkheid toe aan uw Maven pom.xml:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-ai-projects</artifactId>
    <version>2.2.0</version>
</dependency>

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 1.x JavaScript-pakketten voor klassieke Foundry-projecten te installeren.

npm install @azure/ai-projects@1.0.1 @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 opdrachten uit om de 1.x Azure AI SDK-pakketten toe te voegen voor klassieke Foundry-projecten.

# Add 1.x Azure AI SDK packages
dotnet add package Azure.Identity
dotnet add package Azure.AI.Projects --version 1.1.0
dotnet add package Azure.AI.Agents.Persistent --version 1.1.0
dotnet add package Azure.AI.Inference

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 biedt u ook toegang tot Foundry directe modellen (niet-Azure-OpenAI modellen die worden gehost in Foundry). 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.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

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:

models = project_client.get_openai_client(api_version="2024-10-21")
chat_responses = models.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "system", "content": "You are a helpful assistant"},
        {"role": "user", "content": "What is the size of France in square miles?"},
    ],
)

print(chat_responses.choices[0].message.content)

Het Java first-success-pad voor Foundry classic is uitgefaseerd. In het vorige azure-ai-inference voorbeeld wordt geen klassieke projectclient gemaakt en wordt een API-aanroep gebruikt die niet beschikbaar is in die pakketversie.

Gebruik voor Java ontwikkeling com.azure:azure-ai-projects:2.2.0 met een huidig Foundry-project en volg de huidige Foundry SDK-handleiding. Dit huidige SDK-pad voegt geen Java ondersteuning toe voor klassieke Foundry-projecten.

Een projectclient maken:

const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";

const project = new AIProjectClient(endpoint, new DefaultAzureCredential());

Maak een openAI-compatibele client op basis van uw project:

const client = await project.getAzureOpenAIClient({
    // The API version should match the version of the Azure OpenAI resource
    apiVersion: "2024-12-01-preview"
});
const chatCompletion = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});

console.log(chatCompletion.choices[0].message.content);

Een projectclient maken:

using System.ClientModel.Primitives;
using Azure.AI.OpenAI;
using Azure.AI.Projects;
using Azure.Identity;
using OpenAI.Chat;

string endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
AIProjectClient projectClient = new AIProjectClient(new Uri(endpoint), new DefaultAzureCredential());

Maak een openAI-compatibele client op basis van uw project:

ClientConnection connection = projectClient.GetConnection(typeof(AzureOpenAIClient).FullName!);
if (!connection.TryGetLocatorAsUri(out Uri uri) || uri is null)
{
    throw new InvalidOperationException("Invalid URI.");
}
uri = new Uri($"https://{uri.Host}");
const string modelDeploymentName = "gpt-4o";  
AzureOpenAIClient azureOpenAIClient = new AzureOpenAIClient(uri, new DefaultAzureCredential());
ChatClient chatClient = azureOpenAIClient.GetChatClient(deploymentName: modelDeploymentName);

Console.WriteLine("Complete a chat");
ChatCompletion result = chatClient.CompleteChat("List all the rainbow colors");
Console.WriteLine(result.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 en de maximale clientcompatibiliteit wilt. Dit API-eindpunt biedt toegang tot Azure OpenAI-modellen en Foundry direct modellen (via API voor chatvoltooiingen). 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)) 

Zie Azure OpenAI ondersteunde programmeertalen voor meer informatie. 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

Belangrijk

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. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure previews voor meer informatie.

In het volgende codefragment ziet u hoe u het Azure OpenAI-/openai/v1-eindpunt rechtstreeks gebruikt.

import com.azure.ai.openai.OpenAIClient;
import com.azure.ai.openai.OpenAIClientBuilder;
import com.azure.ai.openai.models.ChatChoice;
import com.azure.ai.openai.models.ChatCompletions;
import com.azure.ai.openai.models.ChatCompletionsOptions;
import com.azure.ai.openai.models.ChatRequestAssistantMessage;
import com.azure.ai.openai.models.ChatRequestMessage;
import com.azure.ai.openai.models.ChatRequestSystemMessage;
import com.azure.ai.openai.models.ChatRequestUserMessage;
import com.azure.ai.openai.models.ChatResponseMessage;
import com.azure.core.credential.AzureKeyCredential;
import com.azure.core.util.Configuration;

import java.util.ArrayList;
import java.util.List;

String endpoint = "https://<resource-name>.openai.azure.com/openai/v1";
String deploymentName = "gpt-5.2";
TokenCredential defaultCredential = new DefaultAzureCredentialBuilder().build();
OpenAIClient client = new OpenAIClientBuilder()
    .credential(defaultCredential)
    .endpoint("{endpoint}")
    .buildClient();

List<ChatRequestMessage> chatMessages = new ArrayList<>();
chatMessages.add(new ChatRequestSystemMessage("You are a helpful assistant."));
chatMessages.add(new ChatRequestUserMessage("What is the speed of light?"));

ChatCompletions chatCompletions = client.getChatCompletions(deploymentName, new ChatCompletionsOptions(chatMessages));

System.out.printf("Model ID=%s is created at %s.%n", chatCompletions.getId(), chatCompletions.getCreatedAt());
for (ChatChoice choice : chatCompletions.getChoices()) {
    ChatResponseMessage message = choice.getMessage();
    System.out.printf("Index: %d, Chat Role: %s.%n", choice.getIndex(), message.getRole());
    System.out.println("Message:");
    System.out.println(message.getContent());

Zie Azure door OpenAI ondersteunde programmeertalen voor meer informatie over het gebruik van de OpenAI SDK.

import { AzureOpenAI } from "openai";
import { DefaultAzureCredential, getBearerTokenProvider } from "@azure/identity";

const deployment = "gpt-4o";
const endpoint = "https://<resource-name>.openai.azure.com";
const scope = "https://ai.azure.com/.default";
const apiVersion = "2024-04-01-preview";

const azureADTokenProvider = getBearerTokenProvider(new DefaultAzureCredential(), scope);

const options = { azureADTokenProvider, deployment, apiVersion, endpoint };

const client = new AzureOpenAI(options);

const result = await client.chat.completions.create({
    model: deployment,
    messages: [
        { role: "system", content: "You are a helpful assistant" },
        { role: "user", content: "What is the speed of light?" },
    ],
});
console.log(result.choices[0].message.content);

Zie Azure door OpenAI ondersteunde programmeertalen voor meer informatie over het gebruik van de OpenAI SDK.

  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 `ChatClient` for the Azure OpenAI v1 endpoint.
    ```csharp
    using System.ClientModel.Primitives;
    using Azure.Identity;
    using OpenAI;
    using OpenAI.Chat;
    
    #pragma warning disable OPENAI001
    
    const string directModelEndpoint  = "https://<resource-name>.openai.azure.com/openai/v1/";
    const string modelDeploymentName = "gpt-5.2";    
    
    BearerTokenPolicy tokenPolicy = new(
         new DefaultAzureCredential(),
         "https://ai.azure.com/.default");
    OpenAIClient openAIClient = new(
         authenticationPolicy: tokenPolicy,
         options: new OpenAIClientOptions()
         {
             Endpoint = new($"{directModelEndpoint}"),
         });
    ChatClient chatClient = openAIClient.GetChatClient(modelDeploymentName);
    
    ChatCompletion completion = await chatClient.CompleteChatAsync(
         [
             new SystemChatMessage("You are a helpful assistant."),
                         new UserChatMessage("How many feet are in a mile?")
         ]);
    
    Console.WriteLine(completion.Content[0].Text);
    #pragma warning restore OPENAI001
    

Zie Azure door OpenAI ondersteunde programmeertalen voor meer informatie over het gebruik van de OpenAI SDK.

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. Dit is de aanbevolen orchestratielaag 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. Gebruik snelstart voor agentic retrieval

Snelle start voor vector zoeken

Klassieke generatieve zoekopdrachten (RAG) met behulp van basisgegevens quickstart

Snelstart voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chat met Azure OpenAI-modellen met behulp van uw eigen gegevens voor een snelle start

Azure AI Zoeken SDK voor .NET

Azure AI Zoeken NuGet-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelstart tekstinhoudanalyse

Een snelstartgids voor een tekstbloklijst gebruiken

Snel aan de slag met 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-pictogram Visie Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De quickstart 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. Gebruik snelstart voor agentic retrieval

Snelle start voor vector zoeken

Klassieke generatieve zoekopdrachten (RAG) met behulp van basisgegevens quickstart

Snelstart voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chat met Azure OpenAI-modellen met behulp van uw eigen gegevens voor een snelle start

Azure AI Zoeken SDK voor Java

Azure AI Zoeken Maven-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelstart tekstinhoudanalyse

Een snelstartgids voor een tekstbloklijst gebruiken

Snel aan de slag met 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-pictogram Visie Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Quickstart voor afbeeldingsanalyse

De quickstart 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. Gebruik snelstart voor agentic retrieval

Snelle start voor vector zoeken

Klassieke generatieve zoekopdrachten (RAG) met behulp van basisgegevens quickstart

Snelstart voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chat met Azure OpenAI-modellen met behulp van uw eigen gegevens voor een snelle start

Azure AI Zoeken SDK voor JavaScript

Azure AI Zoeken npm-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelstart tekstinhoudanalyse

Een snelstartgids voor een tekstbloklijst gebruiken

Snel aan de slag met 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-pictogram Visie Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De quickstart 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

Gebruik snelstart voor agentic retrieval

Snelle start voor vector zoeken

Klassieke generatieve zoekopdrachten (RAG) met behulp van basisgegevens quickstart

Snelstart voor zoeken in volledige tekst

Snelstartgids voor Semantische classificatie

Chat met Azure OpenAI-modellen met behulp van uw eigen gegevens voor een snelle start

Azure AI Zoeken SDK voor Python

Azure AI Zoeken PyPi-pakket
Inhoudsveiligheidspictogram Inhoudsveiligheid Schadelijke inhoud in toepassingen en services detecteren. Snelstart tekstinhoudanalyse

Een snelstartgids voor een tekstbloklijst gebruiken

Snel aan de slag met 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-pictogram Visie Analyseer inhoud in digitale afbeeldingen en uitgebreide mediaassets. Azure Vision in Foundry Tools v3.2 GA Lees de snelle startgids

Quickstart voor afbeeldingsanalyse

De quickstart voor de Face-service gebruiken

Vision SDK voor Python

Vision PyPi-pakket