View a markdown version of this page

Evaluator aktualisieren - Amazon Grundgestein AgentCore
Codebeispiele für AgentCore SDK und AWS SDKKonsole

Evaluator aktualisieren

Die UpdateEvaluator API ändert die Konfiguration, Beschreibung oder Evaluierungsebene eines vorhandenen benutzerdefinierten Evaluators. Dieser asynchrone Vorgang ist nur für entsperrte Evaluatoren zulässig.

Schutz vor Änderungssperren: Updates sind nicht zulässig, wenn der Evaluator von einer aktivierten Testkonfiguration verwendet wurde.

Die API kehrt sofort mit aktualisierten Metadaten zurück. Überwachen Sie den Status des Evaluators, um sicherzustellen, dass die Änderungen mithilfe der GetEvaluator API erfolgreich angewendet wurden.

Codebeispiele für AgentCore SDK und AWS SDK

Die folgenden Codebeispiele zeigen, wie Evaluatoren 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 einen Evaluator mit der AgentCore CLI zu aktualisieren, bearbeiten Sie die Evaluator-Konfiguration direkt in Ihrer agentcore.json Datei und stellen Sie ihn dann erneut bereit:

    agentcore deploy

    Öffnen Sieagentcore.json, suchen Sie den Evaluator im evaluators Array, ändern Sie seine Konfiguration und führen Sie ihn dann aus. agentcore deploy Änderungen werden erst wirksam, wenn Sie sie bereitstellen.

    Anmerkung

    Wenn der Evaluator durch eine laufende Online-Evaluierung gesperrt ist, müssen Sie zuerst die Online-Evaluierung unterbrechen, agentcore pause online-eval bevor Sie Änderungen vornehmen, oder stattdessen den Evaluator klonen. Nachdem Sie Ihre Änderungen implementiert haben, setzen Sie die Online-Evaluierung mit fort. agentcore 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

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"

Konsole

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

Um einen benutzerdefinierten Evaluator zu aktualisieren

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

  2. Wählen Sie im Navigationsbereich Evaluation aus.

  3. Wählen Sie neben Testkonfigurationen die Option Benutzerdefinierte Evaluatoren aus.

  4. Sehen Sie sich auf der Karte Benutzerdefinierte Evaluatoren die Tabelle mit den von Ihnen erstellten benutzerdefinierten Evaluatoren an.

  5. Wählen Sie eine der folgenden Methoden, um den benutzerdefinierten Evaluator zu aktualisieren:

    • Wählen Sie den Namen des benutzerdefinierten Evaluators, um dessen Details anzuzeigen, und klicken Sie dann oben rechts auf der Detailseite auf Bearbeiten.

    • Wählen Sie den benutzerdefinierten Evaluator aus, sodass er hervorgehoben wird, und klicken Sie dann oben auf der Karte mit den benutzerdefinierten Evaluatoren auf Bearbeiten.

      Anmerkung

      Wenn der Evaluator in einer Online-Bewertung verwendet wird, kann er nicht aktualisiert werden. Stattdessen können Sie den Evaluator duplizieren und die geklonte Version aktualisieren.

  6. Aktualisieren Sie die Felder nach Bedarf.

  7. Wählen Sie Evaluator aktualisieren, um die Änderungen zu speichern.