AgentCore 的考量事項建立 AgentCore 的介面端點為您的介面端點建立端點政策

使用介面 VPC 端點 (AWS PrivateLink) 在 VPC 和 Amazon Bedrock AgentCore 資源之間建立私有連線

您可以使用 AWS PrivateLink 在 VPC 和 Amazon Bedrock AgentCore 之間建立私有連線。您可以像在 VPC 中一樣存取 AgentCore，無需使用網際網路閘道、NAT 裝置、VPN 連接或 Direct Connect 連接。VPC 中的執行個體不需要公有 IP 地址即可存取 AgentCore。

您可以透過建立由 AWS PrivateLink 提供支援的介面端點 來建立此私有連線。我們會在您為介面端點啟用的每個子網中建立端點網路介面。這些是請求者管理的網路介面，可做為目的地為 AgentCore 之流量的進入點。

如需詳細資訊，請參閱《 AWS PrivateLink 指南》中的透過 PrivateLink 存取 AWS 服務。 AWS PrivateLink

AgentCore 的考量事項

在您設定 AgentCore 的介面端點之前，請檢閱 AWS PrivateLink 指南中的考量事項。

AgentCore 提供三個 AWS PrivateLink 端點：

資料平面端點 - com.amazonaws.region.bedrock-agentcore
控制平面端點 - com.amazonaws.region.bedrock-agentcore-control
閘道端點 - com.amazonaws.region.bedrock-agentcore.gateway

下表顯示每個 AgentCore 基本的 AWS PrivateLink 支援狀態：

基本	資料平面	控制平面
執行時期	支援	支援
記憶體	支援	支援
內建工具（程式碼解譯器、瀏覽器工具）	支援	支援
Identity	支援	支援
閘道	支援	支援
評估和最佳化	支援	支援
政策	支援	支援

如需可使用 AgentCore 介面端點 AWS 的區域清單，請參閱支援 AWS 的區域。

重要

資料平面 APIs 支援 AWS Signature 第 4 版 (SigV4) 標頭進行身分驗證和 Bearer Token (OAuth) 身分驗證。VPC 端點政策只能根據 IAM 主體而非 OAuth 使用者來限制發起人。若要讓以 OAuth 為基礎的請求透過 VPC 端點成功，委託人必須在端點政策中設定為 *。否則，只有 SigV4 允許清單的呼叫者可以透過 VPC 端點成功呼叫。

AWS 支援 IAM 全域條件內容索引鍵。根據預設，允許透過界面端點完整存取 AgentCore。您可以將端點政策連接至介面端點，或建立安全群組與端點網路介面的關聯，以控制存取。

建立 AgentCore 的介面端點

您可以使用 Amazon VPC 主控台或 AWS 命令列界面 (AWS CLI) 來建立 AgentCore 的界面端點。如需詳細資訊，請參閱 AWS PrivateLink 指南中的建立介面端點。

使用下列服務名稱格式建立 AgentCore 的介面端點：

所有資料平面基本概念（執行期、內建工具、記憶體、身分）： com.amazonaws.region.bedrock-agentcore
針對 AgentCore Gateway： com.amazonaws.region.bedrock-agentcore.gateway
對於控制平面操作（執行期和記憶體管理）： com.amazonaws.region.bedrock-agentcore-control

如果您為介面端點啟用私有 DNS，您可以使用其預設的區域 DNS 名稱向 AgentCore 提出 API 請求。例如 bedrock-agentcore.us-east-1.amazonaws.com。

為您的介面端點建立端點政策

端點政策為 IAM 資源，您可將其連接至介面端點。預設端點政策允許透過介面端點完整存取 AgentCore。若要控制允許從您的 VPC 存取 AgentCore，請將自訂端點政策連接至介面端點。

端點政策會指定以下資訊：

可執行動作的主體 (AWS 帳戶、IAM 使用者和 IAM 角色）。
- 對於 AgentCore Gateway，如果您的閘道輸入不是以 AWS Signature 第 4 版 (SigV4) 為基礎的（例如，如果您改用 OAuth)，您必須將 Principal 欄位指定為萬用字元 * 。SigV4 型身分驗證可讓您將 Principal 定義為特定 AWS 身分。這也適用於 AgentCore 執行期。
可執行的動作。
可供執行動作的資源。

如需詳細資訊，請參閱《 AWS PrivateLink 指南》中的使用端點政策控制對服務的存取。

各種基本概念的端點政策

下列範例顯示不同 AgentCore 元件的端點政策：

範例

Runtime

下列端點政策允許特定 IAM 主體叫用代理程式執行期資源。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:user/USERNAME"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/RUNTIME_ID"
      }
   ]
}

混合 IAM 和 OAuth 身分驗證

InvokeAgentRuntime API 支援兩種 VPC 端點授權模式。下列範例政策允許 IAM 主體和 OAuth 發起人存取不同的客服人員執行期資源。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/customAgent1"
      },
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:runtime/customAgent2"
      }
   ]
}

上述政策僅允許 IAM 主體InvokeAgentRuntime呼叫 customAgent1 。它還允許 IAM 主體和 OAuth 發起人對進行InvokeAgentRuntime呼叫customAgent2。

受保護的資源中繼資料 (PRM) 端點政策

GetRuntimeProtectedResourceMetadata API 實作 OAuth 2.0 受保護的資源中繼資料 (RFC 9728)。用戶端會在擁有登入資料之前呼叫此端點，以探索哪個授權伺服器可保護指定的代理程式執行時間。此端點透過設計未經驗證，因此Principal必須在端點政策中將設定為 *。

VPC 端點政策會強制執行於 PRM 請求。如果您的端點政策未明確允許 bedrock-agentcore:GetRuntimeProtectedResourceMetadata ，則 HTTP 403 會拒絕透過該端點提出的 PRM 請求。任何透過 VPC 端點存取的 OAuth 設定代理程式執行期，都需要對 FTP 存取以進行授權伺服器探索。

注意

如果您有資料周邊強制執行的拒絕所有端點政策，且未使用 OAuth 或 JWT 身分驗證，則會自動拒絕 PRM 請求。不需要額外的組態。

下列端點政策允許任何發起人探索授權伺服器 (PRM)，同時將執行時間調用限制為特定 IAM 主體：


{
   "Statement": [
      {
         "Sid": "AllowPRMDiscovery",
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "AllowInvoke",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/RUNTIME_ID"
      }
   ]
}

若要封鎖透過 VPC 端點（資料周邊強制執行）的跨帳戶 DHCP 查詢，請將 MOST 允許陳述式範圍限定為僅限您帳戶的執行時間：


{
   "Statement": [
      {
         "Sid": "AllowPRMOwnAccountOnly",
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "DenyCrossAccountPRM",
         "Effect": "Deny",
         "Principal": "*",
         "Action": [
            "bedrock-agentcore:GetRuntimeProtectedResourceMetadata"
         ],
         "NotResource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      },
      {
         "Sid": "AllowInvoke",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeAgentRuntime"
         ],
         "Resource": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:runtime/*"
      }
   ]
}

Code Interpreter Tool

下列端點政策允許特定 IAM 主體叫用 Code Interpreter 資源。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:InvokeCodeInterpreter"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:code-interpreter/CODE_INTERPRETER_ID"
      }
   ]
}

Memory

======= 所有資料平面操作

下列端點政策允許特定 IAM 主體存取特定 AgentCore 記憶體的 us-east-1 資料平面操作。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent",
            "bedrock-agentcore:DeleteEvent",
            "bedrock-agentcore:GetEvent",
            "bedrock-agentcore:ListEvents",
            "bedrock-agentcore:DeleteMemoryRecord",
            "bedrock-agentcore:GetMemoryRecord",
            "bedrock-agentcore:ListMemoryRecords",
            "bedrock-agentcore:RetrieveMemoryRecords",
            "bedrock-agentcore:ListActors",
            "bedrock-agentcore:ListSessions",
            "bedrock-agentcore:BatchCreateMemoryRecords",
            "bedrock-agentcore:BatchDeleteMemoryRecords",
            "bedrock-agentcore:BatchUpdateMemoryRecords"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/MEMORY_ID"
      }
   ]
}

存取所有記憶體

下列端點政策允許特定 IAM 主體存取所有記憶體。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent",
            "bedrock-agentcore:DeleteEvent",
            "bedrock-agentcore:GetEvent",
            "bedrock-agentcore:ListEvents",
            "bedrock-agentcore:DeleteMemoryRecord",
            "bedrock-agentcore:GetMemoryRecord",
            "bedrock-agentcore:ListMemoryRecords",
            "bedrock-agentcore:RetrieveMemoryRecords",
            "bedrock-agentcore:ListActors",
            "bedrock-agentcore:ListSessions",
            "bedrock-agentcore:BatchCreateMemoryRecords",
            "bedrock-agentcore:BatchDeleteMemoryRecords",
            "bedrock-agentcore:BatchUpdateMemoryRecords"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/*"
      }
   ]
}

APIs存取限制

下列端點政策授予特定 IAM 主體在特定 AgentCore 記憶體資源中建立事件的許可。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvent"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:memory/MEMORY_ID"
      }
   ]
}

Browser Tool

下列端點政策允許特定 IAM 主體連線到瀏覽器工具資源。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws::iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:ConnectBrowserAutomationStream"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1:ACCOUNT_ID:browser/BROWSER_ID"
      }
   ]
}

Gateway

以下是自訂端點政策的範例。當您將此政策連接到介面端點時，它允許所有主體叫用 Resource 欄位中指定的閘道。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "bedrock:InvokeGateway"
         ],
         "Resource": "arn:aws::bedrock-agentcore:us-east-1::gateway/my-gateway"
      }
   ]
}

Identity

下列端點政策允許存取 Identity 資源。


{
   "Statement": [
      {
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
            "*"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:workload-identity-directory/default/workload-identity/WORKLOAD_IDENTITY_ID"
      }
   ]
}

Evaluations and Optimizations

下列端點政策允許特定 IAM 主體存取評估和最佳化操作。


{
   "Statement": [
      {
         "Sid": "AllowBatchEvaluations",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:StartBatchEvaluation",
            "bedrock-agentcore:GetBatchEvaluation",
            "bedrock-agentcore:ListBatchEvaluations",
            "bedrock-agentcore:StopBatchEvaluation",
            "bedrock-agentcore:DeleteBatchEvaluation"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:batch-evaluate/*"
      },
      {
         "Sid": "AllowRecommendations",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:StartRecommendation",
            "bedrock-agentcore:GetRecommendation",
            "bedrock-agentcore:ListRecommendations",
            "bedrock-agentcore:DeleteRecommendation"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:recommendation/*"
      },
      {
         "Sid": "AllowEvaluators",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateEvaluator",
            "bedrock-agentcore:GetEvaluator",
            "bedrock-agentcore:ListEvaluators",
            "bedrock-agentcore:UpdateEvaluator",
            "bedrock-agentcore:DeleteEvaluator"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:evaluator/*"
      },
      {
         "Sid": "AllowOnlineEvaluationConfigs",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateOnlineEvaluationConfig",
            "bedrock-agentcore:GetOnlineEvaluationConfig",
            "bedrock-agentcore:ListOnlineEvaluationConfigs",
            "bedrock-agentcore:UpdateOnlineEvaluationConfig",
            "bedrock-agentcore:DeleteOnlineEvaluationConfig"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:online-evaluation-config/*"
      },
      {
         "Sid": "AllowABTests",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateABTest",
            "bedrock-agentcore:GetABTest",
            "bedrock-agentcore:ListABTests",
            "bedrock-agentcore:UpdateABTest",
            "bedrock-agentcore:DeleteABTest"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:ab-test/*"
      },
      {
         "Sid": "AllowConfigurationBundles",
         "Effect": "Allow",
         "Principal": {
            "AWS": "arn:aws:iam::ACCOUNT_ID:root"
         },
         "Action": [
            "bedrock-agentcore:CreateConfigurationBundle",
            "bedrock-agentcore:GetConfigurationBundle",
            "bedrock-agentcore:GetConfigurationBundleVersion",
            "bedrock-agentcore:ListConfigurationBundles",
            "bedrock-agentcore:ListConfigurationBundleVersions",
            "bedrock-agentcore:UpdateConfigurationBundle",
            "bedrock-agentcore:DeleteConfigurationBundle"
         ],
         "Resource": "arn:aws:bedrock-agentcore:us-east-1:ACCOUNT_ID:configuration-bundle/*"
      }
   ]
}

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

VPC 和 AWS PrivateLink

設定閘道 VPC 輸出