Exemples de gestion de jeux de données
Une fois qu'un ensemble de données a atteint ACTIVE son statut, vous pouvez ajouter, mettre à jour, supprimer et répertorier des exemples dans le brouillon. Tous les exemples de mutations sont asynchrones (HTTP 202) et utilisent une sémantique du tout ou rien : si aucun exemple d'ID n'est trouvé, le lot entier échoue. ResourceNotFoundException
Maximum de 1 000 exemples par demande. Limite de contenu en ligne : 5 Mo.
AddDatasetExamples
Les exemples suivants montrent comment ajouter des exemples à un ensemble de données :
Exemple
- AgentCore CLI
-
-
Pour ajouter des exemples avec la AgentCore CLI, ajoutez de nouveaux scénarios à votre fichier JSONL local, puis redéployez :
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deployLe déploiement détecte les nouveaux scénarios dans votre fichier JSONL et les ajoute au service. Seule la différence est appliquée ; les exemples existants ne sont pas rechargés.
Note
Exécutez-le depuis un répertoire de AgentCore projet (créé avec
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
Chaque entrée doit inclure les champs de contenu mis à jour en exampleId plus. L'ensemble de données doit être dans ACTIVE ou UPDATE_FAILED statut.
Les exemples suivants montrent comment mettre à jour des exemples de jeux de données :
Exemple
- AgentCore CLI
-
-
Pour mettre à jour des exemples avec la AgentCore CLI, modifiez les scénarios existants dans votre fichier JSONL local, puis redéployez :
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deployLe déploiement différencie votre fichier local du service et met à jour les exemples modifiés. Chaque ligne doit conserver sa valeur
exampleIdpour que le service la reconnaisse comme une mise à jour plutôt que comme un nouvel exemple.Note
Exécutez-le depuis un répertoire de AgentCore projet (créé avec
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
Le jeu de données doit être ACTIVE activé UPDATE_FAILED ou en CREATE_FAILED statut.
Les exemples suivants montrent comment supprimer des exemples de jeux de données :
Exemple
- AgentCore CLI
-
-
Pour supprimer des exemples à l'aide de la AgentCore CLI, supprimez les lignes correspondantes de votre fichier JSONL local, puis redéployez :
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deployLe déploiement détecte les scénarios supprimés et les supprime du service.
Note
Exécutez-le depuis un répertoire de AgentCore projet (créé avec
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
Renvoie une liste paginée d'exemples avec le contenu complet. Par défaut, il lit des extraits du brouillon. Spécifiez une lecture datasetVersion à partir d'une version publiée.
Les exemples suivants montrent comment répertorier des exemples de jeux de données :
Exemple
- 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
-