Microsoft Entra Agent ID 主要概念

代理身份讓 AI 代理能對 API 及其他資源進行驗證。 其代理程式身份藍圖儲存驗證設定與憑證,而代理程式身份則接收資源存取權。 例如,一個讀取受保護 API 的代理程式需要藍圖、代理程式身分,以及呼叫該 API 的權限。

本文說明這些物件、管理它們的人,以及您在設定過程中記錄的識別碼。 您不需要建立此處描述的每一個物件:請依照選擇代理程式整合路徑來因應您的情境。

代理程式身份藍圖定義了一個或多個代理程式身份的設定。 在多執行個體模式下,它提供個別子身分的範本。 在單一實例模式下,藍圖與其單一代理 ID 共用一個 OAuth 用戶端 ID,且不存在藍圖主體。

核心身份概念

以下概念構成了 Microsoft Entra Agent ID 及 Microsoft 代理身份平台的基礎。

代理人身份

代理身份是 AI 代理用來向系統認證及存取資源的主要身份。 憑證在需要時,會在藍圖上設定,而非在身份上。 多實例代理 ID 透過藍圖模擬身分來驗證身分。 單一實例代理 ID 會直接以共用用戶端 ID 請求權杖;公開客戶端不會寄送客戶端憑證。 欲了解更多資訊,請參閱 代理人身份。

代理身份藍圖

代理程式識別藍圖是 Microsoft Entra ID 中的一個物件,用來定義一個或多個代理程式身份的驗證設定及其他設定。 其 實例模式 決定了身份關係及代幣取得模式。 套用於藍圖的政策與設定(例如條件存取)會對其代理程式身份生效。 欲了解更多資訊,請參閱 代理人身份藍圖。

代理身份設計原則

多實例藍圖需要在租戶中有一個對應的藍圖主體。 受管理的建立體驗可以同時建立兩個物件,但透過 Microsoft Graph 建立藍圖並不會建立其主體身分。 當您自行佈建時,請遵循 建立代理程式藍圖主體。 此物件記錄藍圖在租戶中的存在,並使其能取得憑證並出現在稽核日誌中。 單一實例藍圖沒有藍圖主體身分。

傳統服務主體設計用於靜態、確定性工作負載。 Microsoft Entra Agent ID 存在,是因為服務主體缺乏 AI 代理所需的治理基礎設施。 沒有強制贊助、沒有代理知悉的審計條目,也沒有藍圖控管下的生命週期。 欲了解更多資訊,請參閱 代理身份、服務主體與應用程式。

一般的 Microsoft Entra 使用者帳號是為人工登入模式設計的。 將條件存取指派給 AI 代理會導致所有 零信任 強制層的失敗:為人類設計的條件存取政策無法正確套用於代理,ID Protection 偵測功能降低,身份治理程序也可能錯誤移除代理存取權限。 欲了解更多資訊,請參閱 規劃您的代理身份架構。

代理操作模式

代理身份平台支援以下代理運作與認證模式,每種模式服務不同的使用情境與安全需求。

互動代理

互動式代理代表已登入的使用者執行任務,通常透過聊天介面。 例如,分析客戶資料或回答支援相關問題。 委派權限會將存取範圍限制在授與用戶端的權限,以及使用者本身可存取的範圍內。 本機公開用戶端使用搭配 PKCE 的授權碼流程。 接收使用者令牌的託管代理 API 會利用代理(OBO)流程,以該使用者的身分呼叫下游 API。

自主代理程式

自主代理則以自身身份獨立運作,而非使用人類使用者的身份。 這些代理在背景運作,自行決策與執行行動,無需人工介入,例如監控網路日誌以進行安全操作、以自動擴展管理基礎設施部署,或處理排程維護任務。 自主代理直接使用代理身份及客戶憑證流程與 Microsoft Entra ID 平台進行認證。

代理人的使用者帳號

代理的使用者帳號是一個可選帳號,與代理身份一對一配對。 它依照人類使用者特性運作,包括持續身份及存取組織資源,如信箱、行事曆、Teams 頻道和文件。 只有當代理必須存取需要使用者物件的系統時,才使用代理的使用者帳號。 客服的使用者帳號不會取代客服身份——兩者都必須存在。 欲了解更多資訊,請參閱 代理的使用者帳號。

經紀人擁有者、贊助商與經理

代理身份平台引入了一套行政模式,將技術管理與業務責任分開,確保營運控制與合規監督,且不會獲得過多權限。 代理人的行政角色包括擁有者、經理及贊助人。

  • 擁有者 擔任代理程式的技術管理員,負責營運與設定相關事務。
  • 贊助人為 業務人員提供業務責任,在無需技術行政權限的情況下,做出生命週期決策。
  • 經理 是被指定為客服人員使用者帳戶的招聘經理或營運擁有者。

欲了解更多資訊,請參閱 代理人身份(所有者、贊助人及經理)的行政關係

Microsoft Entra ID Auth SDK (sidecar)

Microsoft Entra ID 認證 SDK(側車)是一個容器化的網路服務,負責為註冊於 Microsoft 身分識別平台 的代理進行憑證取得、驗證及保護下游 API 呼叫。 它會作為隨附容器與應用程式一起執行,可讓您將身分識別邏輯卸載至專用服務。 欲了解更多資訊,請參閱 Microsoft Entra ID Auth SDK (sidecar)。

記錄您情境的識別碼

完成設定時記錄這些數值。 只使用教學所需的列;你不需要建立這些資料表中的每一個物件。 應用程式(用戶端)ID 用來識別 OAuth 用戶端或資源。 物件 ID 用來識別一個租用戶中的一個目錄物件。 即使兩者都是 GUID,兩者也不能互換。

租戶與管理用戶端

管理用戶端負責佈建並設定所選租用戶中的身分識別。 它的用戶端 ID 並不是代理程式的執行時用戶端 ID。

代理程式識別碼 識別碼來源 必要操作或欄位
租戶識別碼 您的目錄中的 租戶 ID。 管理單位與租戶被管理要求所鎖定。
管理用戶端 ID 獨立管理應用程式的 應用程式(用戶端)ID。 Connect-MgGraph -ClientId。 這不是 agent 的執行時用戶端 ID。

Blueprint 與代理程式身分識別

使用物件 ID 進行目錄操作,並使用用戶端 ID 進行 OAuth 請求。 單一實例佈建使用藍圖物件 ID;叢集佈建使用其用戶端 ID。

代理程式識別碼識別碼 識別碼來源 必要的操作或欄位
藍圖物件 ID 在藍圖建立回應中的 id。 Microsoft Graph /applications/{id} 更新,包括憑證、重新導向 URI 及範圍。 單一執行例配置也會使用此值。agentIdentityBlueprintId
藍圖用戶端 ID appId 在藍圖建立回應中。 藍圖身分驗證及其 api:// 識別碼 URI。 Fleet 佈建將此值用於 agentIdentityBlueprintId。
藍圖主體識別物件 ID id 在藍圖主體建立回應中。 僅限艦隊情境。 在藍圖的租戶服務主體上進行操作,包括設定的權限繼承。 不要為單一執行個體代理建立此物件。
代理程式物件 ID id 位於代理程式身分識別建立回應中。 Microsoft Graph /servicePrincipals/{id}、指派作業,以及 oauth2PermissionGrants.clientId。 儘管該授權欄位名稱如此,它仍採用代理程式的服務主體物件 ID,而非 OAuth 用戶端 ID。
代理程式用戶端 ID appId 針對代理程式身分。 執行時 OAuth 請求。 雲端或本地單一實例代理程式會共享其藍圖的用戶端 ID;fleet identity 有獨立的用戶端 ID。

資源與權限

資源用戶端 ID 用來識別該 API。 權限授予會使用其服務主體物件 ID;範圍與角色 GUID 會識別該資源中的權限。

代理程式識別碼 識別碼來源 必要的操作或欄位
資源用戶端 ID 下游 API 應用程式的 appId. Token 受眾、範圍 URI,以及 requiredResourceAccess.resourceAppId。
資源服務主體物件 ID id 該 API 在授權租戶中的服務主體的物件識別碼。 resourceId 在權限授與中。 不要替換資源用戶端 ID。
委派範圍識別碼與值 API 的 oauth2PermissionScopes[].id 和 .value。 GUID 會放入許可聲明中;該值(例如 read_data)會放在範圍請求或委託授權中。
應用程式角色識別碼 資源的 appRoles[].id。 應用程式權限宣告與應用程式角色指派。

一般使用者與專用代理程式使用者

這兩個值都是目錄物件 ID,而非用戶端 ID。 專用的代理-使用者帳號並不會取代 OBO 請求中的人類使用者。

代理程式識別碼 識別碼來源 必要的操作或欄位
人類使用者物件識別碼 已登入使用者的目錄 id。 當程序需要使用者時,需取得使用者特定同意及擁有者或贊助者身分。
代理程式使用者物件識別碼 id 當您建立可選專用代理程式使用者時回傳。 專用代理程式-使用者操作,而非一般使用者 OBO 請求。

將憑證與此工作表分開保存。 切勿在原始碼控制或共用故障排除筆記中記錄存取權杖、用戶端密鑰、私鑰或 PFX 密碼。

下一步