View a markdown version of this page

更新評估器 - Amazon Bedrock AgentCore
AgentCore SDK 和 AWS SDK 的程式碼範例主控台

更新評估器

UpdateEvaluator API 會修改現有自訂評估者的組態、描述或評估層級。此非同步操作僅允許在已解除鎖定的評估器上執行。

修改鎖定保護：如果任何已啟用的評估組態已使用評估器，則不允許更新。

API 會立即傳回更新後的中繼資料。監控評估器狀態，以確認使用 GetEvaluator API 成功套用變更。

AgentCore SDK 和 AWS SDK 的程式碼範例

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

範例
AgentCore CLI

  1. 若要使用 AgentCore CLI 更新評估器，請直接編輯agentcore.json檔案中的評估器組態，然後重新部署：

    agentcore deploy

    開啟 agentcore.json ，在evaluators陣列中尋找評估器，修改其組態，然後執行 agentcore deploy 。變更在您部署之前不會生效。

    注意

    如果評估器被執行中的線上評估鎖定，您必須先暫停 的線上評估，agentcore pause online-eval然後再進行變更，或改為複製評估器。部署變更之後，請使用 繼續線上評估agentcore resume online-eval。

    注意

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

AgentCore SDK

  1. from bedrock_agentcore_starter_toolkit import Evaluation

eval_client = Evaluation()

eval_client.update_evaluator(
        evaluator_id=evaluator_id,
        description="Updated custom evaluator description"
    )
AWS SDK

  1. import boto3

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

list_configs_response = client.update_evaluator(
    evaluatorId=evaluator_id,
    description="Updated custom evaluator description"
)
AWS CLI

  1. aws bedrock-agentcore-control update-evaluator \
    --evaluator-id 'evaluator-abc123' \
    --description "Updated custom evaluator description"

主控台

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

更新自訂評估器

  1. 開啟 Amazon Bedrock AgentCore 主控台。

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

  3. 選擇評估組態旁的自訂評估器。

  4. 在自訂評估者卡片中，檢視列出您已建立之自訂評估者的資料表。

  5. 選擇下列其中一種方法來更新自訂評估器：

    • 選擇自訂評估器名稱以檢視其詳細資訊，然後選擇詳細資訊頁面右上角的編輯。

    • 選取自訂評估器，使其反白顯示，然後選擇自訂評估器卡片頂端的編輯。

      注意

      如果評估器正用於任何線上評估，則無法更新。反之，您可以複製評估器並更新複製的版本。

  6. 視需要更新欄位。

  7. 選擇更新評估器以儲存變更。