Gestisci esempi di set di dati
Dopo che un set di dati ha raggiunto ACTIVE lo stato, puoi aggiungere, aggiornare, eliminare ed elencare esempi nella bozza. Tutte le mutazioni di esempio sono asincrone (HTTP 202) e utilizzano la semantica «tutto o niente»: se non viene trovato alcun ID di esempio, l'intero batch ha esito negativo. ResourceNotFoundException
Massimo 1.000 esempi per richiesta. Limite di contenuti in linea: 5 MB.
AddDatasetExamples
Gli esempi seguenti mostrano come aggiungere esempi a un set di dati:
Esempio
- AgentCore CLI
-
-
Per aggiungere esempi con la AgentCore CLI, aggiungi nuovi scenari al tuo file JSONL locale, quindi ridistribuisci:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deployLa distribuzione rileva nuovi scenari nel file JSONL e li aggiunge al servizio. Viene applicata solo la differenza: gli esempi esistenti non vengono caricati nuovamente.
Nota
Eseguilo dall'interno di una directory di AgentCore progetto (creata con
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
Ogni voce deve includere exampleId più i campi di contenuto aggiornati. Il set di dati deve essere attivo ACTIVE o in UPDATE_FAILED stato.
Gli esempi seguenti mostrano come aggiornare gli esempi di set di dati:
Esempio
- AgentCore CLI
-
-
Per aggiornare gli esempi con la AgentCore CLI, modifica gli scenari esistenti nel file JSONL locale, quindi ridistribuisci:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deployLa distribuzione differenzia il file locale dal servizio e aggiorna gli esempi di modifiche. Ogni riga deve conservare la propria
exampleIdaffinché il servizio la riconosca come un aggiornamento anziché come un nuovo esempio.Nota
Eseguilo dall'interno di una directory di AgentCore progetto (creata con
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
Il set di dati deve essere in ACTIVEUPDATE_FAILED, o deve essere in CREATE_FAILED stato.
Gli esempi seguenti mostrano come eliminare esempi di set di dati:
Esempio
- AgentCore CLI
-
-
Per eliminare esempi con la AgentCore CLI, rimuovi le righe corrispondenti dal file JSONL locale, quindi ridistribuisci:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deployLa distribuzione rileva gli scenari rimossi e li elimina dal servizio.
Nota
Eseguilo dall'interno di una directory di AgentCore progetto (creata con).
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
Restituisce un elenco impaginato di esempi con contenuto completo. Per impostazione predefinita, legge dalla bozza. datasetVersionSpecificate di leggere da una versione pubblicata.
I seguenti esempi mostrano come elencare esempi di set di dati:
Esempio
- 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
-