View a markdown version of this page

更新線上評估 - Amazon Bedrock AgentCore

更新線上評估

UpdateOnlineEvaluationConfig API 會修改現有的線上評估組態,讓您變更評估器、資料來源、執行設定和其他參數。此操作可智慧地處理更新,而不會中斷執行評估。

只有在評估組態處於 ACTIVE、 或 ERROR 狀態時UPDATE_FAILED,才能進行更新。如果目前正在建立、更新或刪除組態,您會收到衝突錯誤,並應在操作完成後重試。

執行控制

執行狀態參數可控制您的線上評估組態是否主動處理代理程式追蹤。了解這些狀態可協助您管理評估成本和效能。

  • 啟用評估 – 從 DISABLED 變更為 ENABLED 時,系統會佈建 服務,以開始處理來自指定資料來源的追蹤。

  • 停用評估 – 從 ENABLED 變更為 DISABLED 時,系統會停止處理新的追蹤,同時保留您的組態以供日後使用。

AgentCore CLI、AgentCore SDK 和 AWS SDK 的程式碼範例

下列程式碼範例示範如何使用不同的開發方法更新線上評估組態。選擇最適合您的開發環境和偏好設定的方法。

範例
AgentCore CLI
  1. 若要使用 AgentCore CLI 更新線上評估組態,請直接編輯agentcore.json檔案中的組態,然後重新部署:

    agentcore deploy

    開啟 agentcore.json ,在onlineEvalConfigs陣列中尋找組態,修改其設定,然後執行 agentcore deploy 。變更在您部署之前不會生效。

    # Pause a running online evaluation agentcore pause online-eval "your_config_name" # Resume a paused online evaluation agentcore resume online-eval "your_config_name"
    注意

    組態必須處於 ACTIVEUPDATE_FAILEDERROR生命週期狀態,才能進行更新。

    注意

    若要控制評估任務是否正在執行 ( ENABLED / DISABLED ),請使用 agentcore pause online-evalagentcore resume online-eval

    注意

    從 AgentCore 專案目錄 (使用 建立) agentcore create 內執行此操作。

AgentCore SDK
  1. from bedrock_agentcore_starter_toolkit import Evaluation # Initialize the evaluation client eval_client = Evaluation() config_id = "config-abc123" print(f"\nUsing config_id: {config_id}") # update description eval_client.update_online_config( config_id=config_id, description="Updated description for online evaluation" ) print("✅ Description updated")
AWS SDK
  1. import boto3 client = boto3.client('bedrock-agentcore-control') update_config_response = client.update_online_evaluation_config( onlineEvaluationConfigId='your_config_id', description="Updated description for online evaluation" )
AWS CLI
  1. aws bedrock-agentcore-control update-online-evaluation-config \ --online-evaluation-config-id your_config_id \ --description "Updated description for online evaluation"

主控台

使用主控台的編輯界面修改線上評估組態設定,該界面提供表單驗證和引導式組態選項。

更新線上評估組態

  1. 開啟 Amazon Bedrock AgentCore 主控台。

  2. 在導覽窗格中,選擇評估

  3. 評估組態卡中,檢視列出您已建立之評估組態的資料表。

  4. 選擇下列其中一種方法來更新組態:

    • 選擇評估組態名稱以檢視其詳細資訊,然後選擇詳細資訊頁面右上角的編輯

    • 選取評估組態,使其反白顯示,然後選擇評估組態卡頂端的編輯

  5. 視需要更新欄位。

  6. 選擇更新評估組態以儲存變更。