Foundry 代理服務的網路選項

Microsoft Foundry Agent Service 支援多種網路選項,從完全公開的快速原型設計,到在自己的虛擬網路內完全隔離網路。 本文比較這些選項,將每個選項對應到共同目標,並指引你參考所選方案的部署範本與設定指南。

選擇選項後,依照連結的說明部署,然後驗證部署。 遇到問題時,請參考連結的故障排除指南。

預設網路行為

當你建立一個沒有任何網路設定的 Foundry 資源時,你會得到一個完全公開的基線:

  • 輸入:可透過公用網際網路連線至 Foundry 端點。 任何擁有有效憑證和端點網址的呼叫者都能撥到它。
  • 輸出:Agent 透過公用網路存取您的資料和 Azure 資源,且只能連線至可從網際網路存取的端點。
  • 儲存體:Agent 狀態預設使用 Microsoft 管理的儲存體。 如果你自備儲存裝置和其他 Azure 資源,就要在網路設定中設定對這些資源的網路存取。

在你選擇下一部分選項之前,沒有什麼是私人的。 每個選項會改變進站側、出站側,或兩者兼有。

網路功能選項

網路配置結合了兩個相關的決策:

  • 輸出 (egress) 存取:Agent 存取您的資料和其他 Azure 資源的方式。 這個決定決定了主要的隔離方式:保持出口公開,或限制在虛擬網路中,讓流量只留在你的私人網路上。 虛擬網路可以是由您自行提供並管理的網路(BYO 虛擬網路),也可以是由 Microsoft 為您管理的網路。
  • 輸入存取:哪些網路可以連線至您的 Foundry 端點。 可以選擇公開(可選擇限制於特定 IP 位址)或透過私有端點私有。

這兩個判決是相互關聯的。 當你在虛擬網路中隔離出口時,對 Foundry 端點的入站存取也會經過私有端點,因為該虛擬網路中的資源是透過私有網路到達端點的。 從出口模型開始,因為這個選擇決定了隔離度以及你可用的入站選項。 下表展示了三種出口模型及其可用的入站選項。

出口模型 輸入選擇 最適合用於
公用輸出 公有(可選的 IP 位址),或是虛擬網路中的私有端點 沒有出口隔離。 使用公開入站來進行原型設計和測試,或使用私人端點限制來電者,而出口則保持公開。
BYO 虛擬網路 虛擬網路中的私有端點 完全隔離的環境,可讓您控制 IP 範圍、對等互連和路由。 代理程式會部署到由你委派並管理的子網路中。
受控虛擬網路 虛擬網路中的私有端點 完全隔離,不用管理 IP 範圍,或是當 IP 空間重疊時。 代理程式運行於 Microsoft 管理的虛擬網路中。

在使用公開輸出時,新增私人端點只能保護輸入路徑:呼叫端可私下存取 Foundry 端點,但代理程式的輸出流量不會被隔離。

透過 BYO 虛擬網路,您可以自帶資料資源或使用平台管理的資料資源。 欲了解更多資訊,請參閱 「自帶虛擬網路需求」。

Note

網路隔離適用於 Foundry 帳戶和專案層級。 它涵蓋託管代理、提示代理以及帳戶中其他 Foundry 資源。 這兩種代理在隔離環境中對網路資源的消耗不同。 詳情請參閱「 Foundry Agent Service 網絡深度探討」。

依情境分類的網路選項

下表將常見目標對應到推薦選項與部署範本。 基礎結構即程式碼範本位於 Foundry 範例基礎結構設定存放庫 (Bicep,含 Terraform 鏡像)。

您的目標 推薦的選項 使用 部署
最快打造出可正常運作代理程式的路徑,無需隔離 公開,由 Microsoft 管理的儲存 部署第一個託管 Agent 快速入門 (Azure Developer CLI 或 VS Code)
將代理資料放在你自己的 Azure 資源中,避免隔離 公用,自備儲存體(標準) 41-standard-agent-setup
限制可呼叫該端點的對象,公用對外連線是可接受的 具有私人端點的公用輸出 10-private-network-basic
完全隔離且沒有公共出口,你控制網路,並想帶回自己的資料資源 含「自備資料」的 BYO 虛擬網路 (網路保護標準) 15-private-network-standard-agent-setup
完全隔離且沒有公共出口,你控制網路但不想管理資料資源 具備平台管理資料資源的 BYO 虛擬網路 11-private-network-basic-vnet
完全隔離,但你無法管理 IP 範圍,或你的 IP 位址空間發生重疊 受管理的虛擬網路 18-managed-virtual-network
API 閘道後的完整隔離 在 Azure API 管理中自備虛擬網路 (BYO) 16-private-network-standard-agent-apim-setup
從代理者存取本地資源 BYO 虛擬網路,以及 VPN 或 ExpressRoute 15-private-network-standard-agent-setup 加上「存取內部部署資源」

完整範本目錄及各範本提供的內容,請參考 基礎架構設定 README。

自備虛擬網路需求

BYO 虛擬網路與受控虛擬網路皆提供完整隔離。 差別在於誰在管理網路:在管理虛擬網路中,Microsoft 會幫你處理這部分的需求。 當你想完整掌控自己已在管理的網路時,請選擇 BYO 虛擬網路——由你自行掌控自己的 IP 範圍、防火牆、對等互連和路由。

選擇 BYO 虛擬網路時,請在部署前先規劃這些需求。 設定教學和深入探討涵蓋了這些問題。

  • 一個專門且受委託的子網。 將一個子網路委派給 Microsoft.App/environments。 子網路不能被多個 Foundry 資源共享。 依你預期的比例來調整尺寸;請參見 「規劃您的子網大小」。
  • 僅使用受支援的 RFC 1918 或 RFC 6598 位址空間。 對於 RFC 1918,請使用位於 10.0.0.0/8、 172.16.0.0/12或 192.168.0.0/16內的位址。 對於 RFC 6598(CGNAT),請使用 100.64.0.0/10 內的位址,但不包括 100.100.0.0/17、100.100.192.0/19 和 100.100.224.0/19。 不支援公共 IP 範圍。
  • 你選擇的資料資源。 使用 BYO 虛擬網路時,您可以選擇代理資料資源(Azure 儲存體、Foundry IQ(Azure AI 搜尋服務)以及 Azure Cosmos DB)的提供方式:
    • 平台管理的資料資源。 使用多租戶、平台管理的資料資源,避免攜帶或設定自己的資源。 當您的代理不需要客戶管理的資料資源時(例如許多託管代理情境),或是想避免像 Azure Cosmos DB 這類資源的容量規劃時,請選擇此選項。 這個選項省去了設定你不用的資料資源的需求。
    • 自備資料資源。 請使用您自己的 Azure 儲存體、Foundry IQ 和 Azure Cosmos DB,確保所有代理資料都留在您的租戶中。 當你需要在自己擁有和管理的資源中取得代理資料時,選擇此選項。
  • 為 Foundry 帳戶以及您自備的每個資料資源設定私人端點和私人 DNS 區域,讓名稱解析保持在虛擬網路內。
  • Foundry 資源和虛擬網路的區域相同。 其他資源可能分布在不同區域,並影響跨區域成本。

Important

建立 Foundry 帳號時,請設定虛擬網路設定。 網路注入是建立資源流程的一部分,不能新增到現有帳號。 網路設定會在你建立第一個託管代理時生效,之後無法更改網路注入。 若要切換到不同的網路配置,請建立新專案。 此設定會套用至帳戶層級,因此同時涵蓋託管代理程式和提示代理程式。 在建立帳號前,先決定是否使用 BYO 虛擬網路。

如需查看 BYO 虛擬網路選項的拓撲圖——包括委派子網路、託管代理程式 Micro VM,以及您資料資源的私人端點——請參閱 Foundry Agent Service 網路功能深入解析。

具備網路隔離功能的工具支援

並非所有代理工具都支援網路隔離。 有些工具不支援虛擬網路,有些則是透過公共網際網路而非你的私人網路抵達目的地。 在你決定採用隔離設置之前,先檢查 具備網路隔離功能的代理工具 ,確認代理所用的工具是否被支援。

規劃你的子網大小

子網必須至少是 /27,且指派後無法更改大小,所以請依你預期的規模來調整。 Foundry 帳號中的所有專案共用子網路,因此請規劃每個專案、代理程式和並行會話的合併使用情況。

  • 託管 Agent 會在每個工作階段各自以 VM 隔離的沙箱中執行。 其預定的會話容量取決於被委派的子網路大小。 升級期間的 Project 層級網路元件與臨時基礎架構也會消耗位址。
  • 提示代理 不會為每個修訂版本各自消耗一個 IP 位址。 它們會使用一個小型、靜態的 IP 位址池(每個專案最多約 10 個),不管你執行多少提示代理或版本。
子網大小 Recommendation
/27 支援的最低值。 確認預定的託管工作階段容量、專案層級網路需求及升級空間是否符合您的工作負載需求。
/24或更大 適合跨專案或升級期間合計 IP 需求龐大的生產工作負載,建議以此為起點。 不會增加您的工作階段配額。

會話配額與預定子網路容量是分開適用的。 有關依子網路大小規劃的託管工作階段容量,請參閱 子網路大小與同時工作階段。

託管代理與即時代理的比較

網路選項適用於整個 Foundry 帳戶,但兩種代理人員的網路資源消耗方式不同,詳見 「規劃你的子網大小」。 這兩種方式都是透過虛擬網路中的私有端點抵達你的資源。

下一步

  1. 請使用設定操作說明或表格中的範本部署該選項。
  2. 驗證 部署:確認子網路委派、公開存取已停用,以及端點是否從虛擬網路內部解析為私人 IP 位址。 請參閱 確認部署。
  3. 排解部署或連線錯誤時,可參考疑難排解指南。