Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Administrar ejemplos de conjuntos de datos
Cuando un conjunto de datos alcance el ACTIVE estado, puedes agregar, actualizar, eliminar y enumerar ejemplos en el borrador. Todas las mutaciones de ejemplo son asincrónicas (HTTP 202) y utilizan una semántica de todo o nada; si no se encuentra ningún identificador de ejemplo, se produce un error en todo el lote. ResourceNotFoundException
Máximo 1000 ejemplos por solicitud. Límite de contenido en línea: 5 MB.
AddDatasetExamples
Los siguientes ejemplos muestran cómo agregar ejemplos a un conjunto de datos:
ejemplo
- AgentCore CLI
-
-
Para agregar ejemplos con la AgentCore CLI, añada nuevos escenarios a su archivo JSONL local y, a continuación, vuelva a implementarlos:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines
agentcore deploy
La implementación detecta nuevos escenarios en tu archivo JSONL y los agrega al servicio. Solo se aplica la diferencia; los ejemplos existentes no se vuelven a cargar.
Ejecútelo desde el directorio de un AgentCore proyecto (creado conagentcore 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
Cada entrada debe incluir exampleId más los campos de contenido actualizados. El conjunto de datos debe estar en UPDATE_FAILED estado ACTIVE o.
Los siguientes ejemplos muestran cómo actualizar ejemplos de conjuntos de datos:
ejemplo
- AgentCore CLI
-
-
Para actualizar los ejemplos con la AgentCore CLI, modifique los escenarios existentes en su archivo JSONL local y, a continuación, vuelva a implementarlos:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines
agentcore deploy
La implementación diferencia el archivo local del servicio y actualiza los ejemplos modificados. Cada línea debe conservar la suya exampleId para que el servicio la reconozca como una actualización y no como un ejemplo nuevo.
Ejecútelo desde el directorio de un AgentCore proyecto (creado conagentcore 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
El conjunto de datos debe estar en ACTIVE CREATE_FAILED estado o en estado. UPDATE_FAILED
Los siguientes ejemplos muestran cómo eliminar un conjunto de datos:
ejemplo
- AgentCore CLI
-
-
Para eliminar ejemplos con la AgentCore CLI, elimina las líneas correspondientes de tu archivo JSONL local y, a continuación, vuelve a implementarlas:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines
agentcore deploy
La implementación detecta los escenarios eliminados y los elimina del servicio.
Ejecútelo desde el directorio de un AgentCore proyecto (creado conagentcore 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
Devuelve una lista paginada de ejemplos con contenido completo. De forma predeterminada, lee el borrador. datasetVersionEspecifique si desea leer una versión publicada.
Los siguientes ejemplos muestran cómo enumerar ejemplos de conjuntos de datos:
ejemplo
- 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
