Netwerkopties voor Foundry Agent Service

Microsoft Foundry Agent Service ondersteunt verschillende netwerkopties, van een volledig openbare installatie voor snelle prototypen om netwerkisolatie binnen uw eigen virtuele netwerk te voltooien. Dit artikel vergelijkt de opties, wijst elke optie toe aan algemene doelen en verwijst u naar de implementatiesjabloon en configuratiehandleiding voor de optie die u kiest.

Nadat u een optie hebt gekozen, volgt u de gekoppelde instructies om deze te implementeren en valideert u de implementatie. Als u problemen ondervindt, gebruikt u de gekoppelde richtlijnen voor probleemoplossing.

Standaard netwerkgedrag

Wanneer u een Foundry-resource maakt zonder netwerkconfiguratie, krijgt u een volledig openbare basislijn:

  • Inkomend verkeer: het Foundry-eindpunt is bereikbaar via het openbare internet. Elke aanroeper met een geldige referentie en de eindpunt-URL kan deze bereiken.
  • Uitgaand: agents bereiken uw gegevens en Azure resources via openbare netwerken en kunnen alleen eindpunten bereiken die toegankelijk zijn voor internet.
  • Opslag: de status van de agent maakt standaard gebruik van door Microsoft beheerde opslag. Als u uw eigen opslag en andere Azure resources gebruikt, configureert u netwerktoegang tot deze resources als onderdeel van uw netwerkinstallatie.

Er is niets privé totdat u een van de opties in de volgende sectie kiest. Elke optie wijzigt de binnenkomende zijde, de uitgaande zijde of beide.

Netwerkmogelijkheden

Een netwerkconfiguratie combineert twee gerelateerde beslissingen:

  • Uitgaande toegang (egress-verkeer): hoe uw agents uw gegevens en andere Azure-resources bereiken. Deze beslissing bepaalt de belangrijkste isolatie: uitgaand verkeer openbaar houden of beperken tot een virtueel netwerk, zodat verkeer op uw privénetwerk blijft. Het virtuele netwerk kan een netwerk zijn dat u brengt en beheert (BYO virtual network) of een Microsoft voor u beheert.
  • Inkomende toegang: welke netwerken uw Foundry-eindpunt kunnen bereiken. Openbaar (optioneel beperkt tot geselecteerde IP-adressen) of privé via een privé-eindpunt.

De twee beslissingen zijn verbonden. Wanneer u uitgaand verkeer in een virtueel netwerk isoleert, gaat binnenkomende toegang tot het Foundry-eindpunt ook via een privé-eindpunt, omdat de resources in dat virtuele netwerk het eindpunt bereiken via het privénetwerk. Begin met het uitgaande model, omdat die keuze isolatie en de binnenkomende opties bepaalt die voor u beschikbaar zijn. In de volgende tabel ziet u de drie uitgaande modellen en de beschikbare inkomende opties.

Uitgaand model Opties voor inkomend verkeer Ideaal voor
Publiek uitgaand verkeer Openbaar (optioneel geselecteerde IP-adressen) of een privé-eindpunt in uw virtuele netwerk Geen isolatie van uitgaand verkeer. Gebruik een openbaar inkomend eindpunt voor prototypes en tests, of een privé-eindpunt om de toegang te beperken terwijl uitgaand verkeer openbaar blijft.
BYO-virtueel netwerk Privé-eindpunt in uw virtuele netwerk Volledige isolatie waarbij u IP-bereiken, peering en routering beheert. Agents worden geïnjecteerd in een subnet dat u delegeert en beheert.
Beheerd virtueel netwerk Privé-eindpunt in uw virtuele netwerk Volledige isolatie zonder IP-bereiken te beheren of wanneer uw IP-ruimte overlapt. Agents worden uitgevoerd in een door Microsoft beheerd virtueel netwerk.

Bij openbaar uitgaand verkeer wordt met het toevoegen van een privé-eindpunt alleen het binnenkomende verkeer beveiligd: aanroepers hebben privétoegang tot het Foundry-eindpunt, maar de uitgaande verbindingen van agents worden niet geïsoleerd.

Met het virtuele BYO-netwerk kunt u uw eigen gegevensbronnen meenemen of gebruikmaken van door het platform beheerde gegevensbronnen. Zie vereisten voor het gebruik van uw eigen virtuele netwerk voor meer informatie.

Note

Netwerkisolatie is van toepassing op het niveau van het Foundry-account en het projectniveau. Het omvat gehoste agents, prompt-agenten en de overige Foundry-resources in het account. De twee agenttypen verbruiken netwerkbronnen anders binnen een geïsoleerde installatie. Zie Deep dive into Foundry Agent Service networking voor meer informatie.

Netwerkopties per scenario

In de volgende tabel worden algemene doelen toegewezen aan een aanbevolen optie en een implementatiesjabloon. De Infrastructure as Code-sjablonen staan in de Foundry samples-infrastructuurconfiguratie-repository (Bicep, met een Terraform-spiegel).

Uw doel Aanbevolen optie Uitrollen met
Snelste pad naar een werkende agent, geen isolatie Openbare, Microsoft beheerde opslag Implementeer de quickstart voor uw eerste gehoste agent (Azure Developer CLI of VS Code)
Agentgegevens in uw eigen Azure resources bewaren, geen isolatie Openbare, zelf meegebrachte opslag (standaard) 41-standard-agent-setup
Beperk wie het eindpunt mag aanroepen, openbare uitgaande verbindingen zijn toegestaan Openbare uitgaande verbinding met een privé-eindpunt 10-private-network-basic
Volledige isolatie zonder openbaar uitgaand verkeer, u beheert het netwerk en wilt uw eigen gegevensresources meenemen BYO-virtueel netwerk met zelf meegebrachte gegevensresources (netwerkbeveiligde standaard) 15-private-network-standard-agent-setup
Volledige isolatie zonder openbaar uitgaand verkeer, u beheert het netwerk, maar wilt geen gegevensresources beheren VIRTUEEL BYO-netwerk met door platform beheerde gegevensbronnen 11-private-network-basic-vnet
Volledige isolatie, maar u kunt geen IP-bereiken beheren of uw IP-adresruimte overlapt Beheerd virtueel netwerk 18-managed-virtual-network
Volledige isolatie achter een API-gateway VIRTUEEL BYO-netwerk met Azure API Management 16-private-network-standard-agent-apim-setup
Toegang krijgen tot on-premises-resources via agents BYO-virtueel netwerk met VPN of ExpressRoute 15-private-network-standard-agent-setup plus Toegang tot on-premises-resources

Zie de README voor het instellen van de infrastructuur voor de volledige sjablooncatalogus en wat elke sjabloon aanmaakt.

Vereisten voor bring-your-own virtual network

Zowel het virtuele BYO-netwerk als het beheerde virtuele netwerk bieden volledige isolatie. Het verschil is wie het netwerk beheert: met een beheerd virtueel netwerk neemt Microsoft de vereisten in deze sectie voor u voor zijn rekening. Kies een virtueel BYO-netwerk als u volledige controle wilt over een netwerk dat u al beheert: uw eigen IP-bereiken, firewalls, peering en routering.

Wanneer u een virtueel BYO-netwerk kiest, moet u deze vereisten plannen voordat u implementeert. De instructies voor de installatie en de diepgaande duik behandelen ze volledig.

  • Een toegewezen, gedelegeerd subnet. Een subnet delegeren aan Microsoft.App/environments. Het subnet kan niet worden gedeeld door meer dan één Foundry-resource. Pas de grootte aan voor de schaal die u verwacht; zie De grootte van uw subnet plannen.
  • Alleen RFC 1918- en RFC 6598-adresruimte. Gebruik in RFC 1918 alleen 10.0.0.0/8, 172.16.0.0/12of 192.168.0.0/16. Gebruik in RFC 6598 of bij CGNAT IP-adressen in het bereik 100.64.0.0/10, met uitzondering van 100.100.0.0/17, 100.100.192.0/19 en 100.100.224.0/19. Openbare IP-bereiken worden niet ondersteund.
  • Gebruik alleen ondersteunde RFC 1918- of RFC 6598-adresruimte. Gebruik voor RFC 1918 adressen binnen 10.0.0.0/8, 172.16.0.0/12of 192.168.0.0/16. Gebruik voor RFC 6598 (CGNAT) adressen binnen 100.64.0.0/10, exclusief 100.100.0.0/17, 100.100.192.0/19en 100.100.224.0/19. Openbare IP-bereiken worden niet ondersteund.
  • Uw keuze aan gegevensbronnen. Met een virtueel BYO-netwerk kiest u hoe agentgegevensbronnen (Azure Storage, Foundry IQ (Azure AI Zoeken) en Azure Cosmos DB) worden geleverd:
    • Door platform beheerde gegevensbronnen. Gebruik multitenant, platformbeheerde gegevensbronnen, zodat u uw eigen gegevensbronnen niet gebruikt of configureert. Kies deze optie wanneer uw agents geen door de klant beheerde gegevensbronnen nodig hebben, zoals veel scenario's voor gehoste agents, of wanneer u capaciteitsplanning wilt voorkomen voor resources zoals Azure Cosmos DB. Met deze optie hoeft u geen gegevensbronnen in te stellen die u niet gebruikt.
    • Resources voor het gebruik van uw eigen gegevens. Gebruik uw eigen Azure Storage, Foundry IQ en Azure Cosmos DB zodat alle agentgegevens in uw tenant blijven. Kies deze optie wanneer u agentgegevens nodig hebt in resources die u bezit en beheert.
  • Privé-eindpunten en Privé-DNS zones voor het Foundry-account, en voor elke gegevensresource die u meebrengt, blijft naamomzetting dus binnen het virtuele netwerk.
  • Dezelfde regio voor de Foundry-resource en het virtuele netwerk. Andere resources kunnen zich in verschillende regio's bevinden, met gevolgen voor kosten in meerdere regio's.

Important

Stel de configuratie van het virtuele netwerk in wanneer u het Foundry-account maakt. Netwerkinjectie maakt deel uit van het proces voor het maken van een resource en kan niet worden toegevoegd aan een bestaand account. De netwerkconfiguratie wordt van kracht wanneer u de eerste gehoste agent maakt en u kunt de netwerkinjectie daarna niet meer wijzigen. Als u naar een andere netwerkconfiguratie wilt gaan, maakt u nieuwe projecten. De configuratie is van toepassing op accountniveau, zodat deze zowel gehoste als promptagenten omvat. Beslis over een virtueel BYO-netwerk voordat u het account maakt.

Zie Deep dive into Foundry Agent Service networking voor een topologiediagram van de optie voor het BYO-virtuele netwerk: het gedelegeerde subnet, host-agent-micro-VM's en privé-eindpunten voor uw dataresources.

Ondersteuning voor tools met netwerkisolatie

Niet alle agenthulpprogramma's ondersteunen netwerkisolatie. Sommige hulpprogramma's worden niet ondersteund achter een virtueel netwerk en sommige bereiken hun bestemming via het openbare internet in plaats van uw privénetwerk. Voordat u een geïsoleerde installatie doorvoert, controleert u agenthulpprogramma's met netwerkisolatie om te controleren of de hulpprogramma's die door uw agents worden gebruikt, worden ondersteund.

De grootte van uw subnet plannen

Het subnet moet ten minste /27 zijn en u kunt de grootte niet wijzigen nadat u het hebt toegewezen, dus pas het aan voor de verwachte schaal. Alle projecten in het Foundry-account delen het subnet, dus plan het gecombineerde gebruik van elk project, elke agent en de gelijktijdige sessie in het account.

  • Gehoste agents worden per sessie uitgevoerd in VM-geïsoleerde sandboxen. De geplande sessiecapaciteit is afhankelijk van de grootte van het gedelegeerde subnet. Project-netwerkonderdelen en tijdelijke infrastructuur tijdens upgrades verbruiken ook IP-adressen.
  • Promptagenten verbruiken geen IP-adres per revisie. Ze gebruiken een kleine, statische groep IP-adressen (maximaal 10 per project), ongeacht het aantal promptagents of revisies dat u uitvoert.
Subnetgrootte Aanbeveling
/27 Minimaal ondersteund. Controleer of de geplande gehoste sessiecapaciteit, netwerkvereisten op projectniveau en upgrademarge voldoen aan de behoeften van uw workload.
/24 of groter Aanbevolen uitgangspunt voor productieworkloads met een aanzienlijke gecombineerde IP-vraag over meerdere projecten of tijdens upgrades. Verhoogt uw sessiequotum niet.

Sessiequota zijn afzonderlijk van geplande subnetcapaciteit van toepassing. Zie voor geplande gehoste sessiecapaciteiten per subnetgrootte Subnetgrootte en gelijktijdige sessies.

Gehoste agents vergeleken met prompt-agents

De netwerkoptie is van toepassing op uw hele Foundry-account, maar de twee agenttypen verbruiken netwerkresources anders, zoals beschreven in De grootte van uw subnet plannen. Beide typen bereiken uw resources via privé-eindpunten in uw virtuele netwerk.

Volgende stappen 

  1. Implementeer de optie met de handleiding voor het instellen of het sjabloon uit de tabel.
  2. Valideer de uitrol: controleer of subnetdelegering is ingesteld, of openbare toegang is uitgeschakeld en of eindpunten vanuit het virtuele netwerk naar privé-IP-adressen verwijzen. Zie De implementatie controleren.
  3. Los eventuele implementatie- of connectiviteitsfouten op met de gids voor probleemoplossing.