設定您的環境

透過 Foundry Agent Service 建立您的第一位經紀人是一個兩步驟的過程：

1. 設定代理人環境。
2. 你可以使用你選擇的 SDK 或 Azure Foundry 入口網站來建立並配置你的代理程式。

使用本文深入瞭解如何設定代理程序環境。

所需權限

設定代理程序環境

要開始，你需要一個 Microsoft Foundry 資源和一個 Foundry 專案。
代理程式會在特定專案內建立，而每個專案都會做為隔離的工作區。 也就是說：

• 相同專案中的所有代理程式都會共用相同檔案記憶體、線程記憶體（交談歷程記錄）和搜尋索引的存取權。
• 數據會在項目之間隔離。 某個專案中的代理程式無法從另一個專案存取資源。 專案目前是 Foundry 中共用和隔離的單位。 如需 Foundry 專案的詳細資訊，請參閱 什麼是 AI Foundry 文章。

先決條件

• Azure 訂用帳戶 - 建立免費帳戶。
• 確定建立帳戶和項目的個人在訂用帳戶範圍內具有 Azure AI 帳戶擁有者 角色
• 如果設定 標準設定，相同的個人也必須具有將角色指派給必要資源的許可權（Cosmos DB、Azure AI 搜尋服務、Azure Blob 記憶體）。 欲了解更多關於 RBAC 角色，特別是針對代理服務的資訊，請參閱代理服務 RBAC 角色。
  • 所需的內建角色是 角色型存取管理員。
  • 或者，在訂用帳戶層級擁有 擁有者 角色也符合這項需求。
  • 所需的金鑰限如下： Microsoft.Authorization/roleAssignments/write

選擇您的設定

代理服務提供三種環境配置模式以滿足不同需求：

• 基本設定：

  此設定與 OpenAI Assistants 相容，並使用平臺的內建記憶體管理代理程序狀態。 它包含與小幫手 API 相同的工具和功能，並新增了非 OpenAI 模型和工具的支援，例如 Azure AI 搜尋和 Bing。

• 標準設定：

  包含基本設置以及對您資料的精細控制，讓您可以使用自己的 Azure 資源。 所有客戶數據，包括檔案、線程和向量存放區，都會儲存在您自己的 Azure 資源中，為您提供完整的擁有權和控制權。

• 使用自備 (BYO) 虛擬網路進行標準設定：

  在標準設定中包含所有內容，並增加了完全在您自己的虛擬網路內執行的能力。 此設定支援「攜帶您自己的虛擬網路」（BYO 虛擬網路），允許嚴格控制數據移動，並藉由將流量限制在您的網路環境中，協助防止數據外流。

比較設定選項

部署選項

若要自定義這些範本，請參閱 使用您自己的資源。

如果您想要支援私有網路隔離，請參閱 網路安全設置 ，以取得如何攜帶您自己的虛擬網路的詳細資訊。

描述和自動部署	圖表（按兩下以放大）
部署使用 受控識別 進行驗證的基本代理程序設定。 系統會建立帳戶和專案。 已部署 GPT-4o 模型。 預設會使用Microsoft管理的Key Vault。
部署使用 受控識別 進行驗證的標準代理程序設定。 系統會建立帳戶和專案。 已部署 GPT-4o 模型。 儲存客戶數據的 Azure 資源 - Azure 記憶體、 Azure Cosmos DB 和 Azure AI 搜尋 - 如果未提供現有的資源，則會自動建立。 這些資源會連線到您的專案，以儲存檔案、線程和向量數據。 預設會使用Microsoft管理的Key Vault。

[選擇性]自動部署範本中的模型選取

您可以編輯自動部署範本中的模型參數，以自訂代理程式所使用的模型。 若要部署不同的模型，您必須至少更新 modelName 和 modelVersion 參數。

根據預設，部署範本會使用下列值進行設定：

接下來會發生什麼？

• 深入瞭解：
  • 使用現有的資源
  • 網路安全代理程式設定