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.
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 tableDe 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 tsvDe opdracht wordt succesvol voltooid en geeft de vervaltijd van het token weer. Als dit mislukt, voert u
az loginuit 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-miniimplementatie gereed is:az cognitiveservices account deployment show \ --name <resource-name> \ --resource-group <resource-group> \ --deployment-name gpt-5-mini \ --query properties.provisioningState \ --output tsvDe 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
/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.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
- Access Foundry Models, waaronder Azure OpenAI
- De Foundry Agent-service gebruiken
- Cloudevaluaties 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 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.
- 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.