As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Gerenciar exemplos de conjuntos de dados
Depois que um conjunto de dados atingir ACTIVE o status, você poderá adicionar, atualizar, excluir e listar exemplos no Rascunho. Todos os exemplos de mutações são assíncronas (HTTP 202) e usam a semântica de tudo ou nada — se algum ID de exemplo não for encontrado, todo o lote falhará. ResourceNotFoundException
Máximo de 1.000 exemplos por solicitação. Limite de conteúdo embutido: 5 MB.
AddDatasetExamples
Os exemplos a seguir mostram como adicionar exemplos a um conjunto de dados:
exemplo
- AgentCore CLI
-
-
Para adicionar exemplos com a AgentCore CLI, acrescente novos cenários ao seu arquivo JSONL local e, em seguida, reimplante:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines
agentcore deploy
A implantação detecta novos cenários em seu arquivo JSONL e os adiciona ao serviço. Somente o diff é aplicado — os exemplos existentes não são recarregados.
Execute isso de dentro de um diretório de AgentCore projeto (criado comagentcore 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 deve incluir exampleId mais os campos de conteúdo atualizados. O conjunto de dados deve estar em ACTIVE ou em UPDATE_FAILED status.
Os exemplos a seguir mostram como atualizar exemplos de conjuntos de dados:
exemplo
- AgentCore CLI
-
-
Para atualizar exemplos com a AgentCore CLI, modifique os cenários existentes em seu arquivo JSONL local e, em seguida, reimplante:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines
agentcore deploy
A implantação compara seu arquivo local com o serviço e atualiza exemplos alterados. Cada linha deve mantê-la exampleId para que o serviço a reconheça como uma atualização em vez de um novo exemplo.
Execute isso de dentro de um diretório de AgentCore projeto (criado comagentcore 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
O conjunto de dados deve estar em ACTIVEUPDATE_FAILED, ou CREATE_FAILED status.
Os exemplos a seguir mostram como excluir exemplos de conjuntos de dados:
exemplo
- AgentCore CLI
-
-
Para excluir exemplos com a AgentCore CLI, remova as linhas correspondentes do seu arquivo JSONL local e reimplante:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines
agentcore deploy
A implantação detecta cenários removidos e os exclui do serviço.
Execute isso de dentro de um diretório de AgentCore projeto (criado comagentcore 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
Retorna uma lista paginada de exemplos com conteúdo completo. Por padrão, lê o rascunho. Especifique datasetVersion para ler a partir de uma versão publicada.
Os exemplos a seguir mostram como listar exemplos de conjuntos de dados:
exemplo
- 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
