Beispiele für Datensätze verwalten
Sobald ein Datensatz ACTIVE den Status erreicht hat, können Sie Beispiele im Entwurf hinzufügen, aktualisieren, löschen und auflisten. Alle Beispielmutationen sind asynchron (HTTP 202) und verwenden Alles-oder-Nichts-Semantik. Wenn keine Beispiel-ID gefunden wird, schlägt der gesamte Batch mit fehl. ResourceNotFoundException
Maximal 1.000 Beispiele pro Anfrage. Limit für Inline-Inhalte: 5 MB.
AddDatasetExamples
Die folgenden Beispiele zeigen, wie Sie einem Datensatz Beispiele hinzufügen können:
Beispiel
- AgentCore CLI
-
-
Um Beispiele mit der AgentCore CLI hinzuzufügen, hängen Sie neue Szenarien an Ihre lokale JSONL-Datei an und stellen Sie sie dann erneut bereit:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deployDie Bereitstellung erkennt neue Szenarien in Ihrer JSONL-Datei und fügt sie dem Service hinzu. Nur der Diff wird angewendet — bestehende Beispiele werden nicht erneut hochgeladen.
Anmerkung
Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mit
agentcore create).
-
- AgentCore SDK
-
-
from bedrock_agentcore.evaluation import DatasetClient client = DatasetClient(region_name="us-west-2") ds = client.add_examples_and_wait( datasetId="my-dataset-id", source={ "inlineExamples": { "examples": [ { "scenario_id": "TC-02", "turns": [{"input": "Transfer $100", "expected_response": "Transfer complete."}], } ] } }, ) print(f"Example count: {ds['exampleCount']}")
-
- AWS SDK
-
-
import boto3 import time client = boto3.client('bedrock-agentcore-control') resp = client.add_dataset_examples( datasetId='my-dataset-id', source={'inlineExamples': {'examples': [ {'scenario_id': 'TC-02', 'turns': [{'input': 'Transfer $100', 'expected_response': 'Transfer complete.'}]} ]}} ) print(f"Added example IDs: {resp['exampleIds']}") # Poll until ACTIVE while True: ds = client.get_dataset(datasetId='my-dataset-id') if ds['status'] == 'ACTIVE': break time.sleep(2)
-
- AWS CLI
-
-
aws bedrock-agentcore-control add-dataset-examples \ --dataset-id my-dataset-id \ --source '{"inlineExamples": {"examples": [{"scenario_id": "TC-02", "turns": [{"input": "Transfer $100", "expected_response": "Transfer complete."}]}]}}'
-
UpdateDatasetExamples
Jeder Eintrag muss Felder exampleId sowie die aktualisierten Inhaltsfelder enthalten. Der Datensatz muss den UPDATE_FAILED Status ACTIVE oder haben.
Die folgenden Beispiele zeigen, wie Sie Beispiele für Datensätze aktualisieren können:
Beispiel
- AgentCore CLI
-
-
Um Beispiele mit der AgentCore CLI zu aktualisieren, ändern Sie bestehende Szenarien in Ihrer lokalen JSONL-Datei und stellen Sie sie dann erneut bereit:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deployBei der Bereitstellung wird Ihre lokale Datei mit dem Service verglichen und die geänderten Beispiele aktualisiert. Jede Zeile muss ihre beibehalten,
exampleIddamit der Service sie als Update und nicht als neues Beispiel erkennt.Anmerkung
Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mit
agentcore create).
-
- AgentCore SDK
-
-
from bedrock_agentcore.evaluation import DatasetClient client = DatasetClient(region_name="us-west-2") ds = client.update_examples_and_wait( datasetId="my-dataset-id", examples=[ { "exampleId": "example-id-from-list", "scenario_id": "TC-02-updated", "turns": [{"input": "Transfer $200", "expected_response": "Transfer complete."}], } ], )
-
- AWS SDK
-
-
import boto3 import time client = boto3.client('bedrock-agentcore-control') client.update_dataset_examples( datasetId='my-dataset-id', examples=[ { 'exampleId': 'example-id-from-list', 'scenario_id': 'TC-02-updated', 'turns': [{'input': 'Transfer $200', 'expected_response': 'Transfer complete.'}], } ] ) # Poll until ACTIVE while True: ds = client.get_dataset(datasetId='my-dataset-id') if ds['status'] == 'ACTIVE': break time.sleep(2)
-
- AWS CLI
-
-
aws bedrock-agentcore-control update-dataset-examples \ --dataset-id my-dataset-id \ --cli-input-json file://update-examples.json
-
DeleteDatasetExamples
Der Datensatz muss den CREATE_FAILED Status ACTIVEUPDATE_FAILED, oder haben.
Die folgenden Beispiele zeigen, wie Sie Datensätze löschen können:
Beispiel
- AgentCore CLI
-
-
Um Beispiele mit der AgentCore CLI zu löschen, entfernen Sie die entsprechenden Zeilen aus Ihrer lokalen JSONL-Datei und stellen Sie sie dann erneut bereit:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deployDie Bereitstellung erkennt entfernte Szenarien und löscht sie aus dem Service.
Anmerkung
Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mit
agentcore create).
-
- AgentCore SDK
-
-
from bedrock_agentcore.evaluation import DatasetClient client = DatasetClient(region_name="us-west-2") ds = client.delete_examples_and_wait( datasetId="my-dataset-id", exampleIds=["example-id-1", "example-id-2"], )
-
- AWS SDK
-
-
import boto3 import time client = boto3.client('bedrock-agentcore-control') client.delete_dataset_examples( datasetId='my-dataset-id', exampleIds=['example-id-1', 'example-id-2'] ) # Poll until ACTIVE while True: ds = client.get_dataset(datasetId='my-dataset-id') if ds['status'] == 'ACTIVE': break time.sleep(2)
-
- AWS CLI
-
-
aws bedrock-agentcore-control delete-dataset-examples \ --dataset-id my-dataset-id \ --example-ids '["example-id-1", "example-id-2"]'
-
ListDatasetExamples
Gibt eine paginierte Liste von Beispielen mit vollständigem Inhalt zurück. Liest standardmäßig aus dem Entwurf. Geben Sie datasetVersion an, dass aus einer veröffentlichten Version gelesen werden soll.
Die folgenden Beispiele zeigen, wie Datensatzbeispiele aufgelistet werden:
Beispiel
- AgentCore CLI
-
-
# Download examples to your local JSONL file (default: Draft) agentcore dataset download --name my_eval_dataset # Download examples from a published version agentcore dataset download --name my_eval_dataset --version 1
-
- AgentCore SDK
-
-
from bedrock_agentcore.evaluation import DatasetClient client = DatasetClient(region_name="us-west-2") # List examples from Draft resp = client.list_dataset_examples(datasetId="my-dataset-id") for example in resp["examples"]: print(f" {example['exampleId']}: {example['scenario_id']}") # List examples from a published version resp = client.list_dataset_examples(datasetId="my-dataset-id", datasetVersion="1")
-
- AWS SDK
-
-
import boto3 client = boto3.client('bedrock-agentcore-control') resp = client.list_dataset_examples(datasetId='my-dataset-id') for example in resp['examples']: print(f" {example['exampleId']}: {example.get('scenario_id')}") # List examples from a published version resp = client.list_dataset_examples(datasetId='my-dataset-id', datasetVersion='1')
-
- AWS CLI
-
-
# List examples from Draft aws bedrock-agentcore-control list-dataset-examples \ --dataset-id my-dataset-id # List examples from a published version aws bedrock-agentcore-control list-dataset-examples \ --dataset-id my-dataset-id \ --dataset-version 1
-