Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Gérer des exemples de jeux de données
Une fois qu'un jeu de données 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 identifiant d'exemple n'est trouvé, l'ensemble du lot é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 jeu de données :
Exemple
- AgentCore CLI
-
-
Pour ajouter des exemples à l'aide de 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 deploy
Le déploiement détecte de nouveaux scénarios dans votre fichier JSONL et les ajoute au service. Seul le diff est appliqué ; les exemples existants ne sont pas chargés à nouveau.
Exécutez-le depuis un répertoire de AgentCore projet (créé avecagentcore 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 exampleId plus les champs de contenu mis à jour. L'ensemble de données doit être actif ACTIVE ou en UPDATE_FAILED statut.
Les exemples suivants montrent comment mettre à jour des exemples de jeux de données :
Exemple
- AgentCore CLI
-
-
Pour mettre à jour les 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 deploy
Le déploiement différencie votre fichier local du service et met à jour les exemples modifiés. Chaque ligne doit conserver la sienne exampleId pour que le service la reconnaisse comme une mise à jour plutôt que comme un nouvel exemple.
Exécutez-le depuis un répertoire de AgentCore projet (créé avecagentcore 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
L'ensemble de données doit être dans ACTIVEUPDATE_FAILED, ou en CREATE_FAILED statut.
Les exemples suivants montrent comment supprimer des exemples d'ensembles 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 deploy
Le déploiement détecte les scénarios supprimés et les supprime du service.
Exécutez-le depuis un répertoire de AgentCore projet (créé avecagentcore 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, lit à partir du brouillon. Spécifiez datasetVersion de lire à 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
