View a markdown version of this page

Holen Sie sich eine Online-Bewertung - Amazon Grundgestein AgentCore
LebenszyklusstatusCodebeispiele für AgentCore SDK und AWS SDKKonsole

Holen Sie sich eine Online-Bewertung

Die GetOnlineEvaluationConfig API ruft die vollständigen Details und den aktuellen Status einer vorhandenen Online-Testkonfiguration ab. Dieser synchrone Vorgang gibt die vollständige Konfiguration zurück, einschließlich Datenquellen, Evaluatoren, Ausführungsstatus und Betriebsmetadaten.

Verwenden Sie diese API, um den Lebenszyklusstatus der Konfiguration (ACTIVE,CREATING,CREATE_FAILED,UPDATING, UPDATE_FAILEDDELETING, oderERROR) zu überwachen, den aktuellen Ausführungsstatus (ENABLEDoderDISABLED) zu überprüfen und alle Konfigurationsparameter einschließlich Evaluatorlisten, Datenquelleneinstellungen und Ausgabeziele abzurufen.

Lebenszyklusstatus

Das status Feld in einer Online-Evaluierungskonfiguration meldet seinen Lebenszyklusstatus. Dieser ist unabhängig von dem executionStatus Feld, das steuert, ob der Evaluierungsjob aktiv Ablaufverfolgungen verarbeitet.

  • ACTIVE— Die Konfiguration ist vollständig bereitgestellt und sofort einsatzbereit.

  • CREATING— Die Konfiguration wird bereitgestellt. Warten Sie, bis die Umstellung abgeschlossen ist, ACTIVE bevor Sie sie aktualisieren oder löschen.

  • CREATE_FAILED— Die Erstellung wurde nicht erfolgreich abgeschlossen. In diesem Status können Sie eine Konfiguration nicht aktualisieren. Rufen Sie DeleteOnlineEvaluationConfig auf, um sie zu entfernen, und erstellen Sie dann eine neue.

  • UPDATING— Ein Update ist im Gange. Warten Sie, bis der Vorgang abgeschlossen ist, bevor Sie weitere Änderungen vornehmen.

  • UPDATE_FAILED— Das letzte Update wurde nicht angewendet. Sie können es erneut versuchen, indem Sie UpdateOnlineEvaluationConfig erneut anrufen oder die Konfiguration mit DeleteOnlineEvaluationConfig entfernen.

  • DELETING— Die Konfiguration wird entfernt.

  • ERROR— Es ist ein Problem aufgetreten, das Ihr Eingreifen erfordert. Markieren Sie das failureReason Feld, um das Problem zu identifizieren. Zu den häufigsten Ursachen gehören unzureichender IAM-Rollenzugriff, fehlende Protokollgruppenberechtigungen und Überschreitungen von Servicekontingenten. Rufen Sie nach der Behebung des Problems an, UpdateOnlineEvaluationConfig um es erneut zu versuchen oder die DeleteOnlineEvaluationConfig Konfiguration zu entfernen.

Codebeispiele für AgentCore SDK und AWS SDK

Die folgenden Codebeispiele zeigen, wie Sie mithilfe verschiedener Entwicklungsansätze Informationen zur Online-Evaluierung abrufen können. Wählen Sie die Methode, die am besten zu Ihrer Entwicklungsumgebung und Ihren Präferenzen passt.

Beispiel
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

Konsole

Sie können detaillierte Informationen zu einer bestimmten Online-Testkonfiguration über die Konsolenoberfläche einsehen.

Um Einzelheiten zur Konfiguration der Online-Testversion abzurufen

  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. Um Informationen zu einer bestimmten Testkonfiguration anzuzeigen, wählen Sie den Namen der Konfiguration aus, um die zugehörigen Details anzuzeigen.