使用 Microsoft Foundry 搭配 Microsoft Entra Agent ID

Microsoft Foundry 內建支援 Microsoft Entra Agent ID。 Foundry 會建立並管理代理程式身份藍圖、代理程式 ID 及平台憑證。 您不需要新增用戶端密鑰或實作代理程式 ID 令牌交換。

請使用目前的 Foundry 代理物件模型來選擇加入此整合。 使用舊有模型的代理程式仍會使用共用專案識別碼或代理應用程式識別碼。

Prerequisites

  • 一個 Microsoft Foundry 專案。
  • 在專案中建立代理程式的權限。
  • 授權代理程式 ID 存取每個下游資源的權限。

使用 Agent ID 建立 Agent

使用目前的 Foundry 代理程式模型建立新的代理程式。 新代理人將獲得:

  • 獨特的代理人身份藍圖。
  • 其預設實例的唯一代理程式 ID。
  • 穩定的代理端點。
  • Foundry 用於代幣交換的平台管理聯合憑證。

請依照「設定並分享您的 Microsoft Foundry 代理程式」來建立並設定代理程式。

如果專案包含舊版代理程式,請從相同定義建立新代理程式。 Foundry 不會直接在舊版代理上新增唯一的代理 ID。 關於選擇加入與遷移步驟,請參閱「從代理程式應用程式遷移至新的 Microsoft Foundry 代理程式模型」。

驗證代理程式身份

擷取或檢查代理程式並確認該 instance_identity 不是 null。 非空值表示已依目前模型建立的代理程式。

Foundry 負責管理藍圖憑證與執行時權杖交換。 不要為 Foundry 管理的藍圖建立另一個認證。

有關 Foundry 所建立物件的詳細資訊,請參閱 Microsoft Foundry 中的代理程式身份概念。

授權存取資源

新的代理程式 ID 一開始沒有資源權限。 授予存取工具呼叫所使用的代理程式 ID:

  • 對於 Azure 資源,將最小權限的 Azure 角色分配到最窄的實際範圍。
  • 對於自訂 API,請指派所需的應用程式權限或應用程式角色。
  • 若要進行委派存取,請設定支援的使用者委派連線並取得同意。

當 Azure 角色指派需要主體 ID 時,請使用 Agent ID 的物件 ID,不要使用其用戶端 ID。

有關支援的工具與授權模型,請參閱 Microsoft Foundry 中的權限與存取邊界。