View a markdown version of this page

Online-Bewertung aktualisieren - Amazon Grundgestein AgentCore
Steuerung der AusführungCodebeispiele für AgentCore CLI, AgentCore SDK und AWS SDKKonsole

Online-Bewertung aktualisieren

Die UpdateOnlineEvaluationConfig API ändert eine bestehende Online-Evaluierungskonfiguration, sodass Sie Evaluatoren, Datenquellen, Ausführungseinstellungen und andere Parameter ändern können. Dieser Vorgang verarbeitet Aktualisierungen auf intelligente Weise, ohne dass die laufenden Evaluierungen unterbrochen werden.

Aktualisierungen können nur vorgenommen werden, wenn sich Ihre Testkonfiguration im ERROR Status ACTIVEUPDATE_FAILED, oder befindet. Wenn die Konfiguration gerade erstellt, aktualisiert oder gelöscht wird, erhalten Sie einen Konfliktfehler und sollten es nach Abschluss des Vorgangs erneut versuchen.

Steuerung der Ausführung

Der Parameter für den Ausführungsstatus steuert, ob Ihre Online-Evaluierungskonfiguration aktiv Agenten-Traces verarbeitet. Wenn Sie diese Status kennen, können Sie die Kosten und die Leistung der Evaluierung besser verwalten.

  • Aktivierung der Auswertung — Wenn Sie von DISABLED zu ENABLED wechseln, stellt das System den Dienst so bereit, dass er mit der Verarbeitung von Traces aus Ihren angegebenen Datenquellen beginnt.

  • Bewertung deaktivieren — Wenn Sie von ENABLED zu DISABLED wechseln, beendet das System die Verarbeitung neuer Traces und behält Ihre Konfiguration für die future Verwendung bei.

Codebeispiele für AgentCore CLI, AgentCore SDK und AWS SDK

Die folgenden Codebeispiele zeigen, wie Online-Evaluierungskonfigurationen mithilfe verschiedener Entwicklungsansätze aktualisiert werden. Wählen Sie die Methode, die am besten zu Ihrer Entwicklungsumgebung und Ihren Präferenzen passt.

Beispiel
AgentCore CLI

  1. Um eine Online-Evaluierungskonfiguration mit der AgentCore CLI zu aktualisieren, bearbeiten Sie die Konfiguration direkt in Ihrer agentcore.json Datei und stellen Sie sie dann erneut bereit:

    agentcore deploy

    Öffnen Sieagentcore.json, suchen Sie die Konfiguration im onlineEvalConfigs Array, ändern Sie die Einstellungen und führen Sie sie dann ausagentcore deploy. Änderungen werden erst wirksam, wenn Sie sie bereitstellen.

    # Pause a running online evaluation
agentcore pause online-eval "your_config_name"

# Resume a paused online evaluation
agentcore resume online-eval "your_config_name"
    Anmerkung

    Die Konfiguration muss sich im ACTIVE Lebenszyklusstatus oder im ERROR Lebenszyklusstatus befindenUPDATE_FAILED, bevor Sie sie aktualisieren können.

    Anmerkung

    Um zu steuern, ob der Evaluierungsjob ausgeführt wird (ENABLED/DISABLED), verwenden Sie agentcore pause online-eval undagentcore resume online-eval.

    Anmerkung

    Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mitagentcore 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"

Konsole

Ändern Sie Ihre Konfigurationseinstellungen für die Online-Testversion mithilfe der Bearbeitungsoberfläche der Konsole, die Optionen für die Formularvalidierung und geführte Konfiguration bietet.

Um eine Konfiguration für die Online-Evaluierung zu aktualisieren

  1. Öffnen Sie die Amazon AgentCore Bedrock-Konsole.

  2. Wählen Sie im Navigationsbereich Evaluation aus.

  3. Sehen Sie sich auf der Karte Testkonfigurationen die Tabelle an, in der die von Ihnen erstellten Testkonfigurationen aufgeführt sind.

  4. Wählen Sie eine der folgenden Methoden, um die Konfiguration zu aktualisieren:

    • Wählen Sie den Namen der Testkonfiguration, um die zugehörigen Details anzuzeigen, und klicken Sie dann oben rechts auf der Detailseite auf Bearbeiten.

    • Wählen Sie die Testkonfiguration aus, sodass sie hervorgehoben ist, und klicken Sie dann oben auf der Karte mit den Testkonfigurationen auf Bearbeiten.

  5. Aktualisieren Sie die Felder nach Bedarf.

  6. Wählen Sie Testkonfiguration aktualisieren, um die Änderungen zu speichern.