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.
Le service Foundry Agent est une plateforme managée pour la création, le déploiement et la mise à l’échelle d’agents IA. Créez avec n’importe quel framework, n’importe quel modèle pris en charge du catalogue de modèles Foundry, et un point d’entrée unique pour l’inférence des modèles et les outils.
Foundry vous rencontre n’importe où sur le spectre du code déclaratif au code complet : définissez un agent d’invite ou un agent d’invite vocal et laissez Foundry l’exécuter, empaqueter votre propre code en tant qu’agent hébergé ou appeler l’API Réponses à partir d’un agent que vous exécutez déjà ailleurs. Choisir comment compiler présente chaque possibilité.
Aperçu rapide du service d'agent
| Composant | Qu’est-ce qu’il fait ? |
|---|---|
| Runtime de l’agent | Héberge et fait évoluer les agents fondés sur des requêtes ainsi que les agents hébergés. Gère les conversations, les appels d’outils et le cycle de vie de l’agent. |
| Boîtes à outils | Organisez un ensemble d’outils une fois, tels que la recherche web, la recherche de fichiers, l’interpréteur de code, les serveurs MCP et les fonctions personnalisées. Ensuite, partagez-les entre les agents via un seul point de terminaison MCP géré avec l’authentification centralisée, la gouvernance et le contrôle de version. |
| Modèles | Fonctionne avec de nombreux modèles du catalogue de modèles Foundry, tels que GPT-4o, Llama et DeepSeek. Échangez des modèles sans modifier votre code d’agent. |
| Observabilité | Suivi de bout en bout, métriques, évaluations et intégration d’Application Insights. Voyez chaque décision que votre agent prend et mesure sa qualité. |
| Optimisation | L’optimiseur d’agents (version préliminaire) évalue le comportement des agents et génère automatiquement de meilleures instructions, compétences, descriptions d’outils et une meilleure sélection de modèles pour les agents de prompt et les agents hébergés. |
| Identity &Security | Microsoft Entra identité, RBAC, filtres de contenu et isolation du réseau virtuel. Fiabilité de niveau professionnel intégrée. |
| Publication en cours | Les agents de version, créent des points de terminaison stables et partagent via Microsoft Teams, Microsoft Copilot et le Registre de l’agent Entra. |
Choisir comment générer
Tip
Création de votre premier agent ? Commencez par un agent d’invite à l’aide du portail Foundry ou du guide de démarrage rapide pour créer un agent d’invite avec du code.
Foundry vous offre plusieurs façons de créer, allant d’un simple appel à un modèle à un agent entièrement conteneurisé. Choisissez votre chemin d’accès en fonction de ce que vous essayez de faire :
- Vous voulez minimiser la gestion du texte ?Commencez par un agent de prompts. Configurer des instructions, un modèle et des outils ; Foundry l’exécute sans code ni infrastructure.
- Vous souhaitez une expérience vocale en temps réel managée ?Créez un agent d’invite vocale. Configurez l’expérience vocale et connectez-la via Voice Live sans héberger vous-même le code d’orchestration.
- Vous voulez un contrôle total dans Foundry ?Déployez un agent hébergé. Apportez votre propre code et infrastructure en tant que conteneur ; Foundry l’exécute avec un point de terminaison managé, une mise à l’échelle et une identité.
- Exécutez déjà le code de l’agent ailleurs ?Appelez l’API Réponses directement pour utiliser des modèles et des outils Foundry, sans ressource d’agent à gérer.
Les agents d’invite, les agents d’invite basés sur la voix et les agents hébergés sont les types d’agents couverts dans cette vue d’ensemble. La section suivante décompose la valeur de chacune d’elles afin que vous puissiez choisir en toute confiance.
Types d’agents
Le service d’agent offre trois types d’agents. Votre choix détermine ce que vous construisez et ce qui est géré par Foundry :
- Agents prompt : la voie la plus rapide. Définissez des instructions, un modèle et des outils, et Foundry exécute l’agent pour vous sans code ni infrastructure à gérer.
- Agents d’invite basés sur la voix : agents vocaux gérés en temps réel. Configurez le modèle, les instructions, l’audio et les outils, puis connectez-vous à l’agent via Voice Live.
- Agents hébergés : le plus de contrôle. Apportez votre propre code et infrastructure, et Foundry l’exécute en tant que conteneur avec un point de terminaison managé, une mise à l’échelle et une identité.
Agents fondés sur des requêtes
Vous définissez entièrement les agents d’invite via la configuration, notamment les instructions, la sélection du modèle et les outils. Créez-les dans le portail Foundry pour un démarrage rapide, ou définissez-les par programmation avec les SDK ou l’API REST afin de les intégrer à vos flux de travail CI/CD. Dans les deux cas, Foundry exécute l’agent pour vous. Il n’existe aucun code d’application à gérer et aucun conteneur ou package pour optimiser, mettre à l’échelle ou surveiller la sécurité.
Deux chemins d’accès pour commencer :
- Portail d’abord : créez un agent de manière interactive dans le portail Foundry, testez-le dans le terrain de jeu, puis appelez-le à partir de votre code d’application.
- Code-first : définissez l’agent à l’aide du Kit de développement logiciel (SDK) ou de l’API REST dans votre pipeline de déploiement, en activant le contrôle de version, la révision du code et le déploiement automatisé.
Idéal pour : prise en main rapide, outils internes, agents de production qui n’ont pas besoin d’une logique d’orchestration personnalisée et d’équipes qui souhaitent un runtime managé sans surcharge d’infrastructure.
Agents d’invite vocale
Les agents d’invite vocale sont des agents gérés pour des conversations vocales en temps réel. Configurez un modèle, des instructions, des paramètres audio, un message d’accueil facultatif et des outils dans la définition de l’agent. Le service Foundry Agent gère le cycle de vie de l’agent et utilise Voice Live pour la reconnaissance vocale, la gestion des tours de parole, l’interaction avec le modèle et la synthèse vocale.
Les agents d’invite vocale prennent en charge les modèles managés et, lorsqu’ils sont pris en charge, votre propre déploiement de modèle. Vous vous connectez à l’agent sur un WebSocket en temps réel au lieu d’envoyer des requêtes de texte individuelles. Pour connaître la configuration et les langues clientes prises en charge, consultez Démarrage rapide : Créer un agent d’invite vocale. Pour connaître les architectures vocales, les ressources et les limites actuelles de la préversion, consultez le fonctionnement des agents vocaux.
Idéal pour : expériences vocales orientées client, scénarios de centre d’appels et applications nécessitant une interaction audio à faible latence sans implémenter vous-même le service d’orchestration vocale.
Agents hébergés
Agents hébergés sont des agents basés sur le code que vous créez avec Agent Framework, LangGraph, le kit SDK OpenAI Agents SDK, le KIT SDK Anthropic Agent, le SDK GitHub Copilot, ou votre propre code. Envoyez votre agent sous la forme d’une image conteneur ou d’un fichier .zip de votre code source (Foundry génère l’image pour vous lorsque vous apportez un fichier .zip), et Foundry l’exécute avec un point de terminaison managé, une mise à l’échelle automatique, une identité dédiée Microsoft Entra, une persistance d’état au niveau de la session et une observabilité de bout en bout.
Sous le capot, votre code agent appelle votre point de terminaison de projet Foundry pour l’inférence de modèle et l’orchestration des outils, ce qui vous permet d’accéder aux modèles Foundry à partir du catalogue et d’un ensemble unifié d’outils de plateforme : outils standard tels que la recherche de fichiers, l’interpréteur de code et la recherche web, ainsi que d’autres outils tels que SharePoint, WorkIQ et Fabric IQ.
Idéal pour : agents qui appellent votre propre code personnalisé ; deuxièmement, logique d’orchestration personnalisée, systèmes multi-agents et protocoles personnalisés (webhooks, voix, AG-UI) où vous souhaitez un contrôle total sur la logique de l’agent tout en laissant Foundry gérer l’hébergement, la mise à l’échelle et l’identité.
Comparer les types d’agents
| Agents fondés sur des requêtes | Agents d’invite vocale | Agents hébergés | |
|---|---|---|---|
| Zone de création | Portail, SDK ou REST | Définition de l’agent via le portail, le SDK ou REST | Agent Framework, LangGraph, OpenAI Agents SDK, Anthropic Agent SDK, GitHub Copilot SDK, code personnalisé |
| Modèles Foundry + outils de la plateforme | Oui | Oui, via Voice Live et les outils d’agent configurés | Oui (via l’API Réponses sur le point de terminaison du projet Foundry) |
| Prise en charge des compétences | Oui | Oui | Oui |
| Code d’exécution à gérer | None | Aucun pour l’orchestration vocale managée | Oui, votre logique d’agent |
| Calcul à gérer | Aucun, entièrement géré | Aucun, entièrement géré | Calcul de conteneur, géré par Foundry |
| Point de terminaison managé | Oui | Oui, WebSocket en temps réel | Oui |
| Autoscale | Automatique, géré par Foundry ; mise à l’échelle avec le volume de requête | Géré par Foundry et Voice Live | Automatique, géré par Foundry ; met à l’échelle les instances de conteneur par session et le volume de requête |
| Identité de l’agent (Entra) | Oui | Oui | Automatique, dédié à chaque agent |
| Modèle de coût | Inférence par appel + utilisation de l’outil | Utilisation de Voice Live et du modèle ; voir la tarification du service | Inférence à l’appel + utilisation d’outils + calcul conteneurisé |
| Idéal pour | Démarrage rapide, agents de production sans orchestration personnalisée | Interactions vocales en temps réel sans héberger de code d’orchestration vocale | Agents qui appellent du code personnalisé ; deuxièmement, logique d’orchestration personnalisée |
Utiliser l’API Réponses pour les agents éphémères
Lorsque vous appelez l’API Réponses directement à partir de votre propre code, vous créez un agent éphémère : la définition de l’agent (instructions, outils et modèle) réside dans votre code d’application au lieu d’une ressource persistante dans Foundry. Chaque appel assemble l’agent dans votre processus et l’exécute sur l’API Réponses. Il n’y a donc aucun agent à créer, mettre à jour ou supprimer dans Foundry.
Utilisez ce modèle lorsque vous souhaitez :
- Logique d’agent fournie avec votre application. Les versions des définitions avec le reste de votre code, via le contrôle de version et la revue de code, au lieu d’une ressource Foundry séparée que quelqu’un doit maintenir synchronisée avec l’application.
- Les capacités de Foundry sans surcharge en ressources. Vous bénéficiez toujours de modèles de catalogue, d’outils de la plateforme, de données propres au projet, d’une authentification au nom de l’utilisateur, ainsi que de l’observabilité et de la gouvernance au niveau du projet. Le tout via le point de terminaison de votre projet Foundry.
Consultez démarrage rapide : Utiliser l’API Réponses pour plus d’informations .
Fonctionnement des agents vocaux
Les agents pilotés par des invites vocales mènent des conversations orales en temps réel. Vous configurez l’agent dans le portail Foundry ou via le Kit de développement logiciel (SDK), testez-le avec un microphone et le mettez à disposition via une expérience de navigateur ou un canal de numéro de téléphone. Foundry gère le cycle de vie de l’agent et l’orchestration vocale, de sorte que vous n’hébergez pas cette infrastructure vous-même.
Important
Les agents vocaux et certaines fonctionnalités de surveillance, d’évaluation, d’avatar, webRTC et de téléphonie associées sont en préversion. Les fonctionnalités en préversion sont fournies sans contrat de niveau de service et ne sont pas recommandées pour les charges de travail de production tant que vous n’avez pas examiné les exigences de prise en charge, de sécurité, de conformité et de disponibilité.
Les agents vocaux prennent en charge deux architectures de modèle.
Conversion vocale de bout en bout native
Caller audio
-> realtime speech model
-> spoken response
Cette architecture est optimisée pour une conversation naturelle et à faible latence. Le modèle en temps réel gère directement les entrées et sorties parlées. Les paramètres pris en charge et les familles de voix dépendent du modèle sélectionné.
Modèle de texte en cascade
Caller audio
-> speech recognition
-> text model
-> speech synthesis
-> spoken response
Cette architecture offre un modèle texte plus large et des choix vocaux Azure. Il fournit également un contrôle explicite sur la transcription, les listes d’expressions, la détection des tours de parole et les réponses intermédiaires, mais chaque étape contribue à la latence de bout en bout.
Ressources principales
Un agent vocal créé par le portail classique utilise :
- Ressource et projet Foundry.
- Un agent de prompt vocal versionné.
- Un modèle Voice Live entièrement géré, ou un modèle déployé par un client éligible.
- Fonctionnalités d’Azure Speech dans Foundry Tools pour la transcription ou la synthèse, lorsque l’architecture sélectionnée l’exige.
- Application Insights pour les traces, le monitoring et les données d’évaluation.
- Azure Communication Services et Azure Event Grid pour les appels entrants de l’extensibilité de Teams Phone, ou une connexion à un projet Twilio pour les canaux de numéros de téléphone Twilio.
Vous n’avez pas besoin de déployer un modèle audio distinct lorsque vous utilisez un modèle Voice Live entièrement managé. La disponibilité et le comportement du modèle sont chargés dynamiquement pour votre ressource et votre région.
Limites de prise en charge dans le portail actuel
| Capacité | Comportement actuel basé sur la voix |
|---|---|
| Test du navigateur | Prise en charge à partir du terrain de jeu de l’agent. |
| Aperçu de l’application web | Disponible lorsque le point de terminaison de l’agent prend en charge le protocole Réponses. |
| Numéros de téléphone | Extensibilité de Teams Phone et de Twilio. |
| Direct SIP | Actuellement non proposé en tant que flux client pris en charge. |
| Publication d’applications pour Microsoft Teams et Microsoft 365 Copilot | La carte standard d’agent textuel n’est actuellement pas visible dans la disposition Canaux basée sur la voix. Ne décrivez pas cela comme chemin d’intégration téléphonique. |
| Avatar | Sortie visuelle du navigateur sur WebRTC ; les appelants téléphoniques reçoivent uniquement l’audio. |
| Monitoring | Les cartes de synthèse propres à la voix, la ventilation des jetons et les graphiques de latence des connexions nécessitent Application Insights. |
| Tracing | Les traces vocales utilisent une vue unique orientée trace, car les traces vocales n’ont pas d’response_idAPI Réponses. |
| Évaluation | L’évaluation complète des conversations à partir des conversations existantes est prise en charge. Les évaluations à un seul tour et en conversation simulée ne sont actuellement pas prises en charge pour les agents vocaux. |
| Création de jeux de données à partir de traces | L’action de page de suivi n’est actuellement pas disponible pour les assistants vocaux. |
Disponibilité et tarification
La disponibilité dépend de la région de ressources Foundry, du modèle sélectionné, de la voix sélectionnée, de l’abonnement et des fonctionnalités en préversion activées. Vérifiez le portail avant de vous appuyer sur un modèle spécifique.
Les frais potentiels incluent les données d’entrée et de sortie des modèles d’IA générative, la reconnaissance et la synthèse vocales, l’entraînement et l’hébergement de voix personnalisées, l’utilisation d’avatars, l’ingestion et la conservation des données dans Application Insights, les appels et les numéros de téléphone d’Azure Communication Services, Microsoft Teams et les services de téléphonie, ainsi que les outils connectés et les services de données. Pour plus d’informations sur les coûts, consultez Tarification des agents vocaux.
Documentation de l’agent vocal
| Article | Utilisez-le pour |
|---|---|
| Créer un agent d’invite vocale | Créez un agent vocal managé, connectez-vous à une session en direct et effectuez un tour parlé. |
| Configurer un agent vocal | Choisissez un modèle et configurez la transcription, les langues, les voix, les avatars, la détection de tour, l’amélioration audio, les réponses intermédiaires et les outils. |
| Intégrer un canal de téléphonie | Intégrez l’extensibilité de Teams Phone ou Twilio avec un agent vocal. |
| Suivi, surveillance et évaluation de l’agent vocal | Tracez, surveillez et évaluez les conversations vocales. |
| Meilleures pratiques pour les agents vocaux | Appliquez les contrôles relatifs aux instructions, à la latence, à la reconnaissance, à la sécurité, à la confidentialité, au relais, aux tests et à la mise en production. |
Prise en charge des modèles
Le service Agent fonctionne avec de nombreux modèles disponibles dans le catalogue de modèles Foundry. Pour obtenir la liste complète, consultez le portail Foundry.
Outils et boîtes à outils
Les agents agissent sur le monde par le biais d’outils. Foundry offre des outils intégrés tels que la recherche web, la recherche de fichiers, l’interpréteur de code et la mémoire, tout en vous permettant d’ajouter des outils personnalisés via des fonctions, des spécifications OpenAPI et des serveurs MCP. Pour obtenir l’ensemble complet, consultez la vue d’ensemble de la boîte à outils.
Une boîte à outils regroupe ces outils en une seule unité réutilisable. Vous organisez les outils une fois, et Foundry les expose derrière un point de terminaison compatible MCP géré que n’importe quel agent ou runtime peut consommer, quel que soit l’infrastructure. Les boîtes à outils centralisent l’authentification, la gouvernance et la gestion des versions, ce qui vous permet de mettre à jour les outils en un seul endroit au lieu de devoir reconfigurer chaque agent. Créez une nouvelle version, testez-la et faites-la passer par défaut lorsque vous êtes prêt. Pour plus d’informations, consultez Présentation de la boîte à outils dans Foundry ?.
Se connecter et s’authentifier auprès de serveurs distants MCP
Foundry prend en charge les serveurs MCP distants que vous pouvez ajouter à votre agent, tels que le serveur MCP Azure DevOps. Connectez votre organisation Azure DevOps pour activer l’accès à l’agent et configurez un sous-ensemble d’outils disponibles pour contrôler les actions que les agents peuvent effectuer. Vous pouvez également connecter des serveurs MCP personnalisés hébergés sur Azure Functions à l’aide du point de terminaison webhook Functions MCP (/runtime/webhooks/mcp) pour exposer des outils personnalisés à vos agents.
Les options d’authentification prises en charge pour les serveurs MCP et d’autres connexions d’outils sont les suivantes :
- Accès basé sur des clés
- Microsoft Entra (à l'aide de l'identité managée de l'agent ou de l'identité managée du projet)
- Passthrough d’identité OAuth (on-Behalf-Of)
- Accès non authentifié, le cas échéant
Ces options d’authentification s’appliquent également lors de la connexion de serveurs MCP distants, avec des informations d’identification et des étendues gérées dans la configuration de l’outil.
Cycle de vie du développement
Agent Service prend en charge l'ensemble du processus build-test-deploy-monitor :
- Créer : définissez un agent d’invite dans le portail ou avec le Kit de développement logiciel (SDK) ou écrivez un agent hébergé qui appelle l’API Réponses.
- Test : discutez avec votre agent dans le terrain de jeu des agents ou exécutez localement. Les intégrations de serveur MCP, y compris les serveurs MCP personnalisés hébergés sur Azure Functions, peuvent être exécutées directement dans le terrain de jeu pour valider la connectivité, les autorisations et le comportement des outils avant la publication.
- Trace : Inspectez chaque appel de modèle, invocation d’outil et décision grâce au traçage de l’agent.
- Évaluer : exécutez des évaluations pour mesurer la qualité et intercepter les régressions.
- Optimiser : améliorez automatiquement les instructions de votre agent hébergé à l’aide de l’optimiseur d’agent.
- Publier : promouvoir votre agent vers une ressource managée avec un point de terminaison stable.
- Surveiller : effectuez le suivi des performances et de la fiabilité avec les métriques de service et les tableaux de bord.
Pour obtenir une procédure pas à pas détaillée, consultez le cycle de vie du développement de l’agent.
Fonctionnalités d’entreprise
Le service Agent fournit une infrastructure de qualité entreprise pour chaque agent que vous déployez :
- Identité de l’agent : chaque agent peut avoir une identité dédiée Microsoft Entra, ce qui permet un accès sécurisé et limité aux ressources et AUX API sans partager les informations d’identification. Les identités d’agent peuvent s’authentifier auprès de serveurs MCP externes, y compris ceux hébergés sur Azure Functions, et le passthrough OAuth on-Behalf-Of (OBO) est pris en charge lors de la configuration.
- Mise en réseau privée : exécutez des agents au sein de votre réseau virtuel Azure pour une isolation réseau complète et la conformité avec les exigences de résidence des données. Le réseau privé est disponible pour les agents de prompts. Les agents hébergés prennent en charge la fonctionnalité « Bring Your Own Réseau virtuel Azure » (BYO VNet), dans le cadre de laquelle chaque séance s'exécute dans un environnement sandbox isolé au niveau de la machine virtuelle et connecté à votre réseau virtuel.
- Contrôle d’accès en fonction du rôle : autorisations affinées via Microsoft Entra et Azure RBAC. Contrôler qui peut créer, appeler et gérer des agents.
- Sécurité du contenu : Des filtres intégrés contribuent à réduire les risques d’injection de prompt (y compris inter-prompts) et à prévenir les sorties non sécurisées.
Pour obtenir des instructions de configuration de l’environnement, consultez Configurer votre environnement.
Publication et partage
Le service d’agent fournit le contrôle de version intégré et la publication afin que vos agents puissent passer du développement à la production en toute confiance.
- Gestion des versions : Lors de vos itérations sur un agent, des instantanés de versions sont générés automatiquement. Revenez à n’importe quelle version précédente ou comparez les modifications entre les versions.
- Publication : Faites évoluer un agent vers une ressource gérée dotée d’un point de terminaison stable. Les agents publiés héritent des contrôles d’identité et d’accès d’entreprise configurés pour votre projet et peuvent être appelés par programmation.
- Distribution : partagez des agents publiés via Microsoft Copilot et Teams et le Registre de l’agent Entra, en plaçant vos agents sur lesquels vos utilisateurs travaillent déjà. Le service Agent Foundry prend en charge les protocoles OpenResponses et Activity pour la publication dans Microsoft 365, le protocole Invocations pour l’intégration flexible de points de terminaison à des applications et services personnalisés, ainsi que le protocole A2A pour la communication d’agent à agent. A2A v1.0 est généralement disponible et v0.3 reste en préversion.
Sécurité, confidentialité et conformité
Le service agent est conçu pour les charges de travail d’entreprise où vous avez besoin de contrôles forts sur l’identité, la mise en réseau, la gestion des données et la sécurité.
- Contrôles de sécurité : utilisez les garde-fous intégrés pour réduire les sorties non sécurisées et atténuer les risques d’injection d’invites, y compris les attaques par injection inter-invites (XPIA).
- Contrôles d’isolation réseau et de résidence des données : utilisez des réseaux virtuels et apportez vos propres ressources pour répondre à vos besoins.
- Apporter vos propres ressources : utilisez vos propres ressources Azure (par exemple, le stockage, Recherche Azure AI et Azure Cosmos DB pour l’état de la conversation) pour répondre aux besoins de conformité et opérationnels. Consultez Utiliser vos propres ressources.
- Responsible AI guidance : Pour obtenir un ensemble plus large de recommandations et de ressources de gouvernance, consultez Responsible AI pour Microsoft Foundry.
Contenu connexe
- Configurer votre environnement
- Cycle de vie du développement de l’agent
- Déployer votre premier agent hébergé
- Vue d’ensemble de la boîte à outils Foundry
- Déployer votre premier agent hébergé
- Créer un agent d’invite vocale
- Meilleures pratiques pour les agents vocaux
- Catalogue d’outils
- Quotas, limites et prise en charge régionale
- Pour obtenir de l’aide ou pour vous connecter à la communauté, rejoignez la Microsoft AI Discord.