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.
Microsoft Foundry Agent Service prend en charge plusieurs options de mise en réseau, d’une configuration entièrement publique pour un prototypage rapide afin d’effectuer une isolation réseau à l’intérieur de votre propre réseau virtuel. Cet article compare les options, mappe chacun à des objectifs communs et vous pointe vers le modèle de déploiement et le guide de configuration de l’option que vous choisissez.
Après avoir choisi une option, suivez le guide pratique lié pour le déployer, puis validez le déploiement. Si vous rencontrez des problèmes, utilisez les conseils de résolution des problèmes liés.
Comportement de mise en réseau par défaut
Lorsque vous créez une ressource Foundry sans configuration réseau, vous obtenez une base de référence entièrement publique :
- Trafic entrant : le point de terminaison Foundry est accessible sur l’Internet public. N’importe quel appelant avec des informations d’identification valides et l’URL du point de terminaison peut l’atteindre.
- Sortant : les agents atteignent vos données et Azure ressources via la mise en réseau publique et peuvent atteindre uniquement les points de terminaison accessibles par Internet.
- Stockage : l’état de l’agent utilise le stockage géré par Microsoft par défaut. Si vous apportez votre propre stockage et d’autres ressources Azure, vous configurez l’accès réseau à ces ressources dans le cadre de votre configuration réseau.
Rien n’est privé tant que vous n’avez pas choisi l’une des options de la section suivante. Chaque option modifie le côté entrant, le côté sortant ou les deux.
Options de mise en réseau
Une configuration réseau combine deux décisions connexes :
- Accès sortant (sortie) : comment vos agents atteignent vos données et d’autres ressources Azure. Cette décision détermine l’isolation principale : conserver la sortie publique ou la limiter à un réseau virtuel afin que le trafic reste sur votre réseau privé. Le réseau virtuel peut être celui que vous apportez et gérez (réseau virtuel BYO) ou un Microsoft gère pour vous.
- Accès entrant : quels réseaux peuvent atteindre votre point de terminaison Foundry. Public (éventuellement limité aux adresses IP sélectionnées) ou privé via un point de terminaison privé.
Les deux décisions sont connectées. Lorsque vous isolez la sortie dans un réseau virtuel, l’accès entrant au point de terminaison Foundry passe également par un point de terminaison privé, car les ressources de ce réseau virtuel atteignent le point de terminaison sur le réseau privé. Commencez par le modèle de sortie, car ce choix détermine l’isolation et les options entrantes disponibles. Le tableau suivant présente les trois modèles de sortie et les choix entrants disponibles avec chacun d’eux.
| Modèle de sortie | Choix d’entrée | Idéal pour |
|---|---|---|
| Trafic sortant public | Public (adresses IP sélectionnées éventuellement) ou un point de terminaison privé dans votre réseau virtuel | Aucune isolation de sortie. Utilisez le trafic entrant public pour le prototypage et les tests, ou un point de terminaison privé pour restreindre les appelants pendant que la sortie reste publique. |
| Réseau virtuel BYO | Point de terminaison privé dans votre réseau virtuel | Isolation complète où vous contrôlez les plages d’adresses IP, le peering et le routage. Les agents sont injectés dans un sous-réseau que vous délèguez et gérez. |
| Réseau virtuel géré | Point de terminaison privé dans votre réseau virtuel | Isolation complète sans gérer les plages d’adresses IP ou lorsque votre espace IP se chevauche. Les agents s’exécutent dans un réseau virtuel géré par Microsoft. |
Avec un trafic de sortie public, l’ajout d’un point de terminaison privé sécurise uniquement le chemin d’entrée : les clients accèdent au point de terminaison Foundry via un réseau privé, mais le trafic de sortie de l’agent n’est pas isolé.
Avec le réseau virtuel BYO, vous pouvez apporter vos propres ressources de données ou utiliser des ressources de données gérées par la plateforme. Pour plus d’informations, consultez La configuration requise pour le réseau virtuel bring-your-own.
Note
L’isolation réseau s’applique au niveau du compte Foundry et du projet. Il inclut les agents hébergés, les agents de requête et les autres ressources Foundry du compte. Les deux types d’agents consomment des ressources réseau différemment à l’intérieur d’une configuration isolée. Pour plus de détails, consultez Analyse approfondie de la mise en réseau de Foundry Agent Service.
Options de mise en réseau par scénario
Le tableau suivant mappe les objectifs courants à une option recommandée et à un modèle de déploiement. Les modèles d’infrastructure en tant que code se trouvent dans le référentiel d’exemple de configuration de l’infrastructure Foundry (Bicep, avec un miroir Terraform).
| Votre objectif | Option recommandée | Déployer avec |
|---|---|---|
| Chemin le plus rapide vers un agent opérationnel, sans isolation | Stockage public, géré par Microsoft | Guide de démarrage rapide pour déployer votre premier agent hébergé (Azure Developer CLI ou VS Code) |
| Conserver les données de l’agent dans vos propres ressources Azure, sans isolation | Stockage public utilisant votre propre stockage (standard) | 41-standard-agent-setup |
| Limiter qui peut appeler le point de terminaison ; un trafic sortant public est acceptable | Sortie publique avec un point de terminaison privé | 10-private-network-basic |
| Isolation complète sans sortie publique, vous contrôlez le réseau et souhaitez apporter vos propres ressources de données | Réseau virtuel BYO avec des ressources « apportez vos propres données » (norme de sécurité par le réseau) | 15-private-network-standard-agent-setup |
| Isolation complète sans sortie publique, vous contrôlez le réseau, mais ne souhaitez pas gérer les ressources de données | Réseau virtuel BYO avec des ressources de données gérées par la plateforme | 11-private-network-basic-vnet |
| Isolation complète, mais vous ne pouvez pas gérer les plages d’adresses IP ou votre espace IP se chevauche | Réseau virtuel managé | 18-managed-virtual-network |
| Isolation complète derrière une passerelle d’API | Réseau virtuel BYO avec Gestion des API Azure | 16-private-network-standard-agent-apim-setup |
| Accéder à des ressources locales à partir d’agents | Réseau virtuel BYO plus VPN ou ExpressRoute |
15-private-network-standard-agent-setup et Accéder aux ressources locales (on-premises) |
Pour obtenir le catalogue de modèles complet et ce que chacun d’eux provisionne, consultez le fichier README de configuration de l’infrastructure.
Exigences relatives au réseau virtuel apporté par le client
Le réseau virtuel BYO et le réseau virtuel managé fournissent une isolation complète. La différence est celle qui exécute le réseau : avec un réseau virtuel managé, Microsoft gère les exigences de cette section pour vous. Choisissez le réseau virtuel BYO lorsque vous souhaitez contrôler entièrement un réseau que vous gérez déjà : vos propres plages d’adresses IP, pare-feu, peering et routage.
Lorsque vous choisissez un réseau virtuel BYO, planifiez ces exigences avant de déployer. La procédure d’installation et la présentation approfondie les couvrent entièrement.
- Sous-réseau dédié et délégué. Déléguer un sous-réseau à
Microsoft.App/environments. Le sous-réseau ne peut pas être partagé par plusieurs ressources Foundry. Dimensionnez-le en fonction de l’échelle prévue ; consultez Planifiez la taille de votre sous-réseau. - Espace d’adressage RFC 1918 et RFC 6598 uniquement. Dans RFC 1918, utilisez uniquement
10.0.0.0/8,172.16.0.0/12ou192.168.0.0/16. Dans RFC 6598 ou CGNAT, utilisez des adresses IP dans la plage100.64.0.0/10sauf100.100.0.0/17,100.100.192.0/19et100.100.224.0/19. Les plages d’adresses IP publiques ne sont pas prises en charge. - Utilisez uniquement l’espace d’adressage RFC 1918 ou RFC 6598 pris en charge. Pour RFC 1918, utilisez des adresses dans
10.0.0.0/8,172.16.0.0/12ou192.168.0.0/16. Pour RFC 6598 (CGNAT), utilisez des adresses dans100.64.0.0/10, à l’exclusion100.100.0.0/17,100.100.192.0/19et100.100.224.0/19. Les plages d’adresses IP publiques ne sont pas prises en charge. - Votre choix de ressources de données. Avec le réseau virtuel BYO, vous choisissez comment les ressources de données de l’agent (stockage Azure, Foundry IQ (Recherche Azure AI) et Azure Cosmos DB) sont fournies :
- Ressources de données gérées par la plateforme. Utilisez des ressources de données multilocataire gérées par la plateforme afin de ne pas apporter ou configurer vos propres ressources. Choisissez cette option lorsque vos agents n'ont pas besoin de ressources de données gérées par le client( par exemple, de nombreux scénarios d'agent hébergé) ou lorsque vous souhaitez éviter la planification de capacité pour les ressources telles que Azure Cosmos DB. Cette option supprime la nécessité de configurer les ressources de données que vous n’utilisez pas.
- Apportez vos propres ressources de données. Utilisez vos propres stockage Azure, Foundry IQ et Azure Cosmos DB afin que toutes les données de l’agent restent dans votre locataire. Choisissez cette option lorsque vous avez besoin de données d’agent dans les ressources que vous possédez et gérez.
- Points de terminaison privés et zones DNS privé pour le compte Foundry, et pour chaque ressource de données que vous apportez, la résolution de noms reste donc à l’intérieur du réseau virtuel.
- Même région pour la ressource Foundry et le réseau virtuel. D’autres ressources peuvent se trouver dans différentes régions, avec des implications sur les coûts interrégions.
Important
Définissez la configuration du réseau virtuel lorsque vous créez le compte Foundry. L’injection de réseau fait partie du flux de création de ressources et ne peut pas être ajoutée à un compte existant. La configuration réseau prend effet lorsque vous créez le premier agent hébergé et que vous ne pouvez pas modifier l’injection de réseau par la suite. Pour passer à une autre configuration réseau, créez de nouveaux projets. La configuration s’applique au niveau du compte ; elle couvre donc à la fois les agents hébergés et les agents basés sur des requêtes. Choisissez un réseau virtuel BYO avant de créer le compte.
Pour obtenir un diagramme de topologie de l’option de réseau virtuel BYO : sous-réseau délégué, machines virtuelles micro-agents hébergés et points de terminaison privés pour vos ressources de données, consultez Présentation approfondie de la mise en réseau du service de l’agent Foundry.
Prise en charge des outils avec isolation réseau
Tous les outils d’agent ne prennent pas en charge l’isolation réseau. Certains outils ne sont pas pris en charge derrière un réseau virtuel, et certains atteignent leur destination sur l’Internet public plutôt que sur votre réseau privé. Avant de vous engager dans une configuration isolée, vérifiez les outils de l’agent avec isolation réseau pour vérifier que les outils utilisés par vos agents sont pris en charge.
Planifier la taille de votre sous-réseau
Le sous-réseau doit être au moins en /27, et vous ne pouvez pas en modifier la taille après l’avoir attribué ; dimensionnez-le donc en fonction de l’échelle prévue. Tous les projets du compte Foundry partagent le sous-réseau. Prévoyez donc l’utilisation combinée de chaque projet, agent et session simultanée dans le compte.
- Les agents hébergés s’exécutent dans des bacs à sable isolés de machine virtuelle par session. Leur capacité de session planifiée dépend de la taille du sous-réseau délégué. Les composants réseau au niveau du Project et l’infrastructure temporaire pendant les mises à niveau consomment également des adresses.
- Les agents de prompt n’utilisent pas d’adresse IP par révision. Ils utilisent un petit pool statique d’adresses IP (jusqu’à environ 10 par projet), quel que soit le nombre d’agents d’invite ou de révisions que vous exécutez.
| Taille du sous-réseau | Recommendation |
|---|---|
| /27 | Minimum pris en charge. Vérifiez que la capacité de session hébergée planifiée, les exigences de mise en réseau au niveau du Project et la marge pour les mises à niveau répondent aux besoins de votre charge de travail. |
| /24 ou plus | Point de départ recommandé pour les charges de travail de production avec une forte demande cumulée en adresses IP sur plusieurs projets ou lors des mises à niveau. Ne augmente pas votre quota de session. |
Les quotas de session s’appliquent séparément de la capacité de sous-réseau planifiée. Pour les capacités de session hébergée planifiées par taille de sous-réseau, consultez la taille du sous-réseau et les sessions simultanées.
Agents hébergés par rapport aux agents de requête
L’option de mise en réseau s’applique à votre compte Foundry entier, mais les deux types d’agents consomment différemment les ressources réseau, comme décrit dans Planifier la taille de votre sous-réseau. Les deux types atteignent vos ressources via des points de terminaison privés dans votre réseau virtuel.
Étapes suivantes
- Déployez l’option avec la procédure d’installation ou le modèle du tableau.
- Validez le déploiement : confirmez la délégation de sous-réseau, que l’accès public est désactivé et que les points de terminaison sont résolus en adresses IP privées à partir du réseau virtuel. Consultez Vérifier le déploiement.
- Résolvez les erreurs de déploiement ou de connectivité avec le guide de résolution des problèmes.