View a markdown version of this page

Kelola contoh kumpulan data - Batuan Dasar Amazon AgentCore

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

    Penerapan 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 denganagentcore 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

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

    Penerapan membedakan file lokal Anda terhadap layanan dan memperbarui contoh yang diubah. Setiap baris harus exampleId mempertahankannya agar layanan dapat mengenalinya sebagai pembaruan daripada contoh baru.

    catatan

    Jalankan ini dari dalam direktori AgentCore proyek (dibuat denganagentcore 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

Dataset harus dalamACTIVE,UPDATE_FAILED, atau CREATE_FAILED status.

Contoh berikut menunjukkan cara menghapus contoh dataset:

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

    Penerapan mendeteksi skenario yang dihapus dan menghapusnya dari layanan.

    catatan

    Jalankan ini dari dalam direktori AgentCore proyek (dibuat denganagentcore 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

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
  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