Bedrock Agent¶
Client¶
AsyncBedrockAgentClient
¶
AsyncBedrockAgentClient(config: AsyncBedrockAgentConfig | None = None, plugins: list[Plugin] | None = None)
Describes the API operations for creating and managing Amazon Bedrock agents.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
config
|
AsyncBedrockAgentConfig | None
|
Optional configuration for the client. Here you can set things like the endpoint for HTTP services or auth credentials. |
None
|
plugins
|
list[Plugin] | None
|
A list of callables applied once to the client's base configuration. Their changes are inherited by every operation invocation. |
None
|
Operations¶
associate_agent_collaboratorassociate_agent_knowledge_basecreate_agentcreate_agent_action_groupcreate_agent_aliascreate_data_sourcecreate_flowcreate_flow_aliascreate_flow_versioncreate_knowledge_basecreate_promptcreate_prompt_versiondelete_agentdelete_agent_action_groupdelete_agent_aliasdelete_agent_versiondelete_data_sourcedelete_flowdelete_flow_aliasdelete_flow_versiondelete_knowledge_basedelete_knowledge_base_documentsdelete_promptdelete_resource_policydisassociate_agent_collaboratordisassociate_agent_knowledge_baseget_agentget_agent_action_groupget_agent_aliasget_agent_collaboratorget_agent_knowledge_baseget_agent_versionget_data_sourceget_flowget_flow_aliasget_flow_versionget_ingestion_jobget_knowledge_baseget_knowledge_base_documentsget_promptget_resource_policyingest_knowledge_base_documentslist_agent_action_groupslist_agent_aliaseslist_agent_collaboratorslist_agent_knowledge_baseslist_agent_versionslist_agentslist_data_sourceslist_flow_aliaseslist_flow_versionslist_flowslist_ingestion_jobslist_knowledge_base_documentslist_knowledge_baseslist_promptslist_tags_for_resourceprepare_agentprepare_flowput_resource_policystart_ingestion_jobstop_ingestion_jobtag_resourceuntag_resourceupdate_agentupdate_agent_action_groupupdate_agent_aliasupdate_agent_collaboratorupdate_agent_knowledge_baseupdate_data_sourceupdate_flowupdate_flow_aliasupdate_knowledge_baseupdate_promptvalidate_flow_definition
Configuration¶
AsyncBedrockAgentConfig
dataclass
¶
Bases: AsyncAwsConfig
Bedrock Agent configuration (async-resolved).
Attributes¶
auth_scheme_resolver
class-attribute
instance-attribute
¶
An auth scheme resolver that determines the auth scheme for each operation.
auth_schemes
class-attribute
instance-attribute
¶
A map of auth scheme ids to auth schemes.
aws_access_key_id
class-attribute
instance-attribute
¶
aws_access_key_id: str | None = None
The identifier for a secret access key.
aws_credentials_identity_resolver
class-attribute
instance-attribute
¶
aws_credentials_identity_resolver: IdentityResolver[AWSCredentialsIdentity, AWSIdentityProperties] | None = None
Resolves AWS Credentials. Required for operations that use Sigv4 Auth.
aws_secret_access_key
class-attribute
instance-attribute
¶
aws_secret_access_key: str | None = None
A secret access key that can be used to sign requests.
aws_session_token
class-attribute
instance-attribute
¶
aws_session_token: str | None = None
The session token used with temporary AWS credentials.
endpoint_resolver
class-attribute
instance-attribute
¶
The endpoint resolver used to resolve the final endpoint per-operation based on the configuration.
interceptors
class-attribute
instance-attribute
¶
The list of interceptors, which are hooks that are called during the execution of a request.
protocol
class-attribute
instance-attribute
¶
The protocol to serialize and deserialize requests with.
region
class-attribute
instance-attribute
¶
region: str | None = None
The AWS region to connect to. The configured region is used to determine the service endpoint.
sdk_ua_app_id
class-attribute
instance-attribute
¶
sdk_ua_app_id: str | None = None
A unique and opaque application ID that is appended to the User-Agent header.
user_agent_extra
class-attribute
instance-attribute
¶
user_agent_extra: str | None = None
Additional suffix to be added to the User-Agent header.
Methods:¶
resolve
async
classmethod
¶
resolve(*, profile: str | None = None, fs: FileSystem | None = None, config_file_path: str | None = None, credentials_file_path: str | None = None, **overrides: Unpack[_AsyncBedrockAgentConfigOverrides]) -> Self
Resolve config from environment, config files, defaults, and explicit overrides.
Plugin
module-attribute
¶
Plugin: TypeAlias = Callable[[AsyncBedrockAgentConfig], None]
A callable that customizes a client configuration. Service-level plugins are applied once to the base configuration inherited by every operation. Operation-level plugins apply only to a single operation invocation.
Structures¶
ActionGroupSummaryAgentAgentActionGroupAgentAliasAgentAliasHistoryEventAgentAliasRoutingConfigurationListItemAgentAliasSummaryAgentCollaboratorAgentCollaboratorSummaryAgentDescriptorAgentFlowNodeConfigurationAgentKnowledgeBaseAgentKnowledgeBaseSummaryAgentSummaryAgentVersionAgentVersionSummaryAnyToolChoiceAudioConfigurationAudioExtractionConfigurationAudioSegmentationConfigurationAutoToolChoiceBedrockDataAutomationConfigurationBedrockEmbeddingModelConfigurationBedrockFoundationModelConfigurationBedrockFoundationModelContextEnrichmentConfigurationByteContentDocCachePointBlockChatPromptTemplateConfigurationChunkingConfigurationCollectorFlowNodeConfigurationConditionFlowNodeConfigurationConfluenceCrawlerConfigurationConfluenceDataSourceConfigurationConfluenceSourceConfigurationContextEnrichmentConfigurationCrawlFilterConfigurationCuratedQueryCustomContentCustomDocumentIdentifierCustomOrchestrationCustomS3LocationCustomTransformationConfigurationCyclicConnectionFlowValidationDetailsDataSourceDataSourceConfigurationDataSourceSummaryDeletionProtectionConfigurationDocumentAccessControlEntryDocumentContentDocumentIdentifierDocumentMetadataDuplicateConditionExpressionFlowValidationDetailsDuplicateConnectionsFlowValidationDetailsEmbeddingModelConfigurationEnrichmentStrategyConfigurationFieldForRerankingFixedSizeChunkingConfigurationFlowAliasConcurrencyConfigurationFlowAliasRoutingConfigurationListItemFlowAliasSummaryFlowConditionFlowConditionalConnectionConfigurationFlowConnectionFlowDataConnectionConfigurationFlowDefinitionFlowNodeFlowNodeInputFlowNodeOutputFlowSummaryFlowValidationFlowVersionSummaryFunctionGuardrailConfigurationHierarchicalChunkingConfigurationHierarchicalChunkingLevelConfigurationImageExtractionConfigurationIncompatibleConnectionDataTypeFlowValidationDetailsInferenceConfigurationIngestionJobIngestionJobFilterIngestionJobSortByIngestionJobStatisticsIngestionJobSummaryInlineCodeFlowNodeConfigurationInlineContentInputFlowNodeConfigurationIntermediateStorageInvalidLoopBoundaryFlowValidationDetailsIteratorFlowNodeConfigurationKendraKnowledgeBaseConfigurationKnowledgeBaseKnowledgeBaseConfigurationKnowledgeBaseDocumentKnowledgeBaseDocumentDetailKnowledgeBaseFlowNodeConfigurationKnowledgeBaseOrchestrationConfigurationKnowledgeBasePromptTemplateKnowledgeBaseSummaryLambdaFunctionFlowNodeConfigurationLexFlowNodeConfigurationLoopControllerFlowNodeConfigurationLoopFlowNodeConfigurationLoopIncompatibleNodeTypeFlowValidationDetailsLoopInputFlowNodeConfigurationMalformedConditionExpressionFlowValidationDetailsMalformedNodeInputExpressionFlowValidationDetailsManagedKnowledgeBaseConfigurationManagedKnowledgeBaseConnectorConfigurationMediaExtractionConfigurationMemoryConfigurationMessageMetadataAttributeMetadataAttributeValueMetadataConfigurationForRerankingMismatchedNodeInputTypeFlowValidationDetailsMismatchedNodeOutputTypeFlowValidationDetailsMissingConnectionConfigurationFlowValidationDetailsMissingDefaultConditionFlowValidationDetailsMissingEndingNodesFlowValidationDetailsMissingLoopControllerNodeFlowValidationDetailsMissingLoopInputNodeFlowValidationDetailsMissingNodeConfigurationFlowValidationDetailsMissingNodeInputFlowValidationDetailsMissingNodeOutputFlowValidationDetailsMissingStartingNodesFlowValidationDetailsMongoDbAtlasConfigurationMongoDbAtlasFieldMappingMultipleLoopControllerNodesFlowValidationDetailsMultipleLoopInputNodesFlowValidationDetailsMultipleNodeInputConnectionsFlowValidationDetailsNeptuneAnalyticsConfigurationNeptuneAnalyticsFieldMappingOpenSearchManagedClusterConfigurationOpenSearchManagedClusterFieldMappingOpenSearchServerlessConfigurationOpenSearchServerlessFieldMappingOutputFlowNodeConfigurationParameterDetailParsingConfigurationParsingPromptPatternObjectFilterPatternObjectFilterConfigurationPerformanceConfigurationPineconeConfigurationPineconeFieldMappingPromptAgentResourcePromptConfigurationPromptFlowNodeConfigurationPromptFlowNodeInlineConfigurationPromptFlowNodeResourceConfigurationPromptInputVariablePromptMetadataEntryPromptModelInferenceConfigurationPromptOverrideConfigurationPromptSummaryPromptVariantQueryGenerationColumnQueryGenerationConfigurationQueryGenerationContextQueryGenerationTableRdsConfigurationRdsFieldMappingRedisEnterpriseCloudConfigurationRedisEnterpriseCloudFieldMappingRedshiftConfigurationRedshiftProvisionedAuthConfigurationRedshiftProvisionedConfigurationRedshiftQueryEngineAwsDataCatalogStorageConfigurationRedshiftQueryEngineConfigurationRedshiftQueryEngineRedshiftStorageConfigurationRedshiftQueryEngineStorageConfigurationRedshiftServerlessAuthConfigurationRedshiftServerlessConfigurationRetrievalFlowNodeConfigurationRetrievalFlowNodeS3ConfigurationS3ContentS3DataSourceConfigurationS3IdentifierS3LocationS3VectorsConfigurationSalesforceCrawlerConfigurationSalesforceDataSourceConfigurationSalesforceSourceConfigurationSeedUrlSemanticChunkingConfigurationServerSideEncryptionConfigurationSessionSummaryConfigurationSharePointCrawlerConfigurationSharePointDataSourceConfigurationSharePointSourceConfigurationSpecificToolChoiceSqlKnowledgeBaseConfigurationStorageConfigurationStorageFlowNodeConfigurationStorageFlowNodeS3ConfigurationSupplementalDataStorageConfigurationSupplementalDataStorageLocationTextContentDocTextPromptTemplateConfigurationToolConfigurationToolSpecificationTransformationTransformationFunctionTransformationLambdaConfigurationUnfulfilledNodeInputFlowValidationDetailsUnknownConnectionConditionFlowValidationDetailsUnknownConnectionSourceFlowValidationDetailsUnknownConnectionSourceOutputFlowValidationDetailsUnknownConnectionTargetFlowValidationDetailsUnknownConnectionTargetInputFlowValidationDetailsUnknownNodeInputFlowValidationDetailsUnknownNodeOutputFlowValidationDetailsUnreachableNodeFlowValidationDetailsUnsatisfiedConnectionConditionsFlowValidationDetailsUnspecifiedFlowValidationDetailsUrlConfigurationValidationExceptionFieldVectorIngestionConfigurationVectorKnowledgeBaseConfigurationVectorSearchBedrockRerankingConfigurationVectorSearchBedrockRerankingModelConfigurationVectorSearchRerankingConfigurationVideoConfigurationVideoExtractionConfigurationVideoSegmentationConfigurationWebCrawlerConfigurationWebCrawlerLimitsWebDataSourceConfigurationWebSourceConfiguration
Errors¶
AccessDeniedExceptionConflictExceptionInternalServerExceptionResourceNotFoundExceptionServiceErrorServiceQuotaExceededExceptionThrottlingExceptionValidationException
Unions¶
APISchemaActionGroupExecutorContentBlockFlowConnectionConfigurationFlowNodeConfigurationFlowValidationDetailsFunctionSchemaOrchestrationExecutorPromptFlowNodeSourceConfigurationPromptGenAiResourcePromptInferenceConfigurationPromptTemplateConfigurationRerankingMetadataSelectiveModeConfigurationRetrievalFlowNodeServiceConfigurationStorageFlowNodeServiceConfigurationSystemContentBlockToolToolChoiceToolInputSchema
Enums¶
AccessControlAccessAccessControlPrincipalTypeActionGroupSignatureActionGroupStateAgentAliasStatusAgentCollaborationAgentStatusAliasInvocationStateCachePointTypeChunkingStrategyConcurrencyTypeConfluenceAuthTypeConfluenceHostTypeContentDataSourceTypeContextEnrichmentTypeConversationRoleCrawlFilterConfigurationTypeCreationModeCustomControlMethodCustomSourceTypeDataDeletionPolicyDataSourceStatusDataSourceTypeDocumentStatusEmbeddingDataTypeEmbeddingModelTypeEnabledOrDisabledStateEnrichmentStrategyMethodFlowConnectionTypeFlowNodeIODataTypeFlowNodeInputCategoryFlowNodeTypeFlowStatusFlowValidationSeverityFlowValidationTypeIncludeExcludeIncludedDataIncompatibleLoopNodeTypeIngestionJobFilterAttributeIngestionJobFilterOperatorIngestionJobSortByAttributeIngestionJobStatusInlineContentTypeKnowledgeBaseStateKnowledgeBaseStatusKnowledgeBaseStorageTypeKnowledgeBaseTypeMemoryTypeMetadataSourceTypeMetadataValueTypeOrchestrationTypeParsingModalityParsingStrategyPerformanceConfigLatencyPromptStatePromptTemplateTypePromptTypeQueryEngineTypeRedshiftProvisionedAuthTypeRedshiftQueryEngineStorageTypeRedshiftQueryEngineTypeRedshiftServerlessAuthTypeRelayConversationHistoryRequireConfirmationRerankingMetadataSelectionModeSalesforceAuthTypeSharePointAuthTypeSharePointHostTypeSortOrderStepTypeSupplementalDataStorageLocationTypeSupportedLanguagesTypeVectorSearchRerankingConfigurationTypeWebScopeType