Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Affichage actuel :Version du portail - Passer à la version du nouveau portail Foundry
Une ressource Foundry fournit un accès unifié aux modèles, agents et outils. Cet article explique le Kit de développement logiciel (SDK) et le point de terminaison à utiliser pour votre scénario.
Le Kit de développement logiciel (SDK) Foundry est un SDK client léger qui expose toutes les API de projet Foundry via un seul point de terminaison de projet. Les kits SDK de niveau supérieur s’appuient sur celui-ci , par exemple, le package Agent Framework foundry dépend du SDK Foundry pour accéder aux modèles, outils et configuration du projet Foundry.
| SDK | Qu’est-ce que c’est pour | Point de terminaison |
|---|---|---|
| Kit de développement logiciel (SDK) Foundry | SDK client léger pour toutes les API des projets Foundry. Accès aux modèles foundry et aux outils de plateforme (recherche de fichiers, interpréteur de code, recherche web, mémoire, SharePoint, WorkIQ, Fabric IQ, MCP). | https://<resource-name>.services.ai.azure.com/api/projects/<project-name> |
| Infrastructure de l’agent | Orchestration multi-agent unifiée pour les agents hébergés et les systèmes multi-agents, disponibles en C#/.NET et Python. Le foundry package dépend du Kit de développement logiciel (SDK) Foundry pour l’accès au projet. |
API Réponses dans le point de terminaison du projet, via FoundryChatClient. |
| Kit de développement logiciel (SDK) OpenAI | Ensemble complet des fonctionnalités de l’API OpenAI, y compris les embeddings et les modèles Foundry commercialisés par Azure via Chat Completions. Meilleure latence et compatibilité maximale d’OpenAI. | https://<resource-name>.openai.azure.com/openai/v1 |
| sdk Anthropic | Modèles Claude d’Anthropic déployés dans Foundry. | https://<resource-name>.services.ai.azure.com/anthropic |
| Kits de développement logiciel (SDK) Foundry Tools | Solutions prédéfinies (Vision, Reconnaissance vocale, Sécurité du contenu, etc.). | Points de terminaison spécifiques à l’outil. |
Choisissez votre Kit de développement logiciel (SDK) :
- Utiliser le Kit de développement logiciel (SDK) Foundry lors de la création d’applications avec des agents, des évaluations ou des fonctionnalités spécifiques à Foundry
- Utilisez Agent Framework pour les agents hébergés ou les systèmes multi-agents dans le code à l’aide de l’API Réponses en C#/.NET ou Python
- Utilisez le Kit de développement logiciel (SDK) OpenAI lorsque la compatibilité OpenAI maximale ou la latence la plus faible est requise, lors de la génération d’incorporations ou lors de l’utilisation de modèles vendus par Azure par le biais d’achèvements de conversation
- Utilisez Anthropic SDK lors de l’utilisation de modèles Anthropic Claude déployés dans Foundry
- Utilisez les kits SDK Foundry Tools lors de l’utilisation de services IA spécifiques (Vision, Speech, Language, etc.)
Note
Types de ressources : Une ressource Foundry fournit tous les points de terminaison précédemment répertoriés. Une ressource OpenAI Azure fournit uniquement le point de terminaison /openai/v1.
Authentication : Exemples ici utilisent Microsoft Entra ID (DefaultAzureCredential). Les clés API fonctionnent sur /openai/v1. Transmettez la clé en tant que api_key au lieu d’un fournisseur de jetons.
Conditions préalables
-
Un compte Azure avec un abonnement actif. Si vous n'en avez pas, créez un compte Azure gratuit, qui inclut un abonnement d'essai gratuit.
Disposez du rôle Azure RBAC requis pour votre tâche dans l’étendue la plus restreinte possible :
Utilisateur Foundry sur le projet Foundry pour le développement au quotidien.
Important
Les rôles Foundry RBAC ont été récemment renommés. Foundry User, Foundry Owner, Propriétaire du compteFoundry et Foundry Project Manager ont été précédemment nommés Azure utilisateur IA, Azure propriétaire d’IA, propriétaire Azure compte IA et Azure gestionnaire Project IA. Il se peut que vous voyiez encore les anciens noms à certains endroits pendant le déploiement de ce changement de nom. Les ID de rôle et les autorisations de base ne sont pas modifiés par ce changement de nom.
Foundry Project Manager dans le projet Foundry pour gérer un projet existant et ses connexions.
Propriétaire du compte Foundry sur la ressource Foundry pour créer des projets ou gérer des ressources au niveau du compte. Attribuez ce rôle au groupe de ressources cible uniquement lorsque vous devez créer une ressource Foundry.
Activez l’attribution de groupe de ressources juste à temps via Microsoft Entra Privileged Identity Management (PIM) et désactivez-la après l’approvisionnement. Les développeurs et les utilisateurs d’exécution quotidiens n’ont pas besoin de cette attribution élevée.
Pour plus d'informations sur les autorisations de chaque rôle, consultez Contrôle d'accès en fonction du rôle pour Microsoft Foundry.
Installez les runtimes de langage requis, les outils globaux et les extensions VS Code, comme décrit dans Préparer votre environnement de développement.
Vérifier les prérequis
Avant de continuer, vérifiez que chaque vérification retourne le résultat indiqué :
Vérifiez que l’Azure CLI utilise l’abonnement et le locataire souhaités :
az account show --query "{subscription:name, tenant:tenantId}" --output tableLa commande se termine correctement et affiche l’abonnement et le locataire attendus.
Vérifiez que votre identifiant local peut demander un jeton d’accès Foundry sans afficher le jeton :
az account get-access-token --resource https://ai.azure.com --query expiresOn --output tsvLa commande se termine correctement et affiche l’heure d’expiration du jeton. En cas d’échec, exécutez
az loginavec une identité qui a le rôle Foundry requis.Vérifiez que vous disposez du rôle RBAC requis dans le portail Azure sous Ressource Foundry>Contrôle d’accès (IAM).
- Exécutez
python --version. La commande se termine correctement et signale Python 3.9 ou version ultérieure.
- Exécutez
node --version. La commande se termine correctement et indique Node.js 22 ou une version ultérieure.
- Exécutez
dotnet --version. La commande se termine correctement et signale .NET 8 ou version ultérieure.
- Exécutez
java --version. La commande se termine correctement et indique Java 17 ou une version ultérieure.
Vérifiez que votre point de terminaison de projet a ce format :
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>.Confirmez que le déploiement
gpt-5-miniest prêt :az cognitiveservices account deployment show \ --name <resource-name> \ --resource-group <resource-group> \ --deployment-name gpt-5-mini \ --query properties.provisioningState \ --output tsvCette commande renvoie
Succeeded. Utilisez le nom déployé dans les exemples de code si votre déploiement a un autre nom.
Kit de développement logiciel (SDK) Foundry
Le Kit de développement logiciel (SDK) Foundry se connecte à un seul point de terminaison de projet qui fournit l’accès aux fonctionnalités de Foundry les plus populaires :
https://<resource-name>.services.ai.azure.com/api/projects/<project-name>
Note
Si votre organisation utilise un sous-domaine personnalisé, remplacez-le <resource-name><your-custom-subdomain> dans l’URL du point de terminaison.
Cette approche simplifie la configuration de l’application. Au lieu de gérer plusieurs points de terminaison, vous en configurez un.
Installer le Kit de développement logiciel (SDK)
Note
Cet article s’applique à un projet Foundry. Le code présenté ici ne fonctionne pas pour un projet hub. Pour plus d’informations, consultez Types de projets.
Note
Versions du Kit de développement logiciel (SDK) : Cet article traite de l’installation du Kit de développement logiciel (SDK) 1.x. Vérifiez que les exemples que vous suivez correspondent à votre package installé. Passez à la documentation du nouveau portail Foundry pour consulter l'article concernant la version 2.x.
| Version du Kit de développement logiciel (SDK | Version du portail | Statut | package Python |
|---|---|---|---|
| 2.x | Fonderie (nouvelle) | Stable | azure-ai-projects>=2.0.0 |
| 1.x | Foundry (classique) | Stable | azure-ai-projects==1.0.0 |
La bibliothèque cliente Azure AI Projects pour Python est une bibliothèque unifiée qui vous permet d’utiliser plusieurs bibliothèques clientes ensemble en vous connectant à un point de terminaison de projet unique.
Exécutez cette commande pour installer les packages 1.x pour les projets classiques Foundry.
pip install openai azure-identity azure-ai-projects==1.0.0
| Version du Kit de développement logiciel (SDK | Version du portail | Statut | package Java |
|---|---|---|---|
| 1.x | Classique de fonderie | Retraité | Aucun package Java pris en charge n’est disponible pour ce chemin classique. Utiliser com.azure:azure-ai-projects:2.2.0 avec un projet Foundry actuel. |
| Version du Kit de développement logiciel (SDK | Version du portail | Statut | Paquet JavaScript |
|---|---|---|---|
| 1.0.1 | Classique de fonderie | Stable | @azure/ai-projects |
| Version du Kit de développement logiciel (SDK | Version du portail | Statut | Package .NET |
|---|---|---|---|
| 1.1.0 (GA) | Classique de fonderie | Stable | Azure.AI.Projects |
Le chemin d’accès du SDK Java pour Foundry Classic est abandonné. Le Kit de développement logiciel (SDK) de projet 1.x classique n'a pas atteint la disponibilité générale pour Java, et le package de préversion supprimé azure-ai-inference n'est pas un remplacement pris en charge.
Important
Ne démarrez pas le développement Java et n’effectuez pas de migration avec le SDK classique. Passez au guide actuel du SDK Foundry et utilisez la version GA de la bibliothèque cliente Azure AI Projects pour Java avec un projet Foundry actuel.
Pour un projet Foundry actuel, ajoutez la dépendance suivante à votre Maven pom.xml:
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-ai-projects</artifactId>
<version>2.2.0</version>
</dependency>
La bibliothèque cliente Azure AI Projects pour JavaScript est une bibliothèque unifiée qui vous permet d’utiliser plusieurs bibliothèques clientes ensemble en vous connectant à un point de terminaison de projet unique.
Exécutez cette commande pour installer les packages JavaScript 1.x pour les projets classiques Foundry.
npm install @azure/ai-projects@1.0.1 @azure/identity
La bibliothèque cliente Azure AI Projects pour .NET est une bibliothèque unifiée qui vous permet d’utiliser plusieurs bibliothèques clientes ensemble en vous connectant à un point de terminaison de projet unique.
Exécutez ces commandes pour ajouter les packages SDK IA Azure 1.x pour les projets classiques Foundry.
# 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
Utilisation du Kit de développement logiciel (SDK) Foundry
Le Kit de développement logiciel (SDK) expose deux types de clients, car Foundry et OpenAI ont des formes d’API différentes :
- Project client – Utilisation pour les opérations natives de Foundry lorsque OpenAI n’a pas d’équivalent. Exemples : liste des connexions, récupération des propriétés du projet, activation du suivi.
-
Client compatible OpenAI : utilisez la fonctionnalité Foundry qui s’appuie sur les concepts OpenAI. L’API Réponses, les agents, les évaluations et le réglage précis utilisent tous les modèles de requête/réponse de style OpenAI. Ce client vous donne également accès aux modèles directs Foundry (modèles nonAzure-OpenAI hébergés dans Foundry). Le point de terminaison du projet sert ce trafic sur l’itinéraire
/openai.
La plupart des applications utilisent les deux clients. Utilisez le client de projet pour l’installation et la configuration, puis utilisez le client compatible OpenAI pour exécuter des agents, des évaluations et des modèles appelants (y compris les modèles directs Foundry).
Créez un client de projet :
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(),
)
Créez un client compatible OpenAI à partir de votre projet :
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)
Le parcours Java de première réussite pour Foundry Classic est supprimé. L’ancien azure-ai-inference exemple ne crée pas de client de projet classique et utilise un appel d’API qui n’est pas disponible dans cette version du package.
Pour le développement Java, utilisez com.azure:azure-ai-projects:2.2.0 avec un projet Foundry existant et suivez le guide actuel du SDK Foundry. Ce chemin d’accès actuel du SDK n’ajoute pas la prise en charge de Java aux projets Foundry classiques.
Créez un client de projet :
const endpoint = "https://<resource-name>.services.ai.azure.com/api/projects/<project-name>";
const deployment = "gpt-4o";
const project = new AIProjectClient(endpoint, new DefaultAzureCredential());
Créez un client compatible OpenAI à partir de votre projet :
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);
Créez un client de projet :
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());
Créez un client compatible OpenAI à partir de votre projet :
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);
Ce que vous pouvez faire avec le Kit de développement logiciel (SDK) Foundry
- Access Foundry Models, y compris Azure OpenAI
- Utiliser le service Foundry Agent
- Exécuter des évaluations de cloud
- Activer le suivi des applications
- Ajuster un modèle
- Obtenez les points de terminaison et les clés pour Foundry Tools, l’orchestration locale et bien plus encore
Dépannage
Erreurs d’authentification
Si vous voyez DefaultAzureCredential failed to retrieve a token:
Verify Azure CLI est authentifié :
az account show az login # if not logged inVérification de l’attribution de rôle RBAC :
Vérifiez que vous avez au moins le rôle Utilisateur Foundry sur le projet Foundry
Important
Les rôles Foundry RBAC ont été récemment renommés. Foundry User, Foundry Owner, Propriétaire du compteFoundry et Foundry Project Manager ont été précédemment nommés Azure utilisateur IA, Azure propriétaire d’IA, propriétaire Azure compte IA et Azure gestionnaire Project IA. Il se peut que vous voyiez encore les anciens noms à certains endroits pendant le déploiement de ce changement de nom. Les ID de rôle et les autorisations de base ne sont pas modifiés par ce changement de nom.
Consultez Attribuer des rôles Azure
Pour l’identité managée en production :
- Vérifiez que l’identité managée a le rôle approprié attribué
- Voir Configurer des identités managées
Erreurs de configuration de point de terminaison
Si vous voyez Connection refused ou 404 Not Found:
- Vérifier que les noms des ressources et des projets correspondent à votre déploiement réel
-
Vérifier le format d’URL du point de terminaison : doit être
https://<resource-name>.services.ai.azure.com/api/projects/<project-name> -
Pour les sous-domaines personnalisés : remplacer
<resource-name>par votre sous-domaine personnalisé
Incompatibilités de version du Kit de développement logiciel (SDK)
Si des exemples de code échouent avec AttributeError ou ModuleNotFoundError:
Vérifiez la version du Kit de développement logiciel (SDK) :
pip show azure-ai-projects # Python npm list @azure/ai-projects # JavaScript dotnet list package # .NETRéinstaller avec des indicateurs de version corrects : consultez les commandes d’installation dans chaque section de langue ci-dessus
Kit de développement logiciel (SDK) OpenAI
Utilisez le Kit de développement logiciel (SDK) OpenAI lorsque vous souhaitez obtenir une surface d’API OpenAI complète et une compatibilité maximale du client. Ce point de terminaison permet d’accéder aux modèles Azure OpenAI et aux modèles directs Foundry (via l'API Chat Completions). Il ne fournit pas d’accès aux fonctionnalités spécifiques à Foundry, telles que les agents et les évaluations.
L’extrait de code suivant montre comment utiliser directement le point de terminaison Azure OpenAI /openai/v1.
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))
Pour plus d’informations, consultez Langages de programmation Azure pris en charge par OpenAI. Sortie attendue :
{
"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)."
}
Pour plus d’informations, consultez Langages de programmation Azure OpenAI pris en charge
Important
Les éléments marqués (préversion) dans cet article sont actuellement en préversion publique. Cette préversion est fournie sans contrat de niveau de service. Nous vous déconseillons donc de l’utiliser dans des charges de travail de production. Certaines fonctionnalités peuvent ne pas être prises en charge ou avoir des fonctionnalités contraintes. Pour plus d’informations, consultez Conditions supplémentaires d'utilisation pour les versions préliminaires de Microsoft Azure.
L’extrait de code suivant montre comment utiliser directement le point de terminaison Azure OpenAI /openai/v1.
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());
Pour plus d’informations sur l’utilisation du Kit de développement logiciel (SDK) OpenAI, consultez Azure langages de programmation pris en charge par OpenAI.
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);
Pour plus d’informations sur l’utilisation du Kit de développement logiciel (SDK) OpenAI, consultez Azure langages de programmation pris en charge par OpenAI.
- Installez le package OpenAI : exécutez cette commande pour ajouter la bibliothèque de client OpenAI à votre projet .NET.
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
Pour plus d’informations sur l’utilisation du Kit de développement logiciel (SDK) OpenAI, consultez Azure langages de programmation pris en charge par OpenAI.
Infrastructure de l’agent
Microsoft Agent Framework est un SDK open source pour C#/.NET et Python qui fournit une orchestration multi-agent unifiée et des abstractions cohérentes pour la création d’agents et de systèmes multi-agents. Il s’agit de la couche d’orchestration recommandée pour les agents hébergés dans Foundry.
- Si vous avez déjà utilisé AutoGen ou Noyau sémantique pour l’orchestration multi-agent (coordination de plusieurs agents pour travailler ensemble sur des tâches), considérez Agent Framework comme votre couche d’orchestration principale. Il vous permet d’éviter de combiner plusieurs kits SDK d’orchestration qui résolvent des tâches de coordination similaires, ce qui peut ajouter des abstractions et des dépendances conflictuelles.
- Si vous disposez déjà d’un code d’orchestration important, dépendez des fonctionnalités spécifiques au produit ou que vous rencontrez des exigences de migration complexes, évaluez ces exigences avant de consolider sur Agent Framework.
Exécuter votre code en tant qu’agent hébergé
L’histoire principale des agents basés sur du code dans Foundry est les agents hébergés. Écrivez votre agent avec Agent Framework, empaquetez-le en tant qu’image conteneur ou zip de votre code source et laissez Foundry l’exécuter avec un point de terminaison managé, une mise à l’échelle automatique sur des machines virtuelles Micro isolées, une identité d’agent dédiée Microsoft Entra, un état au niveau de la session et une observabilité de bout en bout.
Les agents hébergés sont le chemin recommandé lorsque vous souhaitez qu’un point de terminaison accessible en réseau géré par Foundry soit appelé par d’autres applications ou agents. Consultez Déployer votre premier agent hébergé.
Générer des agents dans du code en dehors de Foundry avec l’API Réponses
Si vous hébergez votre agent en dehors de Foundry , dans votre propre processus ou infrastructure, vous pouvez également utiliser Agent Framework pour appeler directement l’API Réponses dans votre point de terminaison de projet . Agent Framework se connecte via le FoundryChatClient fournisseur, qui cible :
{project_endpoint}/openai/v1/responses
Passer par le point de terminaison du projet , au lieu d’un point de terminaison OpenAI au niveau de la ressource, donne à votre agent :
- Modèles Foundry du catalogue (Azure OpenAI et modèles Foundry directs) via une API unique.
- Outils de plateforme au-delà de l’ensemble d’outils OpenAI, notamment la recherche de fichiers, l’interpréteur de code, la mémoire, la recherche web, les serveurs MCP, les SharePoint, WorkIQ et Fabric IQ.
- Données délimitées au projet, authentification de l’outil On-Behalf-Of (OBO), ainsi que le traçage, les filtres de contenu et la configuration de l’identité du projet.
Ce modèle vient s’ajouter aux agents hébergés, et non les remplacer — le même code Agent Framework peut appeler l’API Responses depuis votre propre processus dès aujourd’hui et être packagé plus tard comme agent hébergé, lorsque vous souhaiterez un point de terminaison géré par Foundry. Consultez démarrage rapide : Générer des agents à l’aide de l’API Réponses.
Pour une comparaison complète des types d’agents et des options d’hébergement, consultez Qu’est-ce que Microsoft Foundry Agent Service ?.
Kits de développement logiciel (SDK) Foundry Tools
Les Foundry Tools (anciennement Azure Services IA) sont des solutions ciblées prédéfinies avec des SDK dédiés. Utilisez les points de terminaison suivants pour utiliser Foundry Tools.
Quel point de terminaison devez-vous utiliser ?
Choisissez un point de terminaison en fonction de vos besoins :
Utilisez le point de terminaison Azure AI Services pour accéder à Vision par ordinateur, Sécurité du contenu, Document Intelligence, Langue, Traduction et Outils de recherche de jetons.
Point de terminaison des Outils de fonderie : https://<your-resource-name>.cognitiveservices.azure.com/
Note
Les points de terminaison utilisent votre nom de ressource ou un sous-domaine personnalisé. Si votre organisation a configuré un sous-domaine personnalisé, remplacez your-resource-name par your-custom-subdomain dans tous les exemples de point de terminaison.
Si vos charges de travail utilisent la mise hors service des fonctionnalités de Azure AI Language(par exemple, analyse des sentiments, extraction d’expressions clés, synthèse, liaison d’entité, CLU ou CQA) envisagez de migrer vers des alternatives de Microsoft Foundry. Pour le nouveau développement, envisagez d’utiliser le Kit de développement logiciel (SDK) Foundry ou le point de terminaison compatible OpenAI, comme décrit plus haut dans cet article. Consultez Migrate de Language Studio à Microsoft Foundry.
Pour Foundry Tools reconnaissance vocale et de traduction, utilisez les points de terminaison dans les tableaux suivants. Remplacez les espaces réservés par vos informations de ressource.
Points de terminaison de la voix
| Outil de fonderie | Point de terminaison |
|---|---|
| Reconnaissance vocale (standard) | https://<YOUR-RESOURCE-REGION>.stt.speech.microsoft.com |
| Synthèse vocale (neuronal) | https://<YOUR-RESOURCE-REGION>.tts.speech.microsoft.com |
| Voix Personnalisée | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Points de terminaison pour la traduction
| Outil de fonderie | Point de terminaison |
|---|---|
| Traduction de texte | https://api.cognitive.microsofttranslator.com/ |
| Traduction de documents | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com/ |
Points d'accès de langue
| Outil de fonderie | Point de terminaison |
|---|---|
| Analyse de texte | https://<YOUR-RESOURCE-NAME>.cognitiveservices.azure.com |
Important
Le 20 mars 2027, Azure Language Studio sera mis hors service et migrera vers Microsoft Foundry ; toutes les fonctionnalités et améliorations futures seront disponibles dans Microsoft Foundry.
Le 31 mars 2029, les fonctionnalités de langage Azure suivantes seront mise hors service (fin de support). Avant cette date, les utilisateurs doivent migrer des charges de travail existantes et intégrer de nouveaux projets vers des modèles Microsoft Foundry pour améliorer la compréhension du langage naturel et l’intégration simplifiée des applications :
- Extraction d’expressions clés
- Analyse des sentiments et exploration des opinions
- Classification de texte personnalisée
- Compréhension du Langage Conversationnel (CLU)
- Réponses aux questions personnalisées (CQA)
- Workflow d’orchestration
- Résumé (extractif et abstrait, pour les documents et les conversations)
- Liaison d’entités
Fonctionnalités principales avec prise en charge continue : Détection de la langue, Détection de PII, Analyse de texte pour la santé, NER prédéfini et NER personnalisé.
Pour connaître les options de migration, consultez Migrate de Language Studio à Microsoft Foundry.