# 取得線上評估
<a name="get-online-evaluations"></a>

`GetOnlineEvaluationConfig` API 會擷取現有線上評估組態的完整詳細資訊和目前狀態。此同步操作會傳回完整組態，包括資料來源、評估器、執行狀態和操作中繼資料。

使用此 API 來監控組態的生命週期狀態 (`ACTIVE`、`CREATING`、`CREATE_FAILED``UPDATING`、`UPDATE_FAILED`、、 或 `ERROR`)`DELETING`、檢查目前的執行狀態 (`ENABLED` 或 `DISABLED`)，以及擷取所有組態參數，包括評估器清單、資料來源設定和輸出目的地。

## 生命週期狀態
<a name="lifecycle-status"></a>

線上評估組態上的 `status` 欄位會報告其生命週期狀態，這與控制評估任務是否正在處理追蹤`executionStatus`的欄位不同。
+  `ACTIVE` – 組態已完全佈建並可供使用。
+  `CREATING` – 正在佈建組態。等待它轉換為 ，`ACTIVE`再更新或刪除。
+  `CREATE_FAILED` – 建立未成功完成。您無法在此狀態下更新組態；請呼叫 `DeleteOnlineEvaluationConfig` 來移除組態，然後建立新的組態。
+  `UPDATING` – 正在更新。等待操作完成，然後再進行其他變更。
+  `UPDATE_FAILED` – 最近更新不適用。您可以`UpdateOnlineEvaluationConfig`再次呼叫 或使用 移除組態，以重試`DeleteOnlineEvaluationConfig`。
+  `DELETING` – 正在移除組態。
+  `ERROR` – 發生需要您動作的問題。檢查 `failureReason` 欄位以識別問題。常見原因包括 IAM 角色存取不足、缺少日誌群組許可，以及超出服務配額。修正問題後，請呼叫 `UpdateOnlineEvaluationConfig` 以重試或`DeleteOnlineEvaluationConfig`移除組態。

## AgentCore SDK 和 AWS SDK 的程式碼範例
<a name="get-online-evaluation-code-samples"></a>

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

**Example**  

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}")
   
   config_details = eval_client.get_online_config(config_id)
   # Display configuration details
   print(f"Config Name: {config_details['onlineEvaluationConfigName']}")
   print(f"Config ID: {config_details['onlineEvaluationConfigId']}")
   print(f"Status: {config_details['status']}")
   ```

1. 

   ```
   import boto3
   
   client = boto3.client('bedrock-agentcore-control')
   
   response = client.get_online_evaluation_config(
       onlineEvaluationConfigId='your_config_id'
   )
   ```

1. 

   ```
   aws bedrock-agentcore-control get-online-evaluation-config \
       --online-evaluation-config-id your_config_id
   ```

## 主控台
<a name="get-online-evaluation-console"></a>

您可以透過主控台界面檢視特定線上評估組態的詳細資訊。

 **取得線上評估組態詳細資訊** 

1. 開啟 Amazon Bedrock AgentCore 主控台。

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

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

1. 若要檢視特定評估組態的資訊，請選擇組態名稱以檢視其詳細資訊。