# 更新線上評估
<a name="update-online-evaluations"></a>

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

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

## 執行控制
<a name="execution-control"></a>

執行狀態參數可控制您的線上評估組態是否主動處理代理程式追蹤。了解這些狀態可協助您管理評估成本和效能。
+  **啟用評估** – 從 DISABLED 變更為 ENABLED 時，系統會佈建 服務，以開始處理來自指定資料來源的追蹤。
+  **停用評估** – 從 ENABLED 變更為 DISABLED 時，系統會停止處理新的追蹤，同時保留您的組態以供日後使用。

## AgentCore CLI、AgentCore SDK 和 AWS SDK 的程式碼範例
<a name="update-online-evaluations-code-samples"></a>

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

**Example**  

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"
   ```
**注意**  
組態必須處於 `ACTIVE`、 `UPDATE_FAILED`或 `ERROR`生命週期狀態，才能進行更新。
**注意**  
若要控制評估任務是否正在執行 ( `ENABLED` / `DISABLED` )，請使用 `agentcore pause online-eval`和 `agentcore resume online-eval`。
**注意**  
從 AgentCore 專案目錄 （使用 建立） `agentcore create` 內執行此操作。

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")
   ```

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"
   )
   ```

1. 

   ```
   aws bedrock-agentcore-control update-online-evaluation-config \
       --online-evaluation-config-id your_config_id \
       --description "Updated description for online evaluation"
   ```

## 主控台
<a name="update-online-evaluations-console"></a>

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

 **更新線上評估組態** 

1. 開啟 Amazon Bedrock AgentCore 主控台。

1. 在導覽窗格中，選擇**評估**。

1. 在**評估組態**卡中，檢視列出您已建立之評估組態的資料表。

1. 選擇下列其中一種方法來更新組態：
   + 選擇評估組態名稱以檢視其詳細資訊，然後選擇詳細資訊頁面右上角的**編輯**。
   + 選取評估組態，使其反白顯示，然後選擇**評估組態**卡頂端的**編輯**。

1. 視需要更新欄位。

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