View a markdown version of this page

取得線上評估 - Amazon Bedrock AgentCore
生命週期狀態AgentCore SDK 和 AWS SDK 的程式碼範例主控台

取得線上評估

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

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

生命週期狀態

線上評估組態上的 status 欄位會報告其生命週期狀態，這與控制評估任務是否正在處理追蹤executionStatus的欄位不同。

  • ACTIVE – 組態已完全佈建並可供使用。

  • CREATING – 正在佈建組態。等待它轉換為 ，ACTIVE再更新或刪除。

  • CREATE_FAILED – 建立未成功完成。您無法在此狀態下更新組態；請呼叫 DeleteOnlineEvaluationConfig 來移除組態，然後建立新的組態。

  • UPDATING – 正在更新。等待操作完成，然後再進行其他變更。

  • UPDATE_FAILED – 最近更新不適用。您可以UpdateOnlineEvaluationConfig再次呼叫 或使用 移除組態，以重試DeleteOnlineEvaluationConfig。

  • DELETING – 正在移除組態。

  • ERROR – 發生需要您動作的問題。檢查 failureReason 欄位以識別問題。常見原因包括 IAM 角色存取不足、缺少日誌群組許可，以及超出服務配額。修正問題後，請呼叫 UpdateOnlineEvaluationConfig 以重試或DeleteOnlineEvaluationConfig移除組態。

AgentCore SDK 和 AWS SDK 的程式碼範例

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

範例
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}")

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']}")
AWS SDK

  1. import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.get_online_evaluation_config(
    onlineEvaluationConfigId='your_config_id'
)
AWS CLI

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

主控台

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

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

  1. 開啟 Amazon Bedrock AgentCore 主控台。

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

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

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