View a markdown version of this page

使用主控台開始使用執行個體 - Amazon Bedrock AgentCore
步驟 1：建立容量提供者步驟 2：建立使用容量提供者的代理程式執行期步驟 3：叫用和監控步驟 4：清理後續步驟

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用主控台開始使用執行個體

本教學課程會逐步解說如何使用 AWS 管理主控台在執行個體運算類型上託管 代理程式。您首先建立定義 EC2 基礎設施的容量提供者，然後建立使用該基礎設施的代理程式執行期，最後叫用和監控代理程式。

如需先決條件，請參閱開始使用執行個體。

步驟 1：建立容量提供者

  1. 開啟 Amazon Bedrock AgentCore 主控台，然後選擇執行期。

  2. 在容量提供者索引標籤上，選擇建立容量提供者。

  3. 在容量提供者詳細資訊下，輸入名稱。有效字元為字母、數字和底線；名稱必須以字母開頭，最多可有 48 個字元。

  4. 針對作業系統，選擇 EC2 執行個體的作業系統 （例如 Linux (64 位元 x86))。這會決定哪些軟體和應用程式與您的環境相容。

  5. 針對允許的執行個體類型，選擇最多 30 種符合您工作負載需求的 EC2 執行個體類型。依 vCPU、記憶體和 CPU 製造商篩選以尋找相符項目。

  6. 在安全性下，選擇控制執行個體網路存取的 VPC。或者，在其他詳細資訊下設定子網路和容器網路模式。

  7. （選用） 在儲存組態下，選擇新增磁碟區以連接持久性儲存的 Amazon EBS 磁碟區。設定磁碟區類型、大小、輸送量、IOPS 和加密。這會儲存磁碟區組態；AgentCore 會在工作階段第一次啟動時建立每個磁碟區。

  8. 在服務存取下，選擇連接至 EC2 執行個體的執行個體描述檔 (AgentCore 用來收集系統日誌；它不會授予代理程式程式碼的許可） 和基礎設施角色 (AgentCore 用來代表您管理 EC2 執行個體）。您可以使用現有的角色，或讓主控台建立新的角色。

  9. 選擇建立容量提供者。容量提供者會開始處於 CREATING 狀態，並在驗證其組態ACTIVE後變成 。

注意

建立容量提供者之後，只能編輯其描述。若要變更其他組態，例如執行個體類型、聯網或儲存，請複製容量提供者，並在重複的流程中進行更新。

步驟 2：建立使用容量提供者的代理程式執行期

  1. 在執行時間頁面上，選擇建立執行時間 （或從容量提供者的詳細資訊頁面，選擇主機代理程式/工具)。

  2. 輸入代理程式或工具的名稱。

  3. 針對運算類型，選擇執行個體。

  4. 針對容量提供者，選擇現有的容量提供者，或選擇快速建立以內嵌預先設定的預設建立。

  5. 在代理程式/工具來源下，選擇來源類型並提供成品：

    • S3 來源 – 從範本開始、上傳.zip檔案，或選擇 S3 儲存貯體中的現有物件。

    • ECR 容器 – 提供 Amazon ECR 容器映像 URI。

  6. （選用） 設定傳入身分驗證、進階組態 （安全性、環境變數） 和許可 (IAM 執行角色和 KMS 加密）。

  7. 選擇建立執行時間。AgentCore 會建立版本 1 和指向它的DEFAULT端點。

注意

您無法在建立執行時間後變更運算類型。

步驟 3：叫用和監控

  1. 從執行時間的詳細資訊頁面，選擇測試並提供承載，或使用檢視調用程式碼片段從您自己的應用程式呼叫代理程式。

  2. 新工作階段的第一次調用會在您的帳戶中佈建 EC2 執行個體並啟動代理程式，因此通常需要比稍後的調用更長的時間。對相同工作階段的後續叫用速度快得多。AgentCore 會將執行個體佈建為 Amazon EC2 受管執行個體，這會從您的 EC2 主控台檢視和DescribeInstances預設情況下隱藏。如需受管執行個體可見性的詳細資訊，請參閱 受管資源可見性設定。

  3. 使用執行時間詳細資訊頁面上的可觀測性指標和日誌和追蹤，來監控工作階段、調用、錯誤率和資源消耗。

步驟 4：清理

為了避免您帳戶中佈建的 Amazon EC2 執行個體和 Amazon EBS 磁碟區持續產生費用，請在完成時清除您為此教學課程建立的資源：

  1. 刪除工作階段，以便 AgentCore 取消佈建 EC2 執行個體及其持久性磁碟區。在工作階段上停止單一代理程式執行時間並不會終止執行個體。如需 API 操作的詳細資訊，請參閱使用 CLI 或 SDK AWS 開始使用執行個體。

  2. 刪除執行時間、其端點或其版本，以取消執行時間與容量提供者的關聯。

  3. 在沒有執行時間參考時刪除容量提供者。

後續步驟