2026/11/17 - Amazon Bedrock AgentCore Control - 3 new 4 updated api methods
Changes Adds support for continuous insights and automatic dataset generation
Updates the enablement status or encryption configuration of an Agent Insight Store.
See also: AWS API Documentation
Request Syntax
client.update_agent_insight_store(
clientToken='string',
agentInsightStoreId='string',
enablementStatus='ENABLED'|'DISABLED',
encryptionConfiguration={
'mode': 'AWS_OWNED_KMS_KEY'|'CUSTOMER_MANAGED_KMS',
'kmsKeyArn': 'string'
}
)
string
A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If you don't specify this field, a value is randomly generated for you. If this token matches a previous request, the service ignores the request, but doesn't return an error. For more information, see Ensuring idempotency.
This field is autopopulated if not provided.
string
[REQUIRED]
Specifies the unique identifier of the Agent Insight Store to update.
string
Specifies whether the Agent Insight Store accepts new Agent Insights. If you don't specify this parameter, the store's current enablement setting remains unchanged.
dict
Specifies the encryption mode and key configuration to use for new Agent Insights. If you don't specify this parameter, the store's current encryption configuration remains unchanged.
mode (string) -- [REQUIRED]
Specifies the encryption mode used to protect new Agent Insights.
kmsKeyArn (string) --
Specifies the Amazon Resource Name (ARN) of the customer managed AWS KMS key that you use to encrypt new Agent Insights. This field is required when mode is CUSTOMER_MANAGED_KMS and cannot be specified when mode is AWS_OWNED_KMS_KEY.
dict
Response Syntax
{
'agentInsightStoreArn': 'string',
'agentInsightStoreId': 'string',
'status': 'ACTIVE'|'UPDATING'|'INACTIVE'|'ERROR',
'enablementStatus': 'ENABLED'|'DISABLED',
'updatedAt': datetime(2015, 1, 1),
'failureReason': 'string'
}
Response Structure
(dict) --
agentInsightStoreArn (string) --
The Amazon Resource Name (ARN) of the updated Agent Insight Store.
agentInsightStoreId (string) --
The unique identifier of the updated Agent Insight Store.
status (string) --
The lifecycle status of the Agent Insight Store after the update request. Valid values:
ACTIVE
The store is available.
UPDATING
The service is applying a requested change.
INACTIVE
The store does not accept new Agent Insights.
ERROR
The store requires intervention.
enablementStatus (string) --
Specifies whether the Agent Insight Store accepts new Agent Insights after the update request.
updatedAt (datetime) --
The date and time when the Agent Insight Store was last updated.
failureReason (string) --
Describes the failure that prevented the Agent Insight Store from reaching its requested lifecycle status.
Returns the account's service-defined default Agent Insight Store. The logical default exists for every enrolled account; its backing state may be initialized on first access.
See also: AWS API Documentation
Request Syntax
client.get_agent_insight_store(
agentInsightStoreId='string'
)
string
[REQUIRED]
Specifies the unique identifier of the Agent Insight Store to retrieve.
dict
Response Syntax
{
'agentInsightStoreArn': 'string',
'agentInsightStoreId': 'string',
'status': 'ACTIVE'|'UPDATING'|'INACTIVE'|'ERROR',
'enablementStatus': 'ENABLED'|'DISABLED',
'encryptionConfiguration': {
'mode': 'AWS_OWNED_KMS_KEY'|'CUSTOMER_MANAGED_KMS',
'kmsKeyArn': 'string'
},
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReason': 'string'
}
Response Structure
(dict) --
agentInsightStoreArn (string) --
The Amazon Resource Name (ARN) of the Agent Insight Store.
agentInsightStoreId (string) --
The unique identifier of the Agent Insight Store.
status (string) --
The current lifecycle status of the Agent Insight Store. Valid values:
ACTIVE
The store is available.
UPDATING
The service is applying a requested change.
INACTIVE
The store does not accept new Agent Insights.
ERROR
The store requires intervention.
enablementStatus (string) --
Specifies whether the Agent Insight Store accepts new Agent Insights. The default value is enabled.
encryptionConfiguration (dict) --
Specifies the encryption mode and key configuration that encrypts new Agent Insights and protects the data at rest.
mode (string) --
Specifies the encryption mode used to protect new Agent Insights.
kmsKeyArn (string) --
Specifies the Amazon Resource Name (ARN) of the customer managed AWS KMS key that you use to encrypt new Agent Insights. This field is required when mode is CUSTOMER_MANAGED_KMS and cannot be specified when mode is AWS_OWNED_KMS_KEY.
createdAt (datetime) --
The date and time when the Agent Insight Store was created.
updatedAt (datetime) --
The date and time when the Agent Insight Store was last updated.
failureReason (string) --
Describes the failure that prevented the Agent Insight Store from reaching its requested lifecycle status.
Lists the account's service-defined default Agent Insight Store. The singleton backing state may be initialized on first access.
See also: AWS API Documentation
Request Syntax
client.list_agent_insight_stores(
nextToken='string',
maxResults=123
)
string
If the total number of results is greater than the maxResults value provided in the request, enter the token returned in the nextToken field in the response in this field to return the next batch of results.
integer
The maximum number of results to return in the response. If the total number of results is greater than this value, use the token returned in the response in the nextToken field when making another request to return the next batch of results.
dict
Response Syntax
{
'agentInsightStores': [
{
'agentInsightStoreArn': 'string',
'agentInsightStoreId': 'string',
'status': 'ACTIVE'|'UPDATING'|'INACTIVE'|'ERROR',
'enablementStatus': 'ENABLED'|'DISABLED',
'encryptionConfiguration': {
'mode': 'AWS_OWNED_KMS_KEY'|'CUSTOMER_MANAGED_KMS',
'kmsKeyArn': 'string'
},
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
agentInsightStores (list) --
The Agent Insight Store summaries.
(dict) --
Contains summary information about an Agent Insight Store.
agentInsightStoreArn (string) --
The Amazon Resource Name (ARN) of the Agent Insight Store.
agentInsightStoreId (string) --
The unique identifier of the Agent Insight Store.
status (string) --
The current lifecycle status of the Agent Insight Store. Valid values:
ACTIVE
The store is available.
UPDATING
The service is applying a requested change.
INACTIVE
The store does not accept new Agent Insights.
ERROR
The store requires intervention.
enablementStatus (string) --
Specifies whether the Agent Insight Store accepts new Agent Insights. The default value is enabled.
encryptionConfiguration (dict) --
Specifies the encryption mode and key configuration that encrypts new Agent Insights and protects the data at rest.
mode (string) --
Specifies the encryption mode used to protect new Agent Insights.
kmsKeyArn (string) --
Specifies the Amazon Resource Name (ARN) of the customer managed AWS KMS key that you use to encrypt new Agent Insights. This field is required when mode is CUSTOMER_MANAGED_KMS and cannot be specified when mode is AWS_OWNED_KMS_KEY.
createdAt (datetime) --
The date and time when the Agent Insight Store was created.
updatedAt (datetime) --
The date and time when the Agent Insight Store was last updated.
nextToken (string) --
If the total number of results is greater than the maxResults value provided in the request, use this token when making another request in the nextToken field to return the next batch of results.
{'exampleCountByField': {'actorProfile': 'long',
'input': 'long',
'turns': 'long'}}
Retrieves dataset metadata. Use the datasetVersion query parameter to retrieve a specific version's metadata. If absent, defaults to DRAFT. For paginated example content, use ListDatasetExamples.
See also: AWS API Documentation
Request Syntax
client.get_dataset(
datasetId='string',
datasetVersion='string'
)
string
[REQUIRED]
The unique identifier of the dataset to retrieve.
string
Version to retrieve: "DRAFT" or a version number. Defaults to DRAFT if absent.
dict
Response Syntax
{
'datasetArn': 'string',
'datasetId': 'string',
'datasetVersion': 'string',
'datasetName': 'string',
'description': 'string',
'status': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED',
'draftStatus': 'MODIFIED'|'UNMODIFIED',
'failureReason': 'string',
'schemaType': 'AGENTCORE_EVALUATION_PREDEFINED_V1'|'AGENTCORE_EVALUATION_SIMULATED_V1'|'THIRD_PARTY_EVALUATION_V1',
'kmsKeyArn': 'string',
'exampleCount': 123,
'exampleCountByField': {
'turns': 123,
'input': 123,
'actorProfile': 123
},
'downloadUrl': 'string',
'downloadUrlExpiresAt': datetime(2015, 1, 1),
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'tags': {
'string': 'string'
}
}
Response Structure
(dict) --
datasetArn (string) --
The Amazon Resource Name (ARN) of the dataset.
datasetId (string) --
The unique identifier of the dataset.
datasetVersion (string) --
The resolved version: "DRAFT" (default) or the requested version number.
datasetName (string) --
The name of the dataset.
description (string) --
The description of the dataset.
status (string) --
The current status of the dataset.
draftStatus (string) --
Publish synchronization state. Only authoritative when status is ACTIVE. MODIFIED indicates DRAFT has unpublished changes. UNMODIFIED indicates DRAFT matches the latest published version.
failureReason (string) --
Populated when status is CREATE_FAILED, UPDATE_FAILED, or DELETE_FAILED. Describes the reason for the failure.
schemaType (string) --
The schema type declared at create time. Immutable after creation.
kmsKeyArn (string) --
KMS key ARN used for server-side encryption on service Amazon S3 writes, if configured.
exampleCount (integer) --
The number of examples in the DRAFT.
exampleCountByField (dict) --
The number of examples that have each field, for the resolved version. Absent when the counts are unknown.
turns (integer) --
The number of examples that have turns.
input (integer) --
The number of examples that have input.
actorProfile (integer) --
The number of examples that have actor_profile.
downloadUrl (string) --
Presigned Amazon S3 URL to download the consolidated dataset file for the resolved version. Expires after 5 minutes. Omitted if the file does not yet exist.
downloadUrlExpiresAt (datetime) --
Expiry timestamp for the download URL.
createdAt (datetime) --
The timestamp when the dataset was created.
updatedAt (datetime) --
The timestamp when the dataset was last updated.
tags (dict) --
The tags associated with the dataset.
(string) --
(string) --
{'filter': {'exampleFields': [{'anyOf': ['TURNS | INPUT | ACTOR_PROFILE']}],
'generationIds': ['string']}}
Returns paginated examples from the dataset. The server embeds the resolved version in the pagination token. Once pagination begins, all subsequent pages are pinned to that version regardless of concurrent mutations. A request with a pagination token can omit datasetVersion. If it sets a version that differs from the token's version, the request fails with a ValidationException.
See also: AWS API Documentation
Request Syntax
client.list_dataset_examples(
datasetId='string',
datasetVersion='string',
filter={
'generationIds': [
'string',
],
'exampleFields': [
{
'anyOf': [
'TURNS'|'INPUT'|'ACTOR_PROFILE',
]
},
]
},
maxResults=123,
nextToken='string'
)
string
[REQUIRED]
The unique identifier of the dataset.
string
Version to paginate: "DRAFT" or a version number. Defaults to DRAFT if absent on the first request. With a pagination token, the version comes from the token: you can omit this member, and a value that differs from the token's version is rejected with a ValidationException.
dict
A filter to apply to the examples.
generationIds (list) --
Returns only examples created by this dataset generation. Specify one ID.
(string) --
exampleFields (list) --
Returns only examples that meet at least one of these conditions. Examples last written before example field filtering was available never match.
(dict) --
A condition on the fields of an example.
anyOf (list) --
Matches examples that have at least one of these fields. Required.
(string) --
A field that a dataset example can have.
integer
Maximum number of examples to return per page.
string
The token for the next page of results.
dict
Response Syntax
{
'datasetArn': 'string',
'datasetId': 'string',
'datasetVersion': 'string',
'examples': [
{...}|[...]|123|123.4|'string'|True|None,
],
'nextToken': 'string'
}
Response Structure
(dict) --
datasetArn (string) --
The Amazon Resource Name (ARN) of the dataset.
datasetId (string) --
The unique identifier of the dataset.
datasetVersion (string) --
The version returned.
examples (list) --
Paginated example content. Each element is a JSON object containing at least an exampleId field plus the schema-specific content fields.
(:ref:`document<document>`) --
nextToken (string) --
The token for the next page of results, or null if there are no more results.
{'filter': {'exampleCountByField': [{'anyOf': ['TURNS | INPUT | ACTOR_PROFILE'],
'max': 'long',
'min': 'long'}]}}
Response {'versions': {'exampleCountByField': {'actorProfile': 'long',
'input': 'long',
'turns': 'long'}}}
Lists all published versions of a dataset, sorted by version number descending (newest first). Does not include the DRAFT working copy.
See also: AWS API Documentation
Request Syntax
client.list_dataset_versions(
datasetId='string',
filter={
'exampleCountByField': [
{
'anyOf': [
'TURNS'|'INPUT'|'ACTOR_PROFILE',
],
'min': 123,
'max': 123
},
]
},
nextToken='string',
maxResults=123
)
string
[REQUIRED]
The unique identifier of the dataset.
dict
A filter to apply to the dataset versions.
exampleCountByField (list) --
Returns only versions whose example counts meet at least one of these conditions.
(dict) --
A condition on the number of examples that have the given fields. The count includes each example that has at least one of the fields in anyOf.
anyOf (list) --
The fields to count. An example counts if it has at least one of these fields. Required.
(string) --
A field that a dataset example can have.
min (integer) --
The minimum count, inclusive.
max (integer) --
The maximum count, inclusive.
string
The token for the next page of results.
integer
The maximum number of versions to return per page.
dict
Response Syntax
{
'versions': [
{
'datasetVersion': 'string',
'exampleCount': 123,
'exampleCountByField': {
'turns': 123,
'input': 123,
'actorProfile': 123
},
'createdAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
versions (list) --
The list of published dataset versions.
(dict) --
Summary information about a published dataset version.
datasetVersion (string) --
The version number of this published snapshot.
exampleCount (integer) --
The number of examples in this version.
exampleCountByField (dict) --
The number of examples that have each field, for this version. Absent when the counts are unknown.
turns (integer) --
The number of examples that have turns.
input (integer) --
The number of examples that have input.
actorProfile (integer) --
The number of examples that have actor_profile.
createdAt (datetime) --
The timestamp when this version was published.
nextToken (string) --
The token for the next page of results, or null if there are no more results.
{'filter': {'exampleCountByField': [{'anyOf': ['TURNS | INPUT | ACTOR_PROFILE'],
'max': 'long',
'min': 'long'}]}}
Response {'datasets': {'exampleCountByField': {'actorProfile': 'long',
'input': 'long',
'turns': 'long'}}}
Lists all datasets in the caller's account, paginated.
See also: AWS API Documentation
Request Syntax
client.list_datasets(
filter={
'exampleCountByField': [
{
'anyOf': [
'TURNS'|'INPUT'|'ACTOR_PROFILE',
],
'min': 123,
'max': 123
},
]
},
nextToken='string',
maxResults=123
)
dict
A filter to apply to the datasets.
exampleCountByField (list) --
Returns only datasets whose DRAFT example counts meet at least one of these conditions.
(dict) --
A condition on the number of examples that have the given fields. The count includes each example that has at least one of the fields in anyOf.
anyOf (list) --
The fields to count. An example counts if it has at least one of these fields. Required.
(string) --
A field that a dataset example can have.
min (integer) --
The minimum count, inclusive.
max (integer) --
The maximum count, inclusive.
string
The token for the next page of results.
integer
The maximum number of datasets to return per page.
dict
Response Syntax
{
'datasets': [
{
'datasetArn': 'string',
'datasetId': 'string',
'datasetName': 'string',
'description': 'string',
'status': 'CREATING'|'UPDATING'|'DELETING'|'ACTIVE'|'CREATE_FAILED'|'UPDATE_FAILED'|'DELETE_FAILED',
'draftStatus': 'MODIFIED'|'UNMODIFIED',
'schemaType': 'AGENTCORE_EVALUATION_PREDEFINED_V1'|'AGENTCORE_EVALUATION_SIMULATED_V1'|'THIRD_PARTY_EVALUATION_V1',
'exampleCount': 123,
'exampleCountByField': {
'turns': 123,
'input': 123,
'actorProfile': 123
},
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1)
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
datasets (list) --
The list of datasets.
(dict) --
Summary information about a dataset.
datasetArn (string) --
The Amazon Resource Name (ARN) of the dataset.
datasetId (string) --
The unique identifier of the dataset.
datasetName (string) --
The name of the dataset.
description (string) --
The description of the dataset.
status (string) --
The current status of the dataset.
draftStatus (string) --
Publish synchronization state. Only authoritative when status is ACTIVE.
schemaType (string) --
The schema type of the dataset.
exampleCount (integer) --
The number of examples in the dataset.
exampleCountByField (dict) --
The number of examples that have each field, for the DRAFT. Absent when the counts are unknown.
turns (integer) --
The number of examples that have turns.
input (integer) --
The number of examples that have input.
actorProfile (integer) --
The number of examples that have actor_profile.
createdAt (datetime) --
The timestamp when the dataset was created.
updatedAt (datetime) --
The timestamp when the dataset was last updated.
nextToken (string) --
The token for the next page of results, or null if there are no more results.