Class: Aws::BedrockAgent::Client

Inherits:
Seahorse::Client::Base
  • Object
show all
Includes:
ClientStubs
Defined in:
lib/aws-sdk-bedrockagent/client.rb

Overview

An API client for BedrockAgent. To construct a client, you need to configure a ‘:region` and `:credentials`.

client = Aws::BedrockAgent::Client.new(
  region: region_name,
  credentials: credentials,
  # ...
)

For details on configuring region and credentials see the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).

See #initialize for a full list of supported configuration options.

Class Attribute Summary collapse

API Operations collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options) ⇒ Client

Returns a new instance of Client.

Parameters:

  • options (Hash)

Options Hash (options):

  • :credentials (required, Aws::CredentialProvider) —

    Your AWS credentials. This can be an instance of any one of the following classes:

    • ‘Aws::Credentials` - Used for configuring static, non-refreshing credentials.

    • ‘Aws::SharedCredentials` - Used for loading static credentials from a shared file, such as `~/.aws/config`.

    • ‘Aws::AssumeRoleCredentials` - Used when you need to assume a role.

    • ‘Aws::AssumeRoleWebIdentityCredentials` - Used when you need to assume a role after providing credentials via the web.

    • ‘Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an access token generated from `aws login`.

    • ‘Aws::ProcessCredentials` - Used for loading credentials from a process that outputs to stdout.

    • ‘Aws::InstanceProfileCredentials` - Used for loading credentials from an EC2 IMDS on an EC2 instance.

    • ‘Aws::ECSCredentials` - Used for loading credentials from instances running in ECS.

    • ‘Aws::CognitoIdentityCredentials` - Used for loading credentials from the Cognito Identity service.

    When ‘:credentials` are not configured directly, the following locations will be searched for credentials:

    • ‘Aws.config`

    • The ‘:access_key_id`, `:secret_access_key`, and `:session_token` options.

    • ENV, ENV

    • ‘~/.aws/credentials`

    • ‘~/.aws/config`

    • EC2/ECS IMDS instance profile - When used by default, the timeouts are very aggressive. Construct and pass an instance of ‘Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to enable retries and extended timeouts. Instance profile credential fetching can be disabled by setting ENV to true.

  • :region (required, String) —

    The AWS region to connect to. The configured ‘:region` is used to determine the service `:endpoint`. When not passed, a default `:region` is searched for in the following locations:

  • :access_key_id (String)
  • :active_endpoint_cache (Boolean) — default: false —

    When set to ‘true`, a thread polling for endpoints will be running in the background every 60 secs (default). Defaults to `false`.

  • :adaptive_retry_wait_to_fill (Boolean) — default: true —

    Used only in ‘adaptive` retry mode. When true, the request will sleep until there is sufficent client side capacity to retry the request. When false, the request will raise a `RetryCapacityNotAvailableError` and will not retry instead of sleeping.

  • :client_side_monitoring (Boolean) — default: false —

    When ‘true`, client-side metrics will be collected for all API requests from this client.

  • :client_side_monitoring_client_id (String) — default: "" —

    Allows you to provide an identifier for this client which will be attached to all generated client side metrics. Defaults to an empty string.

  • :client_side_monitoring_host (String) — default: "127.0.0.1" —

    Allows you to specify the DNS hostname or IPv4 or IPv6 address that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_port (Integer) — default: 31000 —

    Required for publishing client metrics. The port that the client side monitoring agent is running on, where client metrics will be published via UDP.

  • :client_side_monitoring_publisher (Aws::ClientSideMonitoring::Publisher) — default: Aws::ClientSideMonitoring::Publisher —

    Allows you to provide a custom client-side monitoring publisher class. By default, will use the Client Side Monitoring Agent Publisher.

  • :convert_params (Boolean) — default: true —

    When ‘true`, an attempt is made to coerce request parameters into the required types.

  • :correct_clock_skew (Boolean) — default: true —

    Used only in ‘standard` and adaptive retry modes. Specifies whether to apply a clock skew correction and retry requests with skewed client clocks.

  • :defaults_mode (String) — default: "legacy" —

    See DefaultsModeConfiguration for a list of the accepted modes and the configuration defaults that are included.

  • :disable_host_prefix_injection (Boolean) — default: false —

    Set to true to disable SDK automatically adding host prefix to default service endpoint when available.

  • :disable_request_compression (Boolean) — default: false —

    When set to ‘true’ the request body will not be compressed for supported operations.

  • :endpoint (String) —

    The client endpoint is normally constructed from the ‘:region` option. You should only configure an `:endpoint` when connecting to test or custom endpoints. This should be a valid HTTP(S) URI.

  • :endpoint_cache_max_entries (Integer) — default: 1000 —

    Used for the maximum size limit of the LRU cache storing endpoints data for endpoint discovery enabled operations. Defaults to 1000.

  • :endpoint_cache_max_threads (Integer) — default: 10 —

    Used for the maximum threads in use for polling endpoints to be cached, defaults to 10.

  • :endpoint_cache_poll_interval (Integer) — default: 60 —

    When :endpoint_discovery and :active_endpoint_cache is enabled, Use this option to config the time interval in seconds for making requests fetching endpoints information. Defaults to 60 sec.

  • :endpoint_discovery (Boolean) — default: false —

    When set to ‘true`, endpoint discovery will be enabled for operations when available.

  • :ignore_configured_endpoint_urls (Boolean) —

    Setting to true disables use of endpoint URLs provided via environment variables and the shared configuration file.

  • :log_formatter (Aws::Log::Formatter) — default: Aws::Log::Formatter.default —

    The log formatter.

  • :log_level (Symbol) — default: :info —

    The log level to send messages to the ‘:logger` at.

  • :logger (Logger) —

    The Logger instance to send log messages to. If this option is not set, logging will be disabled.

  • :max_attempts (Integer) — default: 3 —

    An integer representing the maximum number attempts that will be made for a single request, including the initial attempt. For example, setting this value to 5 will result in a request being retried up to 4 times. Used in ‘standard` and `adaptive` retry modes.

  • :profile (String) — default: "default" —

    Used when loading credentials from the shared credentials file at HOME/.aws/credentials. When not specified, ‘default’ is used.

  • :request_min_compression_size_bytes (Integer) — default: 10240 —

    The minimum size in bytes that triggers compression for request bodies. The value must be non-negative integer value between 0 and 10485780 bytes inclusive.

  • :retry_backoff (Proc) —

    A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay. This option is only used in the ‘legacy` retry mode.

  • :retry_base_delay (Float) — default: 0.3 —

    The base delay in seconds used by the default backoff function. This option is only used in the ‘legacy` retry mode.

  • :retry_jitter (Symbol) — default: :none —

    A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number. This option is only used in the ‘legacy` retry mode.

    @see www.awsarchitectureblog.com/2015/03/backoff.html

  • :retry_limit (Integer) — default: 3 —

    The maximum number of times to retry failed requests. Only ~ 500 level server errors and certain ~ 400 level client errors are retried. Generally, these are throttling errors, data checksum errors, networking errors, timeout errors, auth errors, endpoint discovery, and errors from expired credentials. This option is only used in the ‘legacy` retry mode.

  • :retry_max_delay (Integer) — default: 0 —

    The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function. This option is only used in the ‘legacy` retry mode.

  • :retry_mode (String) — default: "legacy" —

    Specifies which retry algorithm to use. Values are:

    • ‘legacy` - The pre-existing retry behavior. This is default value if no retry mode is provided.

    • ‘standard` - A standardized set of retry rules across the AWS SDKs. This includes support for retry quotas, which limit the number of unsuccessful retries a client can make.

    • ‘adaptive` - An experimental retry mode that includes all the functionality of `standard` mode along with automatic client side throttling. This is a provisional mode that may change behavior in the future.

  • :sdk_ua_app_id (String) —

    A unique and opaque application ID that is appended to the User-Agent header as app/<sdk_ua_app_id>. It should have a maximum length of 50.

  • :secret_access_key (String)
  • :session_token (String)
  • :stub_responses (Boolean) — default: false —

    Causes the client to return stubbed responses. By default fake responses are generated and returned. You can specify the response data to return or errors to raise by calling ClientStubs#stub_responses. See ClientStubs for more information.

    ** Please note ** When response stubbing is enabled, no HTTP requests are made, and retries are disabled.

  • :token_provider (Aws::TokenProvider) —

    A Bearer Token Provider. This can be an instance of any one of the following classes:

    • ‘Aws::StaticTokenProvider` - Used for configuring static, non-refreshing tokens.

    • ‘Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an access token generated from `aws login`.

    When ‘:token_provider` is not configured directly, the `Aws::TokenProviderChain` will be used to search for tokens configured for your profile in shared configuration files.

  • :use_dualstack_endpoint (Boolean) —

    When set to ‘true`, dualstack enabled endpoints (with `.aws` TLD) will be used if available.

  • :use_fips_endpoint (Boolean) —

    When set to ‘true`, fips compatible endpoints will be used if available. When a `fips` region is used, the region is normalized and this config is set to `true`.

  • :validate_params (Boolean) — default: true —

    When ‘true`, request parameters are validated before sending the request.

  • :endpoint_provider (Aws::BedrockAgent::EndpointProvider) —

    The endpoint provider used to resolve endpoints. Any object that responds to ‘#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::BedrockAgent::EndpointParameters`

  • :http_proxy (URI::HTTP, String) —

    A proxy to send requests through. Formatted like ‘proxy.com:123’.

  • :http_open_timeout (Float) — default: 15 —

    The number of seconds to wait when opening a HTTP session before raising a ‘Timeout::Error`.

  • :http_read_timeout (Float) — default: 60 —

    The default number of seconds to wait for response data. This value can safely be set per-request on the session.

  • :http_idle_timeout (Float) — default: 5 —

    The number of seconds a connection is allowed to sit idle before it is considered stale. Stale connections are closed and removed from the pool before making a request.

  • :http_continue_timeout (Float) — default: 1 —

    The number of seconds to wait for a 100-continue response before sending the request body. This option has no effect unless the request has “Expect” header set to “100-continue”. Defaults to ‘nil` which disables this behaviour. This value can safely be set per request on the session.

  • :ssl_timeout (Float) — default: nil —

    Sets the SSL timeout in seconds.

  • :http_wire_trace (Boolean) — default: false —

    When ‘true`, HTTP debug output will be sent to the `:logger`.

  • :ssl_verify_peer (Boolean) — default: true —

    When ‘true`, SSL peer certificates are verified when establishing a connection.

  • :ssl_ca_bundle (String) —

    Full path to the SSL certificate authority bundle file that should be used when verifying peer certificates. If you do not pass ‘:ssl_ca_bundle` or `:ssl_ca_directory` the the system default will be used if available.

  • :ssl_ca_directory (String) —

    Full path of the directory that contains the unbundled SSL certificate authority files for verifying peer certificates. If you do not pass ‘:ssl_ca_bundle` or `:ssl_ca_directory` the the system default will be used if available.



385
386
387
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 385

def initialize(*args)
  super
end

Class Attribute Details

.identifier ⇒ Object (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



2666
2667
2668
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2666

def identifier
  @identifier
end

Class Method Details

.errors_module ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future. 



2669
2670
2671
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2669

def errors_module
  Errors
end

Instance Method Details

#associate_agent_knowledge_base(params = {}) ⇒ Types::AssociateAgentKnowledgeBaseResponse

Associate a Knowledge Base to an existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.associate_agent_knowledge_base({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  knowledge_base_id: "Id", # required
  description: "Description", # required
  knowledge_base_state: "ENABLED", # accepts ENABLED, DISABLED
})

Response structure


resp.agent_knowledge_base.agent_id #=> String
resp.agent_knowledge_base.agent_version #=> String
resp.agent_knowledge_base.knowledge_base_id #=> String
resp.agent_knowledge_base.description #=> String
resp.agent_knowledge_base.created_at #=> Time
resp.agent_knowledge_base.updated_at #=> Time
resp.agent_knowledge_base.knowledge_base_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :description (required, String) —

    Description of the Resource.

  • :knowledge_base_state (String) —

    State of the knowledge base; whether it is enabled or disabled

Returns:

See Also:



436
437
438
439
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 436

def associate_agent_knowledge_base(params = {}, options = {})
  req = build_request(:associate_agent_knowledge_base, params)
  req.send_request(options)
end

#build_request(operation_name, params = {}) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Parameters:

  • params ({}) (defaults to: {}) 


2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2644

def build_request(operation_name, params = {})
  handlers = @handlers.for(operation_name)
  context = Seahorse::Client::RequestContext.new(
    operation_name: operation_name,
    operation: config.api.operation(operation_name),
    client: self,
    params: params,
    config: config)
  context[:gem_name] = 'aws-sdk-bedrockagent'
  context[:gem_version] = '1.0.0'
  Seahorse::Client::Request.new(handlers, context)
end

#create_agent(params = {}) ⇒ Types::CreateAgentResponse

Creates an Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.create_agent({
  agent_name: "Name", # required
  client_token: "ClientToken",
  instruction: "Instruction",
  foundation_model: "ModelIdentifier",
  description: "Description",
  idle_session_ttl_in_seconds: 1,
  agent_resource_role_arn: "AgentRoleArn", # required
  customer_encryption_key_arn: "KmsKeyArn",
  tags: {
    "TagKey" => "TagValue",
  },
  prompt_override_configuration: {
    prompt_configurations: [ # required
      {
        prompt_type: "PRE_PROCESSING", # accepts PRE_PROCESSING, ORCHESTRATION, POST_PROCESSING, KNOWLEDGE_BASE_RESPONSE_GENERATION
        prompt_creation_mode: "DEFAULT", # accepts DEFAULT, OVERRIDDEN
        prompt_state: "ENABLED", # accepts ENABLED, DISABLED
        base_prompt_template: "BasePromptTemplate",
        inference_configuration: {
          temperature: 1.0,
          top_p: 1.0,
          top_k: 1,
          maximum_length: 1,
          stop_sequences: ["String"],
        },
        parser_mode: "DEFAULT", # accepts DEFAULT, OVERRIDDEN
      },
    ],
    override_lambda: "LambdaArn",
  },
})

Response structure


resp.agent.agent_id #=> String
resp.agent.agent_name #=> String
resp.agent.agent_arn #=> String
resp.agent.agent_version #=> String
resp.agent.client_token #=> String
resp.agent.instruction #=> String
resp.agent.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent.foundation_model #=> String
resp.agent.description #=> String
resp.agent.idle_session_ttl_in_seconds #=> Integer
resp.agent.agent_resource_role_arn #=> String
resp.agent.customer_encryption_key_arn #=> String
resp.agent.created_at #=> Time
resp.agent.updated_at #=> Time
resp.agent.prepared_at #=> Time
resp.agent.failure_reasons #=> Array
resp.agent.failure_reasons[0] #=> String
resp.agent.recommended_actions #=> Array
resp.agent.recommended_actions[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_type #=> String, one of "PRE_PROCESSING", "ORCHESTRATION", "POST_PROCESSING", "KNOWLEDGE_BASE_RESPONSE_GENERATION"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_creation_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_state #=> String, one of "ENABLED", "DISABLED"
resp.agent.prompt_override_configuration.prompt_configurations[0].base_prompt_template #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.temperature #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_p #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_k #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.maximum_length #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].parser_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.override_lambda #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_name (required, String) —

    Name for a resource.

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :instruction (String) —

    Instruction for the agent.

  • :foundation_model (String) —

    ARN or name of a Bedrock model.

  • :description (String) —

    Description of the Resource.

  • :idle_session_ttl_in_seconds (Integer) —

    Max Session Time.

  • :agent_resource_role_arn (required, String) —

    ARN of a IAM role.

  • :customer_encryption_key_arn (String) —

    A KMS key ARN

  • :tags (Hash<String,String>) —

    A map of tag keys and values

  • :prompt_override_configuration (Types::PromptOverrideConfiguration) —

    Configuration for prompt override.

Returns:

See Also:



554
555
556
557
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 554

def create_agent(params = {}, options = {})
  req = build_request(:create_agent, params)
  req.send_request(options)
end

#create_agent_action_group(params = {}) ⇒ Types::CreateAgentActionGroupResponse

Creates an Action Group for existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.create_agent_action_group({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  action_group_name: "Name", # required
  client_token: "ClientToken",
  description: "Description",
  parent_action_group_signature: "AMAZON.UserInput", # accepts AMAZON.UserInput
  action_group_executor: {
    lambda: "LambdaArn",
  },
  api_schema: {
    s3: {
      s3_bucket_name: "S3BucketName",
      s3_object_key: "S3ObjectKey",
    },
    payload: "Payload",
  },
  action_group_state: "ENABLED", # accepts ENABLED, DISABLED
})

Response structure


resp.agent_action_group.agent_id #=> String
resp.agent_action_group.agent_version #=> String
resp.agent_action_group.action_group_id #=> String
resp.agent_action_group.action_group_name #=> String
resp.agent_action_group.client_token #=> String
resp.agent_action_group.description #=> String
resp.agent_action_group.created_at #=> Time
resp.agent_action_group.updated_at #=> Time
resp.agent_action_group.parent_action_signature #=> String, one of "AMAZON.UserInput"
resp.agent_action_group.action_group_executor.lambda #=> String
resp.agent_action_group.api_schema.s3.s3_bucket_name #=> String
resp.agent_action_group.api_schema.s3.s3_object_key #=> String
resp.agent_action_group.api_schema.payload #=> String
resp.agent_action_group.action_group_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :action_group_name (required, String) —

    Name for a resource.

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :description (String) —

    Description of the Resource.

  • :parent_action_group_signature (String) —

    Action Group Signature for a BuiltIn Action

  • :action_group_executor (Types::ActionGroupExecutor) —

    Type of Executors for an Action Group

  • :api_schema (Types::APISchema) —

    Contains information about the API Schema for the Action Group

  • :action_group_state (String) —

    State of the action group

Returns:

See Also:



638
639
640
641
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 638

def create_agent_action_group(params = {}, options = {})
  req = build_request(:create_agent_action_group, params)
  req.send_request(options)
end

#create_agent_alias(params = {}) ⇒ Types::CreateAgentAliasResponse

Creates an Alias for an existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.create_agent_alias({
  agent_id: "Id", # required
  agent_alias_name: "Name", # required
  client_token: "ClientToken",
  description: "Description",
  routing_configuration: [
    {
      agent_version: "Version", # required
    },
  ],
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.agent_alias.agent_id #=> String
resp.agent_alias.agent_alias_id #=> String
resp.agent_alias.agent_alias_name #=> String
resp.agent_alias.agent_alias_arn #=> String
resp.agent_alias.client_token #=> String
resp.agent_alias.description #=> String
resp.agent_alias.routing_configuration #=> Array
resp.agent_alias.routing_configuration[0].agent_version #=> String
resp.agent_alias.created_at #=> Time
resp.agent_alias.updated_at #=> Time
resp.agent_alias.agent_alias_history_events #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration[0].agent_version #=> String
resp.agent_alias.agent_alias_history_events[0].end_date #=> Time
resp.agent_alias.agent_alias_history_events[0].start_date #=> Time
resp.agent_alias.agent_alias_status #=> String, one of "CREATING", "PREPARED", "FAILED", "UPDATING", "DELETING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_alias_name (required, String) —

    Name for a resource.

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :description (String) —

    Description of the Resource.

  • :routing_configuration (Array<Types::AgentAliasRoutingConfigurationListItem>) —

    Routing configuration for an Agent alias.

  • :tags (Hash<String,String>) —

    A map of tag keys and values

Returns:

See Also:



710
711
712
713
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 710

def create_agent_alias(params = {}, options = {})
  req = build_request(:create_agent_alias, params)
  req.send_request(options)
end

#create_data_source(params = {}) ⇒ Types::CreateDataSourceResponse

Create a new data source

Examples:

Request syntax with placeholder values


resp = client.create_data_source({
  knowledge_base_id: "Id", # required
  client_token: "ClientToken",
  name: "Name", # required
  description: "Description",
  data_source_configuration: { # required
    type: "S3", # required, accepts S3
    s3_configuration: {
      bucket_arn: "S3BucketArn", # required
      inclusion_prefixes: ["S3Prefix"],
    },
  },
  server_side_encryption_configuration: {
    kms_key_arn: "KmsKeyArn",
  },
  vector_ingestion_configuration: {
    chunking_configuration: {
      chunking_strategy: "FIXED_SIZE", # required, accepts FIXED_SIZE, NONE
      fixed_size_chunking_configuration: {
        max_tokens: 1, # required
        overlap_percentage: 1, # required
      },
    },
  },
})

Response structure


resp.data_source.knowledge_base_id #=> String
resp.data_source.data_source_id #=> String
resp.data_source.name #=> String
resp.data_source.status #=> String, one of "AVAILABLE", "DELETING"
resp.data_source.description #=> String
resp.data_source.data_source_configuration.type #=> String, one of "S3"
resp.data_source.data_source_configuration.s3_configuration.bucket_arn #=> String
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes #=> Array
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes[0] #=> String
resp.data_source.server_side_encryption_configuration.kms_key_arn #=> String
resp.data_source.vector_ingestion_configuration.chunking_configuration.chunking_strategy #=> String, one of "FIXED_SIZE", "NONE"
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.max_tokens #=> Integer
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.overlap_percentage #=> Integer
resp.data_source.created_at #=> Time
resp.data_source.updated_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :data_source_configuration (required, Types::DataSourceConfiguration) —

    Specifies a raw data source location to ingest.

  • :server_side_encryption_configuration (Types::ServerSideEncryptionConfiguration) —

    Server-side encryption configuration.

  • :vector_ingestion_configuration (Types::VectorIngestionConfiguration) —

    Configures ingestion for a vector knowledge base

Returns:

See Also:



795
796
797
798
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 795

def create_data_source(params = {}, options = {})
  req = build_request(:create_data_source, params)
  req.send_request(options)
end

#create_knowledge_base(params = {}) ⇒ Types::CreateKnowledgeBaseResponse

Create a new knowledge base

Examples:

Request syntax with placeholder values


resp = client.create_knowledge_base({
  client_token: "ClientToken",
  name: "Name", # required
  description: "Description",
  role_arn: "KnowledgeBaseRoleArn", # required
  knowledge_base_configuration: { # required
    type: "VECTOR", # required, accepts VECTOR
    vector_knowledge_base_configuration: {
      embedding_model_arn: "BedrockEmbeddingModelArn", # required
    },
  },
  storage_configuration: { # required
    type: "OPENSEARCH_SERVERLESS", # required, accepts OPENSEARCH_SERVERLESS, PINECONE, REDIS_ENTERPRISE_CLOUD
    opensearch_serverless_configuration: {
      collection_arn: "OpenSearchServerlessCollectionArn", # required
      vector_index_name: "OpenSearchServerlessIndexName", # required
      field_mapping: { # required
        vector_field: "FieldName", # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
    pinecone_configuration: {
      connection_string: "PineconeConnectionString", # required
      credentials_secret_arn: "SecretArn", # required
      namespace: "PineconeNamespace",
      field_mapping: { # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
    redis_enterprise_cloud_configuration: {
      endpoint: "RedisEnterpriseCloudEndpoint", # required
      vector_index_name: "RedisEnterpriseCloudIndexName", # required
      credentials_secret_arn: "SecretArn", # required
      field_mapping: { # required
        vector_field: "FieldName", # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
  },
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.knowledge_base.knowledge_base_id #=> String
resp.knowledge_base.name #=> String
resp.knowledge_base.knowledge_base_arn #=> String
resp.knowledge_base.description #=> String
resp.knowledge_base.role_arn #=> String
resp.knowledge_base.knowledge_base_configuration.type #=> String, one of "VECTOR"
resp.knowledge_base.knowledge_base_configuration.vector_knowledge_base_configuration.embedding_model_arn #=> String
resp.knowledge_base.storage_configuration.type #=> String, one of "OPENSEARCH_SERVERLESS", "PINECONE", "REDIS_ENTERPRISE_CLOUD"
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.collection_arn #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.connection_string #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.namespace #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.endpoint #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING", "FAILED"
resp.knowledge_base.created_at #=> Time
resp.knowledge_base.updated_at #=> Time
resp.knowledge_base.failure_reasons #=> Array
resp.knowledge_base.failure_reasons[0] #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :role_arn (required, String) —

    ARN of a IAM role.

  • :knowledge_base_configuration (required, Types::KnowledgeBaseConfiguration) —

    Configures a bedrock knowledge base.

  • :storage_configuration (required, Types::StorageConfiguration) —

    Configures the physical storage of ingested data in a knowledge base.

  • :tags (Hash<String,String>) —

    A map of tag keys and values

Returns:

See Also:



915
916
917
918
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 915

def create_knowledge_base(params = {}, options = {})
  req = build_request(:create_knowledge_base, params)
  req.send_request(options)
end

#delete_agent(params = {}) ⇒ Types::DeleteAgentResponse

Deletes an Agent for existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.delete_agent({
  agent_id: "Id", # required
  skip_resource_in_use_check: false,
})

Response structure


resp.agent_id #=> String
resp.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :skip_resource_in_use_check (Boolean) —

    Skips checking if resource is in use when set to true. Defaults to false

Returns:

See Also:



950
951
952
953
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 950

def delete_agent(params = {}, options = {})
  req = build_request(:delete_agent, params)
  req.send_request(options)
end

#delete_agent_action_group(params = {}) ⇒ Struct

Deletes an Action Group for existing Amazon Bedrock Agent.

Examples:

Request syntax with placeholder values


resp = client.delete_agent_action_group({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  action_group_id: "Id", # required
  skip_resource_in_use_check: false,
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :action_group_id (required, String) —

    Id generated at the server side when an Agent ActionGroup is created

  • :skip_resource_in_use_check (Boolean) —

    Skips checking if resource is in use when set to true. Defaults to false

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



985
986
987
988
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 985

def delete_agent_action_group(params = {}, options = {})
  req = build_request(:delete_agent_action_group, params)
  req.send_request(options)
end

#delete_agent_alias(params = {}) ⇒ Types::DeleteAgentAliasResponse

Deletes an Alias for a Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.delete_agent_alias({
  agent_id: "Id", # required
  agent_alias_id: "AgentAliasId", # required
})

Response structure


resp.agent_id #=> String
resp.agent_alias_id #=> String
resp.agent_alias_status #=> String, one of "CREATING", "PREPARED", "FAILED", "UPDATING", "DELETING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_alias_id (required, String) —

    Id generated at the server side when an Agent Alias is created

Returns:

See Also:



1021
1022
1023
1024
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1021

def delete_agent_alias(params = {}, options = {})
  req = build_request(:delete_agent_alias, params)
  req.send_request(options)
end

#delete_agent_version(params = {}) ⇒ Types::DeleteAgentVersionResponse

Deletes an Agent version for existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.delete_agent_version({
  agent_id: "Id", # required
  agent_version: "NumericalVersion", # required
  skip_resource_in_use_check: false,
})

Response structure


resp.agent_id #=> String
resp.agent_version #=> String
resp.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Numerical Agent Version.

  • :skip_resource_in_use_check (Boolean) —

    Skips checking if resource is in use when set to true. Defaults to false

Returns:

See Also:



1062
1063
1064
1065
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1062

def delete_agent_version(params = {}, options = {})
  req = build_request(:delete_agent_version, params)
  req.send_request(options)
end

#delete_data_source(params = {}) ⇒ Types::DeleteDataSourceResponse

Delete an existing data source

Examples:

Request syntax with placeholder values


resp = client.delete_data_source({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
})

Response structure


resp.knowledge_base_id #=> String
resp.data_source_id #=> String
resp.status #=> String, one of "AVAILABLE", "DELETING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

Returns:

See Also:



1098
1099
1100
1101
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1098

def delete_data_source(params = {}, options = {})
  req = build_request(:delete_data_source, params)
  req.send_request(options)
end

#delete_knowledge_base(params = {}) ⇒ Types::DeleteKnowledgeBaseResponse

Delete an existing knowledge base

Examples:

Request syntax with placeholder values


resp = client.delete_knowledge_base({
  knowledge_base_id: "Id", # required
})

Response structure


resp.knowledge_base_id #=> String
resp.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING", "FAILED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

Returns:

See Also:



1128
1129
1130
1131
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1128

def delete_knowledge_base(params = {}, options = {})
  req = build_request(:delete_knowledge_base, params)
  req.send_request(options)
end

#disassociate_agent_knowledge_base(params = {}) ⇒ Struct

Disassociate an existing Knowledge Base from an Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.disassociate_agent_knowledge_base({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  knowledge_base_id: "Id", # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :knowledge_base_id (required, String) —

    Id generated at the server side when a Knowledge Base is associated to an Agent

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



1159
1160
1161
1162
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1159

def disassociate_agent_knowledge_base(params = {}, options = {})
  req = build_request(:disassociate_agent_knowledge_base, params)
  req.send_request(options)
end

#get_agent(params = {}) ⇒ Types::GetAgentResponse

Gets an Agent for existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.get_agent({
  agent_id: "Id", # required
})

Response structure


resp.agent.agent_id #=> String
resp.agent.agent_name #=> String
resp.agent.agent_arn #=> String
resp.agent.agent_version #=> String
resp.agent.client_token #=> String
resp.agent.instruction #=> String
resp.agent.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent.foundation_model #=> String
resp.agent.description #=> String
resp.agent.idle_session_ttl_in_seconds #=> Integer
resp.agent.agent_resource_role_arn #=> String
resp.agent.customer_encryption_key_arn #=> String
resp.agent.created_at #=> Time
resp.agent.updated_at #=> Time
resp.agent.prepared_at #=> Time
resp.agent.failure_reasons #=> Array
resp.agent.failure_reasons[0] #=> String
resp.agent.recommended_actions #=> Array
resp.agent.recommended_actions[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_type #=> String, one of "PRE_PROCESSING", "ORCHESTRATION", "POST_PROCESSING", "KNOWLEDGE_BASE_RESPONSE_GENERATION"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_creation_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_state #=> String, one of "ENABLED", "DISABLED"
resp.agent.prompt_override_configuration.prompt_configurations[0].base_prompt_template #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.temperature #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_p #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_k #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.maximum_length #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].parser_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.override_lambda #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

Returns:

See Also:



1218
1219
1220
1221
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1218

def get_agent(params = {}, options = {})
  req = build_request(:get_agent, params)
  req.send_request(options)
end

#get_agent_action_group(params = {}) ⇒ Types::GetAgentActionGroupResponse

Gets an Action Group for existing Amazon Bedrock Agent Version

Examples:

Request syntax with placeholder values


resp = client.get_agent_action_group({
  agent_id: "Id", # required
  agent_version: "Version", # required
  action_group_id: "Id", # required
})

Response structure


resp.agent_action_group.agent_id #=> String
resp.agent_action_group.agent_version #=> String
resp.agent_action_group.action_group_id #=> String
resp.agent_action_group.action_group_name #=> String
resp.agent_action_group.client_token #=> String
resp.agent_action_group.description #=> String
resp.agent_action_group.created_at #=> Time
resp.agent_action_group.updated_at #=> Time
resp.agent_action_group.parent_action_signature #=> String, one of "AMAZON.UserInput"
resp.agent_action_group.action_group_executor.lambda #=> String
resp.agent_action_group.api_schema.s3.s3_bucket_name #=> String
resp.agent_action_group.api_schema.s3.s3_object_key #=> String
resp.agent_action_group.api_schema.payload #=> String
resp.agent_action_group.action_group_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Version number generated when a version is created

  • :action_group_id (required, String) —

    Id generated at the server side when an Agent Action Group is created

Returns:

See Also:



1267
1268
1269
1270
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1267

def get_agent_action_group(params = {}, options = {})
  req = build_request(:get_agent_action_group, params)
  req.send_request(options)
end

#get_agent_alias(params = {}) ⇒ Types::GetAgentAliasResponse

Describes an Alias for a Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.get_agent_alias({
  agent_id: "Id", # required
  agent_alias_id: "AgentAliasId", # required
})

Response structure


resp.agent_alias.agent_id #=> String
resp.agent_alias.agent_alias_id #=> String
resp.agent_alias.agent_alias_name #=> String
resp.agent_alias.agent_alias_arn #=> String
resp.agent_alias.client_token #=> String
resp.agent_alias.description #=> String
resp.agent_alias.routing_configuration #=> Array
resp.agent_alias.routing_configuration[0].agent_version #=> String
resp.agent_alias.created_at #=> Time
resp.agent_alias.updated_at #=> Time
resp.agent_alias.agent_alias_history_events #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration[0].agent_version #=> String
resp.agent_alias.agent_alias_history_events[0].end_date #=> Time
resp.agent_alias.agent_alias_history_events[0].start_date #=> Time
resp.agent_alias.agent_alias_status #=> String, one of "CREATING", "PREPARED", "FAILED", "UPDATING", "DELETING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_alias_id (required, String) —

    Id generated at the server side when an Agent Alias is created

Returns:

See Also:



1314
1315
1316
1317
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1314

def get_agent_alias(params = {}, options = {})
  req = build_request(:get_agent_alias, params)
  req.send_request(options)
end

#get_agent_knowledge_base(params = {}) ⇒ Types::GetAgentKnowledgeBaseResponse

Gets a knowledge base associated to an existing Amazon Bedrock Agent Version

Examples:

Request syntax with placeholder values


resp = client.get_agent_knowledge_base({
  agent_id: "Id", # required
  agent_version: "Version", # required
  knowledge_base_id: "Id", # required
})

Response structure


resp.agent_knowledge_base.agent_id #=> String
resp.agent_knowledge_base.agent_version #=> String
resp.agent_knowledge_base.knowledge_base_id #=> String
resp.agent_knowledge_base.description #=> String
resp.agent_knowledge_base.created_at #=> Time
resp.agent_knowledge_base.updated_at #=> Time
resp.agent_knowledge_base.knowledge_base_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Version number generated when a version is created

  • :knowledge_base_id (required, String) —

    Id generated at the server side when a Knowledge Base is associated

Returns:

See Also:



1357
1358
1359
1360
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1357

def get_agent_knowledge_base(params = {}, options = {})
  req = build_request(:get_agent_knowledge_base, params)
  req.send_request(options)
end

#get_agent_version(params = {}) ⇒ Types::GetAgentVersionResponse

Gets an Agent version for existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.get_agent_version({
  agent_id: "Id", # required
  agent_version: "NumericalVersion", # required
})

Response structure


resp.agent_version.agent_id #=> String
resp.agent_version.agent_name #=> String
resp.agent_version.agent_arn #=> String
resp.agent_version.version #=> String
resp.agent_version.instruction #=> String
resp.agent_version.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent_version.foundation_model #=> String
resp.agent_version.description #=> String
resp.agent_version.idle_session_ttl_in_seconds #=> Integer
resp.agent_version.agent_resource_role_arn #=> String
resp.agent_version.customer_encryption_key_arn #=> String
resp.agent_version.created_at #=> Time
resp.agent_version.updated_at #=> Time
resp.agent_version.failure_reasons #=> Array
resp.agent_version.failure_reasons[0] #=> String
resp.agent_version.recommended_actions #=> Array
resp.agent_version.recommended_actions[0] #=> String
resp.agent_version.prompt_override_configuration.prompt_configurations #=> Array
resp.agent_version.prompt_override_configuration.prompt_configurations[0].prompt_type #=> String, one of "PRE_PROCESSING", "ORCHESTRATION", "POST_PROCESSING", "KNOWLEDGE_BASE_RESPONSE_GENERATION"
resp.agent_version.prompt_override_configuration.prompt_configurations[0].prompt_creation_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent_version.prompt_override_configuration.prompt_configurations[0].prompt_state #=> String, one of "ENABLED", "DISABLED"
resp.agent_version.prompt_override_configuration.prompt_configurations[0].base_prompt_template #=> String
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.temperature #=> Float
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_p #=> Float
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_k #=> Integer
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.maximum_length #=> Integer
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences #=> Array
resp.agent_version.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences[0] #=> String
resp.agent_version.prompt_override_configuration.prompt_configurations[0].parser_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent_version.prompt_override_configuration.override_lambda #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Numerical Agent Version.

Returns:

See Also:



1418
1419
1420
1421
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1418

def get_agent_version(params = {}, options = {})
  req = build_request(:get_agent_version, params)
  req.send_request(options)
end

#get_data_source(params = {}) ⇒ Types::GetDataSourceResponse

Get an existing data source

Examples:

Request syntax with placeholder values


resp = client.get_data_source({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
})

Response structure


resp.data_source.knowledge_base_id #=> String
resp.data_source.data_source_id #=> String
resp.data_source.name #=> String
resp.data_source.status #=> String, one of "AVAILABLE", "DELETING"
resp.data_source.description #=> String
resp.data_source.data_source_configuration.type #=> String, one of "S3"
resp.data_source.data_source_configuration.s3_configuration.bucket_arn #=> String
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes #=> Array
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes[0] #=> String
resp.data_source.server_side_encryption_configuration.kms_key_arn #=> String
resp.data_source.vector_ingestion_configuration.chunking_configuration.chunking_strategy #=> String, one of "FIXED_SIZE", "NONE"
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.max_tokens #=> Integer
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.overlap_percentage #=> Integer
resp.data_source.created_at #=> Time
resp.data_source.updated_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

Returns:

See Also:



1464
1465
1466
1467
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1464

def get_data_source(params = {}, options = {})
  req = build_request(:get_data_source, params)
  req.send_request(options)
end

#get_ingestion_job(params = {}) ⇒ Types::GetIngestionJobResponse

Get an ingestion job

Examples:

Request syntax with placeholder values


resp = client.get_ingestion_job({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
  ingestion_job_id: "Id", # required
})

Response structure


resp.ingestion_job.knowledge_base_id #=> String
resp.ingestion_job.data_source_id #=> String
resp.ingestion_job.ingestion_job_id #=> String
resp.ingestion_job.description #=> String
resp.ingestion_job.status #=> String, one of "STARTING", "IN_PROGRESS", "COMPLETE", "FAILED"
resp.ingestion_job.statistics.number_of_documents_scanned #=> Integer
resp.ingestion_job.statistics.number_of_new_documents_indexed #=> Integer
resp.ingestion_job.statistics.number_of_modified_documents_indexed #=> Integer
resp.ingestion_job.statistics.number_of_documents_deleted #=> Integer
resp.ingestion_job.statistics.number_of_documents_failed #=> Integer
resp.ingestion_job.failure_reasons #=> Array
resp.ingestion_job.failure_reasons[0] #=> String
resp.ingestion_job.started_at #=> Time
resp.ingestion_job.updated_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

  • :ingestion_job_id (required, String) —

    Identifier for a resource.

Returns:

See Also:



1513
1514
1515
1516
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1513

def get_ingestion_job(params = {}, options = {})
  req = build_request(:get_ingestion_job, params)
  req.send_request(options)
end

#get_knowledge_base(params = {}) ⇒ Types::GetKnowledgeBaseResponse

Get an existing knowledge base

Examples:

Request syntax with placeholder values


resp = client.get_knowledge_base({
  knowledge_base_id: "Id", # required
})

Response structure


resp.knowledge_base.knowledge_base_id #=> String
resp.knowledge_base.name #=> String
resp.knowledge_base.knowledge_base_arn #=> String
resp.knowledge_base.description #=> String
resp.knowledge_base.role_arn #=> String
resp.knowledge_base.knowledge_base_configuration.type #=> String, one of "VECTOR"
resp.knowledge_base.knowledge_base_configuration.vector_knowledge_base_configuration.embedding_model_arn #=> String
resp.knowledge_base.storage_configuration.type #=> String, one of "OPENSEARCH_SERVERLESS", "PINECONE", "REDIS_ENTERPRISE_CLOUD"
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.collection_arn #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.connection_string #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.namespace #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.endpoint #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING", "FAILED"
resp.knowledge_base.created_at #=> Time
resp.knowledge_base.updated_at #=> Time
resp.knowledge_base.failure_reasons #=> Array
resp.knowledge_base.failure_reasons[0] #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

Returns:

See Also:



1569
1570
1571
1572
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1569

def get_knowledge_base(params = {}, options = {})
  req = build_request(:get_knowledge_base, params)
  req.send_request(options)
end

#list_agent_action_groups(params = {}) ⇒ Types::ListAgentActionGroupsResponse

Lists an Action Group for existing Amazon Bedrock Agent Version

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_agent_action_groups({
  agent_id: "Id", # required
  agent_version: "Version", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.action_group_summaries #=> Array
resp.action_group_summaries[0].action_group_id #=> String
resp.action_group_summaries[0].action_group_name #=> String
resp.action_group_summaries[0].action_group_state #=> String, one of "ENABLED", "DISABLED"
resp.action_group_summaries[0].description #=> String
resp.action_group_summaries[0].updated_at #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is Listed

  • :agent_version (required, String) —

    Id generated at the server side when an Agent is Listed

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1618
1619
1620
1621
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1618

def list_agent_action_groups(params = {}, options = {})
  req = build_request(:list_agent_action_groups, params)
  req.send_request(options)
end

#list_agent_aliases(params = {}) ⇒ Types::ListAgentAliasesResponse

Lists all the Aliases for an Amazon Bedrock Agent

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_agent_aliases({
  agent_id: "Id", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.agent_alias_summaries #=> Array
resp.agent_alias_summaries[0].agent_alias_id #=> String
resp.agent_alias_summaries[0].agent_alias_name #=> String
resp.agent_alias_summaries[0].description #=> String
resp.agent_alias_summaries[0].routing_configuration #=> Array
resp.agent_alias_summaries[0].routing_configuration[0].agent_version #=> String
resp.agent_alias_summaries[0].agent_alias_status #=> String, one of "CREATING", "PREPARED", "FAILED", "UPDATING", "DELETING"
resp.agent_alias_summaries[0].created_at #=> Time
resp.agent_alias_summaries[0].updated_at #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1666
1667
1668
1669
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1666

def list_agent_aliases(params = {}, options = {})
  req = build_request(:list_agent_aliases, params)
  req.send_request(options)
end

#list_agent_knowledge_bases(params = {}) ⇒ Types::ListAgentKnowledgeBasesResponse

List of Knowledge Bases associated to an existing Amazon Bedrock Agent Version

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_agent_knowledge_bases({
  agent_id: "Id", # required
  agent_version: "Version", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.agent_knowledge_base_summaries #=> Array
resp.agent_knowledge_base_summaries[0].knowledge_base_id #=> String
resp.agent_knowledge_base_summaries[0].description #=> String
resp.agent_knowledge_base_summaries[0].knowledge_base_state #=> String, one of "ENABLED", "DISABLED"
resp.agent_knowledge_base_summaries[0].updated_at #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Version number generated when a version is created

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1715
1716
1717
1718
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1715

def list_agent_knowledge_bases(params = {}, options = {})
  req = build_request(:list_agent_knowledge_bases, params)
  req.send_request(options)
end

#list_agent_versions(params = {}) ⇒ Types::ListAgentVersionsResponse

Lists Agent Versions

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_agent_versions({
  agent_id: "Id", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.agent_version_summaries #=> Array
resp.agent_version_summaries[0].agent_name #=> String
resp.agent_version_summaries[0].agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent_version_summaries[0].agent_version #=> String
resp.agent_version_summaries[0].created_at #=> Time
resp.agent_version_summaries[0].updated_at #=> Time
resp.agent_version_summaries[0].description #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1761
1762
1763
1764
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1761

def list_agent_versions(params = {}, options = {})
  req = build_request(:list_agent_versions, params)
  req.send_request(options)
end

#list_agents(params = {}) ⇒ Types::ListAgentsResponse

Lists Agents

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_agents({
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.agent_summaries #=> Array
resp.agent_summaries[0].agent_id #=> String
resp.agent_summaries[0].agent_name #=> String
resp.agent_summaries[0].agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent_summaries[0].description #=> String
resp.agent_summaries[0].updated_at #=> Time
resp.agent_summaries[0].latest_agent_version #=> String
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1803
1804
1805
1806
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1803

def list_agents(params = {}, options = {})
  req = build_request(:list_agents, params)
  req.send_request(options)
end

#list_data_sources(params = {}) ⇒ Types::ListDataSourcesResponse

List data sources

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_data_sources({
  knowledge_base_id: "Id", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.data_source_summaries #=> Array
resp.data_source_summaries[0].knowledge_base_id #=> String
resp.data_source_summaries[0].data_source_id #=> String
resp.data_source_summaries[0].name #=> String
resp.data_source_summaries[0].status #=> String, one of "AVAILABLE", "DELETING"
resp.data_source_summaries[0].description #=> String
resp.data_source_summaries[0].updated_at #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1849
1850
1851
1852
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1849

def list_data_sources(params = {}, options = {})
  req = build_request(:list_data_sources, params)
  req.send_request(options)
end

#list_ingestion_jobs(params = {}) ⇒ Types::ListIngestionJobsResponse

List ingestion jobs

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_ingestion_jobs({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
  filters: [
    {
      attribute: "STATUS", # required, accepts STATUS
      operator: "EQ", # required, accepts EQ
      values: ["IngestionJobFilterValue"], # required
    },
  ],
  sort_by: {
    attribute: "STATUS", # required, accepts STATUS, STARTED_AT
    order: "ASCENDING", # required, accepts ASCENDING, DESCENDING
  },
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.ingestion_job_summaries #=> Array
resp.ingestion_job_summaries[0].knowledge_base_id #=> String
resp.ingestion_job_summaries[0].data_source_id #=> String
resp.ingestion_job_summaries[0].ingestion_job_id #=> String
resp.ingestion_job_summaries[0].description #=> String
resp.ingestion_job_summaries[0].status #=> String, one of "STARTING", "IN_PROGRESS", "COMPLETE", "FAILED"
resp.ingestion_job_summaries[0].started_at #=> Time
resp.ingestion_job_summaries[0].updated_at #=> Time
resp.ingestion_job_summaries[0].statistics.number_of_documents_scanned #=> Integer
resp.ingestion_job_summaries[0].statistics.number_of_new_documents_indexed #=> Integer
resp.ingestion_job_summaries[0].statistics.number_of_modified_documents_indexed #=> Integer
resp.ingestion_job_summaries[0].statistics.number_of_documents_deleted #=> Integer
resp.ingestion_job_summaries[0].statistics.number_of_documents_failed #=> Integer
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

  • :filters (Array<Types::IngestionJobFilter>) —

    List of IngestionJobFilters

  • :sort_by (Types::IngestionJobSortBy) —

    Sorts the response returned by ListIngestionJobs operation.

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1922
1923
1924
1925
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1922

def list_ingestion_jobs(params = {}, options = {})
  req = build_request(:list_ingestion_jobs, params)
  req.send_request(options)
end

#list_knowledge_bases(params = {}) ⇒ Types::ListKnowledgeBasesResponse

List Knowledge Bases

The returned response is a pageable response and is Enumerable. For details on usage see PageableResponse.

Examples:

Request syntax with placeholder values


resp = client.list_knowledge_bases({
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.knowledge_base_summaries #=> Array
resp.knowledge_base_summaries[0].knowledge_base_id #=> String
resp.knowledge_base_summaries[0].name #=> String
resp.knowledge_base_summaries[0].description #=> String
resp.knowledge_base_summaries[0].status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING", "FAILED"
resp.knowledge_base_summaries[0].updated_at #=> Time
resp.next_token #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :max_results (Integer) —

    Max Results.

  • :next_token (String) —

    Opaque continuation token of previous paginated response.

Returns:

See Also:



1963
1964
1965
1966
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1963

def list_knowledge_bases(params = {}, options = {})
  req = build_request(:list_knowledge_bases, params)
  req.send_request(options)
end

#list_tags_for_resource(params = {}) ⇒ Types::ListTagsForResourceResponse

List tags for a resource

Examples:

Request syntax with placeholder values


resp = client.list_tags_for_resource({
  resource_arn: "TaggableResourcesArn", # required
})

Response structure


resp.tags #=> Hash
resp.tags["TagKey"] #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :resource_arn (required, String) —

    ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]

Returns:

See Also:



1992
1993
1994
1995
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 1992

def list_tags_for_resource(params = {}, options = {})
  req = build_request(:list_tags_for_resource, params)
  req.send_request(options)
end

#prepare_agent(params = {}) ⇒ Types::PrepareAgentResponse

Prepares an existing Amazon Bedrock Agent to receive runtime requests

Examples:

Request syntax with placeholder values


resp = client.prepare_agent({
  agent_id: "Id", # required
})

Response structure


resp.agent_id #=> String
resp.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent_version #=> String
resp.prepared_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

Returns:

See Also:



2026
2027
2028
2029
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2026

def prepare_agent(params = {}, options = {})
  req = build_request(:prepare_agent, params)
  req.send_request(options)
end

#start_ingestion_job(params = {}) ⇒ Types::StartIngestionJobResponse

Start a new ingestion job

Examples:

Request syntax with placeholder values


resp = client.start_ingestion_job({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
  client_token: "ClientToken",
  description: "Description",
})

Response structure


resp.ingestion_job.knowledge_base_id #=> String
resp.ingestion_job.data_source_id #=> String
resp.ingestion_job.ingestion_job_id #=> String
resp.ingestion_job.description #=> String
resp.ingestion_job.status #=> String, one of "STARTING", "IN_PROGRESS", "COMPLETE", "FAILED"
resp.ingestion_job.statistics.number_of_documents_scanned #=> Integer
resp.ingestion_job.statistics.number_of_new_documents_indexed #=> Integer
resp.ingestion_job.statistics.number_of_modified_documents_indexed #=> Integer
resp.ingestion_job.statistics.number_of_documents_deleted #=> Integer
resp.ingestion_job.statistics.number_of_documents_failed #=> Integer
resp.ingestion_job.failure_reasons #=> Array
resp.ingestion_job.failure_reasons[0] #=> String
resp.ingestion_job.started_at #=> Time
resp.ingestion_job.updated_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

  • :client_token (String) —

    Client specified token used for idempotency checks

    **A suitable default value is auto-generated.** You should normally not need to pass this option.**

  • :description (String) —

    Description of the Resource.

Returns:

See Also:



2082
2083
2084
2085
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2082

def start_ingestion_job(params = {}, options = {})
  req = build_request(:start_ingestion_job, params)
  req.send_request(options)
end

#tag_resource(params = {}) ⇒ Struct

Tag a resource

Examples:

Request syntax with placeholder values


resp = client.tag_resource({
  resource_arn: "TaggableResourcesArn", # required
  tags: { # required
    "TagKey" => "TagValue",
  },
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :resource_arn (required, String) —

    ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]

  • :tags (required, Hash<String,String>) —

    A map of tag keys and values

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2110
2111
2112
2113
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2110

def tag_resource(params = {}, options = {})
  req = build_request(:tag_resource, params)
  req.send_request(options)
end

#untag_resource(params = {}) ⇒ Struct

Untag a resource

Examples:

Request syntax with placeholder values


resp = client.untag_resource({
  resource_arn: "TaggableResourcesArn", # required
  tag_keys: ["TagKey"], # required
})

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :resource_arn (required, String) —

    ARN of Taggable resources: [Agent, AgentAlias, Knowledge-Base]

  • :tag_keys (required, Array<String>) —

    List of Tag Keys

Returns:

  • (Struct) —

    Returns an empty response.

See Also:



2136
2137
2138
2139
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2136

def untag_resource(params = {}, options = {})
  req = build_request(:untag_resource, params)
  req.send_request(options)
end

#update_agent(params = {}) ⇒ Types::UpdateAgentResponse

Updates an existing Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.update_agent({
  agent_id: "Id", # required
  agent_name: "Name", # required
  instruction: "Instruction",
  foundation_model: "ModelIdentifier",
  description: "Description",
  idle_session_ttl_in_seconds: 1,
  agent_resource_role_arn: "AgentRoleArn", # required
  customer_encryption_key_arn: "KmsKeyArn",
  prompt_override_configuration: {
    prompt_configurations: [ # required
      {
        prompt_type: "PRE_PROCESSING", # accepts PRE_PROCESSING, ORCHESTRATION, POST_PROCESSING, KNOWLEDGE_BASE_RESPONSE_GENERATION
        prompt_creation_mode: "DEFAULT", # accepts DEFAULT, OVERRIDDEN
        prompt_state: "ENABLED", # accepts ENABLED, DISABLED
        base_prompt_template: "BasePromptTemplate",
        inference_configuration: {
          temperature: 1.0,
          top_p: 1.0,
          top_k: 1,
          maximum_length: 1,
          stop_sequences: ["String"],
        },
        parser_mode: "DEFAULT", # accepts DEFAULT, OVERRIDDEN
      },
    ],
    override_lambda: "LambdaArn",
  },
})

Response structure


resp.agent.agent_id #=> String
resp.agent.agent_name #=> String
resp.agent.agent_arn #=> String
resp.agent.agent_version #=> String
resp.agent.client_token #=> String
resp.agent.instruction #=> String
resp.agent.agent_status #=> String, one of "CREATING", "PREPARING", "PREPARED", "NOT_PREPARED", "DELETING", "FAILED", "VERSIONING", "UPDATING"
resp.agent.foundation_model #=> String
resp.agent.description #=> String
resp.agent.idle_session_ttl_in_seconds #=> Integer
resp.agent.agent_resource_role_arn #=> String
resp.agent.customer_encryption_key_arn #=> String
resp.agent.created_at #=> Time
resp.agent.updated_at #=> Time
resp.agent.prepared_at #=> Time
resp.agent.failure_reasons #=> Array
resp.agent.failure_reasons[0] #=> String
resp.agent.recommended_actions #=> Array
resp.agent.recommended_actions[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_type #=> String, one of "PRE_PROCESSING", "ORCHESTRATION", "POST_PROCESSING", "KNOWLEDGE_BASE_RESPONSE_GENERATION"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_creation_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.prompt_configurations[0].prompt_state #=> String, one of "ENABLED", "DISABLED"
resp.agent.prompt_override_configuration.prompt_configurations[0].base_prompt_template #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.temperature #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_p #=> Float
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.top_k #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.maximum_length #=> Integer
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences #=> Array
resp.agent.prompt_override_configuration.prompt_configurations[0].inference_configuration.stop_sequences[0] #=> String
resp.agent.prompt_override_configuration.prompt_configurations[0].parser_mode #=> String, one of "DEFAULT", "OVERRIDDEN"
resp.agent.prompt_override_configuration.override_lambda #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_name (required, String) —

    Name for a resource.

  • :instruction (String) —

    Instruction for the agent.

  • :foundation_model (String) —

    ARN or name of a Bedrock model.

  • :description (String) —

    Description of the Resource.

  • :idle_session_ttl_in_seconds (Integer) —

    Max Session Time.

  • :agent_resource_role_arn (required, String) —

    ARN of a IAM role.

  • :customer_encryption_key_arn (String) —

    A KMS key ARN

  • :prompt_override_configuration (Types::PromptOverrideConfiguration) —

    Configuration for prompt override.

Returns:

See Also:



2245
2246
2247
2248
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2245

def update_agent(params = {}, options = {})
  req = build_request(:update_agent, params)
  req.send_request(options)
end

#update_agent_action_group(params = {}) ⇒ Types::UpdateAgentActionGroupResponse

Updates an existing Action Group for Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.update_agent_action_group({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  action_group_id: "Id", # required
  action_group_name: "Name", # required
  description: "Description",
  parent_action_group_signature: "AMAZON.UserInput", # accepts AMAZON.UserInput
  action_group_executor: {
    lambda: "LambdaArn",
  },
  action_group_state: "ENABLED", # accepts ENABLED, DISABLED
  api_schema: {
    s3: {
      s3_bucket_name: "S3BucketName",
      s3_object_key: "S3ObjectKey",
    },
    payload: "Payload",
  },
})

Response structure


resp.agent_action_group.agent_id #=> String
resp.agent_action_group.agent_version #=> String
resp.agent_action_group.action_group_id #=> String
resp.agent_action_group.action_group_name #=> String
resp.agent_action_group.client_token #=> String
resp.agent_action_group.description #=> String
resp.agent_action_group.created_at #=> Time
resp.agent_action_group.updated_at #=> Time
resp.agent_action_group.parent_action_signature #=> String, one of "AMAZON.UserInput"
resp.agent_action_group.action_group_executor.lambda #=> String
resp.agent_action_group.api_schema.s3.s3_bucket_name #=> String
resp.agent_action_group.api_schema.s3.s3_object_key #=> String
resp.agent_action_group.api_schema.payload #=> String
resp.agent_action_group.action_group_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :action_group_id (required, String) —

    Id generated at the server side when an Action Group is created under Agent

  • :action_group_name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :parent_action_group_signature (String) —

    Action Group Signature for a BuiltIn Action

  • :action_group_executor (Types::ActionGroupExecutor) —

    Type of Executors for an Action Group

  • :action_group_state (String) —

    State of the action group

  • :api_schema (Types::APISchema) —

    Contains information about the API Schema for the Action Group

Returns:

See Also:



2327
2328
2329
2330
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2327

def update_agent_action_group(params = {}, options = {})
  req = build_request(:update_agent_action_group, params)
  req.send_request(options)
end

#update_agent_alias(params = {}) ⇒ Types::UpdateAgentAliasResponse

Updates an existing Alias for an Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.update_agent_alias({
  agent_id: "Id", # required
  agent_alias_id: "AgentAliasId", # required
  agent_alias_name: "Name", # required
  description: "Description",
  routing_configuration: [
    {
      agent_version: "Version", # required
    },
  ],
})

Response structure


resp.agent_alias.agent_id #=> String
resp.agent_alias.agent_alias_id #=> String
resp.agent_alias.agent_alias_name #=> String
resp.agent_alias.agent_alias_arn #=> String
resp.agent_alias.client_token #=> String
resp.agent_alias.description #=> String
resp.agent_alias.routing_configuration #=> Array
resp.agent_alias.routing_configuration[0].agent_version #=> String
resp.agent_alias.created_at #=> Time
resp.agent_alias.updated_at #=> Time
resp.agent_alias.agent_alias_history_events #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration #=> Array
resp.agent_alias.agent_alias_history_events[0].routing_configuration[0].agent_version #=> String
resp.agent_alias.agent_alias_history_events[0].end_date #=> Time
resp.agent_alias.agent_alias_history_events[0].start_date #=> Time
resp.agent_alias.agent_alias_status #=> String, one of "CREATING", "PREPARED", "FAILED", "UPDATING", "DELETING"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_alias_id (required, String) —

    Id generated at the server side when an Agent Alias is created

  • :agent_alias_name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :routing_configuration (Array<Types::AgentAliasRoutingConfigurationListItem>) —

    Routing configuration for an Agent alias.

Returns:

See Also:



2390
2391
2392
2393
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2390

def update_agent_alias(params = {}, options = {})
  req = build_request(:update_agent_alias, params)
  req.send_request(options)
end

#update_agent_knowledge_base(params = {}) ⇒ Types::UpdateAgentKnowledgeBaseResponse

Updates an existing Knowledge Base associated to an Amazon Bedrock Agent

Examples:

Request syntax with placeholder values


resp = client.update_agent_knowledge_base({
  agent_id: "Id", # required
  agent_version: "DraftVersion", # required
  knowledge_base_id: "Id", # required
  description: "Description",
  knowledge_base_state: "ENABLED", # accepts ENABLED, DISABLED
})

Response structure


resp.agent_knowledge_base.agent_id #=> String
resp.agent_knowledge_base.agent_version #=> String
resp.agent_knowledge_base.knowledge_base_id #=> String
resp.agent_knowledge_base.description #=> String
resp.agent_knowledge_base.created_at #=> Time
resp.agent_knowledge_base.updated_at #=> Time
resp.agent_knowledge_base.knowledge_base_state #=> String, one of "ENABLED", "DISABLED"

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :agent_id (required, String) —

    Id generated at the server side when an Agent is created

  • :agent_version (required, String) —

    Draft Version of the Agent.

  • :knowledge_base_id (required, String) —

    Id generated at the server side when a Knowledge Base is associated to an Agent

  • :description (String) —

    Description of the Resource.

  • :knowledge_base_state (String) —

    State of the knowledge base; whether it is enabled or disabled

Returns:

See Also:



2442
2443
2444
2445
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2442

def update_agent_knowledge_base(params = {}, options = {})
  req = build_request(:update_agent_knowledge_base, params)
  req.send_request(options)
end

#update_data_source(params = {}) ⇒ Types::UpdateDataSourceResponse

Update an existing data source

Examples:

Request syntax with placeholder values


resp = client.update_data_source({
  knowledge_base_id: "Id", # required
  data_source_id: "Id", # required
  name: "Name", # required
  description: "Description",
  data_source_configuration: { # required
    type: "S3", # required, accepts S3
    s3_configuration: {
      bucket_arn: "S3BucketArn", # required
      inclusion_prefixes: ["S3Prefix"],
    },
  },
  server_side_encryption_configuration: {
    kms_key_arn: "KmsKeyArn",
  },
  vector_ingestion_configuration: {
    chunking_configuration: {
      chunking_strategy: "FIXED_SIZE", # required, accepts FIXED_SIZE, NONE
      fixed_size_chunking_configuration: {
        max_tokens: 1, # required
        overlap_percentage: 1, # required
      },
    },
  },
})

Response structure


resp.data_source.knowledge_base_id #=> String
resp.data_source.data_source_id #=> String
resp.data_source.name #=> String
resp.data_source.status #=> String, one of "AVAILABLE", "DELETING"
resp.data_source.description #=> String
resp.data_source.data_source_configuration.type #=> String, one of "S3"
resp.data_source.data_source_configuration.s3_configuration.bucket_arn #=> String
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes #=> Array
resp.data_source.data_source_configuration.s3_configuration.inclusion_prefixes[0] #=> String
resp.data_source.server_side_encryption_configuration.kms_key_arn #=> String
resp.data_source.vector_ingestion_configuration.chunking_configuration.chunking_strategy #=> String, one of "FIXED_SIZE", "NONE"
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.max_tokens #=> Integer
resp.data_source.vector_ingestion_configuration.chunking_configuration.fixed_size_chunking_configuration.overlap_percentage #=> Integer
resp.data_source.created_at #=> Time
resp.data_source.updated_at #=> Time

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :data_source_id (required, String) —

    Identifier for a resource.

  • :name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :data_source_configuration (required, Types::DataSourceConfiguration) —

    Specifies a raw data source location to ingest.

  • :server_side_encryption_configuration (Types::ServerSideEncryptionConfiguration) —

    Server-side encryption configuration.

  • :vector_ingestion_configuration (Types::VectorIngestionConfiguration) —

    Configures ingestion for a vector knowledge base

Returns:

See Also:



2524
2525
2526
2527
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2524

def update_data_source(params = {}, options = {})
  req = build_request(:update_data_source, params)
  req.send_request(options)
end

#update_knowledge_base(params = {}) ⇒ Types::UpdateKnowledgeBaseResponse

Update an existing knowledge base

Examples:

Request syntax with placeholder values


resp = client.update_knowledge_base({
  knowledge_base_id: "Id", # required
  name: "Name", # required
  description: "Description",
  role_arn: "KnowledgeBaseRoleArn", # required
  knowledge_base_configuration: { # required
    type: "VECTOR", # required, accepts VECTOR
    vector_knowledge_base_configuration: {
      embedding_model_arn: "BedrockEmbeddingModelArn", # required
    },
  },
  storage_configuration: { # required
    type: "OPENSEARCH_SERVERLESS", # required, accepts OPENSEARCH_SERVERLESS, PINECONE, REDIS_ENTERPRISE_CLOUD
    opensearch_serverless_configuration: {
      collection_arn: "OpenSearchServerlessCollectionArn", # required
      vector_index_name: "OpenSearchServerlessIndexName", # required
      field_mapping: { # required
        vector_field: "FieldName", # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
    pinecone_configuration: {
      connection_string: "PineconeConnectionString", # required
      credentials_secret_arn: "SecretArn", # required
      namespace: "PineconeNamespace",
      field_mapping: { # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
    redis_enterprise_cloud_configuration: {
      endpoint: "RedisEnterpriseCloudEndpoint", # required
      vector_index_name: "RedisEnterpriseCloudIndexName", # required
      credentials_secret_arn: "SecretArn", # required
      field_mapping: { # required
        vector_field: "FieldName", # required
        text_field: "FieldName", # required
        metadata_field: "FieldName", # required
      },
    },
  },
})

Response structure


resp.knowledge_base.knowledge_base_id #=> String
resp.knowledge_base.name #=> String
resp.knowledge_base.knowledge_base_arn #=> String
resp.knowledge_base.description #=> String
resp.knowledge_base.role_arn #=> String
resp.knowledge_base.knowledge_base_configuration.type #=> String, one of "VECTOR"
resp.knowledge_base.knowledge_base_configuration.vector_knowledge_base_configuration.embedding_model_arn #=> String
resp.knowledge_base.storage_configuration.type #=> String, one of "OPENSEARCH_SERVERLESS", "PINECONE", "REDIS_ENTERPRISE_CLOUD"
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.collection_arn #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.opensearch_serverless_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.connection_string #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.namespace #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.pinecone_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.endpoint #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.vector_index_name #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.credentials_secret_arn #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.vector_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.text_field #=> String
resp.knowledge_base.storage_configuration.redis_enterprise_cloud_configuration.field_mapping.metadata_field #=> String
resp.knowledge_base.status #=> String, one of "CREATING", "ACTIVE", "DELETING", "UPDATING", "FAILED"
resp.knowledge_base.created_at #=> Time
resp.knowledge_base.updated_at #=> Time
resp.knowledge_base.failure_reasons #=> Array
resp.knowledge_base.failure_reasons[0] #=> String

Parameters:

  • params (Hash) (defaults to: {}) —

    ({})

Options Hash (params):

  • :knowledge_base_id (required, String) —

    Identifier for a resource.

  • :name (required, String) —

    Name for a resource.

  • :description (String) —

    Description of the Resource.

  • :role_arn (required, String) —

    ARN of a IAM role.

  • :knowledge_base_configuration (required, Types::KnowledgeBaseConfiguration) —

    Configures a bedrock knowledge base.

  • :storage_configuration (required, Types::StorageConfiguration) —

    Configures the physical storage of ingested data in a knowledge base.

Returns:

See Also:



2635
2636
2637
2638
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2635

def update_knowledge_base(params = {}, options = {})
  req = build_request(:update_knowledge_base, params)
  req.send_request(options)
end

#waiter_names ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Deprecated. 


2659
2660
2661
 
# File 'lib/aws-sdk-bedrockagent/client.rb', line 2659

def waiter_names
  []
end