Ejemplos de administración de conjuntos de datos
Cuando un conjunto de datos alcanza el ACTIVE estado, puedes añadir, actualizar, eliminar y enumerar ejemplos en el borrador. Todas las mutaciones de ejemplo son asíncronas (HTTP 202) y utilizan la semántica de «todo o nada»: si no se encuentra ningún identificador de ejemplo, se generará 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 añadir ejemplos a un conjunto de datos:
ejemplo
- AgentCore CLI
-
-
Para añadir ejemplos con la AgentCore CLI, añada nuevos escenarios a su archivo JSONL local y, a continuación, vuelva a implementar:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deployLa implementación detecta nuevos escenarios en el archivo JSONL y los agrega al servicio. Solo se aplica la diferencia; los ejemplos existentes no se vuelven a cargar.
nota
Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado 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
Cada entrada debe incluir exampleId además los campos de contenido actualizados. El conjunto de datos debe estar en ACTIVE nuestro UPDATE_FAILED estado.
Los siguientes ejemplos muestran cómo actualizar los 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 implementar:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deployLa implementación diferencia tu archivo local del servicio y actualiza los ejemplos modificados. Cada línea debe conservar la suya
exampleIdpara que el servicio la reconozca como una actualización y no como un ejemplo nuevo.nota
Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado 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
El conjunto de datos debe estar en ACTIVEUPDATE_FAILED, o CREATE_FAILED estado.
Los siguientes ejemplos muestran cómo eliminar ejemplos de conjuntos de datos:
ejemplo
- AgentCore CLI
-
-
Para eliminar ejemplos con la AgentCore CLI, elimine las líneas correspondientes del archivo JSONL local y, a continuación, vuelva a implementar:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deployLa implementación detecta los escenarios eliminados y los elimina del servicio.
nota
Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado 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
Devuelve una lista paginada de ejemplos con todo el contenido. De forma predeterminada, lee del Borrador. Especifique datasetVersion si desea leer de 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
-