Kelola contoh kumpulan data
Setelah kumpulan data mencapai ACTIVE status, Anda dapat menambahkan, memperbarui, menghapus, dan mencantumkan contoh di Draf. Semua contoh mutasi bersifat asinkron (HTTP 202) dan menggunakan semantik semua-atau-tidak sama sekali — jika ada contoh ID yang tidak ditemukan, seluruh batch gagal. ResourceNotFoundException
Maksimal 1.000 contoh per permintaan. Batas konten sebaris: 5 MB.
AddDatasetExamples
Contoh berikut menunjukkan cara menambahkan contoh ke kumpulan data:
contoh
- AgentCore CLI
-
-
Untuk menambahkan contoh dengan AgentCore CLI, tambahkan skenario baru ke file JSONL lokal Anda, lalu terapkan ulang:
# Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deployPenerapan mendeteksi skenario baru dalam file JSONL Anda dan menambahkannya ke layanan. Hanya perbedaan yang diterapkan — contoh yang ada tidak diunggah ulang.
catatan
Jalankan ini dari dalam direktori AgentCore proyek (dibuat dengan
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
Setiap entri harus menyertakan exampleId ditambah bidang konten yang diperbarui. Dataset harus dalam ACTIVE atau UPDATE_FAILED status.
Contoh berikut menunjukkan cara memperbarui contoh kumpulan data:
contoh
- AgentCore CLI
-
-
Untuk memperbarui contoh dengan AgentCore CLI, ubah skenario yang ada di file JSONL lokal Anda, lalu terapkan ulang:
# Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deployPenerapan membedakan file lokal Anda terhadap layanan dan memperbarui contoh yang diubah. Setiap baris harus
exampleIdmempertahankannya agar layanan dapat mengenalinya sebagai pembaruan daripada contoh baru.catatan
Jalankan ini dari dalam direktori AgentCore proyek (dibuat dengan
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
Dataset harus dalamACTIVE,UPDATE_FAILED, atau CREATE_FAILED status.
Contoh berikut menunjukkan cara menghapus contoh dataset:
contoh
- AgentCore CLI
-
-
Untuk menghapus contoh dengan AgentCore CLI, hapus baris yang sesuai dari file JSONL lokal Anda, lalu gunakan kembali:
# Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deployPenerapan mendeteksi skenario yang dihapus dan menghapusnya dari layanan.
catatan
Jalankan ini dari dalam direktori AgentCore proyek (dibuat dengan
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
Mengembalikan daftar paginasi contoh dengan konten lengkap. Secara default membaca dari Draft. Tentukan datasetVersion untuk membaca dari versi yang diterbitkan.
Contoh berikut menunjukkan cara membuat daftar contoh dataset:
contoh
- 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
-