View a markdown version of this page

Beispiele für Datensätze verwalten - Amazon Grundgestein AgentCore

Beispiele für Datensätze verwalten

Sobald ein Datensatz ACTIVE den Status erreicht hat, können Sie Beispiele im Entwurf hinzufügen, aktualisieren, löschen und auflisten. Alle Beispielmutationen sind asynchron (HTTP 202) und verwenden Alles-oder-Nichts-Semantik. Wenn keine Beispiel-ID gefunden wird, schlägt der gesamte Batch mit fehl. ResourceNotFoundException

Maximal 1.000 Beispiele pro Anfrage. Limit für Inline-Inhalte: 5 MB.

AddDatasetExamples

Die folgenden Beispiele zeigen, wie Sie einem Datensatz Beispiele hinzufügen können:

Beispiel
AgentCore CLI
  1. Um Beispiele mit der AgentCore CLI hinzuzufügen, hängen Sie neue Szenarien an Ihre lokale JSONL-Datei an und stellen Sie sie dann erneut bereit:

    # Edit agentcore/datasets/my_eval_dataset.jsonl — add new lines agentcore deploy

    Die Bereitstellung erkennt neue Szenarien in Ihrer JSONL-Datei und fügt sie dem Service hinzu. Nur der Diff wird angewendet — bestehende Beispiele werden nicht erneut hochgeladen.

    Anmerkung

    Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mitagentcore 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

Jeder Eintrag muss Felder exampleId sowie die aktualisierten Inhaltsfelder enthalten. Der Datensatz muss den UPDATE_FAILED Status ACTIVE oder haben.

Die folgenden Beispiele zeigen, wie Sie Beispiele für Datensätze aktualisieren können:

Beispiel
AgentCore CLI
  1. Um Beispiele mit der AgentCore CLI zu aktualisieren, ändern Sie bestehende Szenarien in Ihrer lokalen JSONL-Datei und stellen Sie sie dann erneut bereit:

    # Edit agentcore/datasets/my_eval_dataset.jsonl — modify existing lines agentcore deploy

    Bei der Bereitstellung wird Ihre lokale Datei mit dem Service verglichen und die geänderten Beispiele aktualisiert. Jede Zeile muss ihre beibehalten, exampleId damit der Service sie als Update und nicht als neues Beispiel erkennt.

    Anmerkung

    Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mitagentcore 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

Der Datensatz muss den CREATE_FAILED Status ACTIVEUPDATE_FAILED, oder haben.

Die folgenden Beispiele zeigen, wie Sie Datensätze löschen können:

Beispiel
AgentCore CLI
  1. Um Beispiele mit der AgentCore CLI zu löschen, entfernen Sie die entsprechenden Zeilen aus Ihrer lokalen JSONL-Datei und stellen Sie sie dann erneut bereit:

    # Edit agentcore/datasets/my_eval_dataset.jsonl — remove lines agentcore deploy

    Die Bereitstellung erkennt entfernte Szenarien und löscht sie aus dem Service.

    Anmerkung

    Führen Sie dies in einem AgentCore Projektverzeichnis aus (erstellt mitagentcore 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

Gibt eine paginierte Liste von Beispielen mit vollständigem Inhalt zurück. Liest standardmäßig aus dem Entwurf. Geben Sie datasetVersion an, dass aus einer veröffentlichten Version gelesen werden soll.

Die folgenden Beispiele zeigen, wie Datensatzbeispiele aufgelistet werden:

Beispiel
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