View a markdown version of this page

Ejemplos de administración de conjuntos de datos - Amazon Bedrock AgentCore

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
  1. 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 deploy

    La 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 conagentcore create).

AgentCore SDK
  1. 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
  1. 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
  1. 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
  1. 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 deploy

    La implementación diferencia tu 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.

    nota

    Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado conagentcore create).

AgentCore SDK
  1. 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
  1. 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
  1. 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
  1. 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 deploy

    La implementación detecta los escenarios eliminados y los elimina del servicio.

    nota

    Ejecútelo desde el interior de un directorio de AgentCore proyecto (creado conagentcore create).

AgentCore SDK
  1. 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
  1. 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
  1. 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
  1. # 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
  1. 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
  1. 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
  1. # 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