Class: Aws::LexModelsV2::Client

Inherits:
Seahorse::Client::Base show all
Includes:
ClientStubs
Defined in:
gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb

Overview

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

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

For details on configuring region and credentials see the developer guide.

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

Instance Attribute Summary

Attributes inherited from Seahorse::Client::Base

#config, #handlers

API Operations collapse

Instance Method Summary collapse

Methods included from ClientStubs

#api_requests, #stub_data, #stub_responses

Methods inherited from Seahorse::Client::Base

add_plugin, api, clear_plugins, define, new, #operation_names, plugins, remove_plugin, set_api, set_plugins

Methods included from Seahorse::Client::HandlerBuilder

#handle, #handle_request, #handle_response

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[:credentials]
    • The :access_key_id, :secret_access_key, and :session_token options.
    • ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
    • ~/.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.
  • :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:

    • Aws.config[:region]
    • ENV['AWS_REGION']
    • ENV['AMAZON_REGION']
    • ENV['AWS_DEFAULT_REGION']
    • ~/.aws/credentials
    • ~/.aws/config
  • :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.

  • :disable_host_prefix_injection (Boolean) — default: false

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

  • :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.

  • :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.

  • :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 https://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.

  • :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.

  • :validate_params (Boolean) — default: true

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

  • :http_proxy (URI::HTTP, String)

    A proxy to send requests through. Formatted like 'http://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 (Integer) — 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.

  • :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.



324
325
326
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 324

def initialize(*args)
  super
end

Instance Method Details

#build_bot_locale(params = {}) ⇒ Types::BuildBotLocaleResponse

Builds a bot, its intents, and its slot types into a specific locale. A bot can be built into multiple locales. At runtime the locale is used to choose a specific build of the bot.

Examples:

Request syntax with placeholder values


resp = client.build_bot_locale({
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
resp. #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to build. The identifier is returned in the response from the operation.

  • :bot_version (required, String)

    The version of the bot to build. This can only be the draft version of the bot.

  • :locale_id (required, String)

    The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

Returns:

See Also:



380
381
382
383
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 380

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

#create_bot(params = {}) ⇒ Types::CreateBotResponse

Creates an Amazon Lex conversational bot.

Examples:

Request syntax with placeholder values


resp = client.create_bot({
  bot_name: "Name", # required
  description: "Description",
  role_arn: "RoleArn", # required
  data_privacy: { # required
    child_directed: false, # required
  },
  idle_session_ttl_in_seconds: 1, # required
  bot_tags: {
    "TagKey" => "TagValue",
  },
  test_bot_alias_tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.bot_id #=> String
resp.bot_name #=> String
resp.description #=> String
resp.role_arn #=> String
resp.data_privacy.child_directed #=> Boolean
resp.idle_session_ttl_in_seconds #=> Integer
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"
resp.creation_date_time #=> Time
resp.bot_tags #=> Hash
resp.bot_tags["TagKey"] #=> String
resp.test_bot_alias_tags #=> Hash
resp.test_bot_alias_tags["TagKey"] #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :bot_name (required, String)

    The name of the bot. The bot name must be unique in the account that creates the bot.

  • :description (String)

    A description of the bot. It appears in lists to help you identify a particular bot.

  • :role_arn (required, String)

    The Amazon Resource Name (ARN) of an IAM role that has permission to access the bot.

  • :data_privacy (required, Types::DataPrivacy)

    Provides information on additional privacy protections Amazon Lex should use with the bot's data.

  • :idle_session_ttl_in_seconds (required, Integer)

    The time, in seconds, that Amazon Lex should keep information about a user's conversation with the bot.

    A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Lex deletes any data provided before the timeout.

    You can specify between 60 (1 minute) and 86,400 (24 hours) seconds.

  • :bot_tags (Hash<String,String>)

    A list of tags to add to the bot. You can only add tags when you create a bot. You can't use the UpdateBot operation to update tags. To update tags, use the TagResource operation.

  • :test_bot_alias_tags (Hash<String,String>)

    A list of tags to add to the test alias for a bot. You can only add tags when you create a bot. You can't use the UpdateAlias operation to update tags. To update tags on the test alias, use the TagResource operation.

Returns:

See Also:



474
475
476
477
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 474

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

#create_bot_alias(params = {}) ⇒ Types::CreateBotAliasResponse

Creates an alias for the specified version of a bot. Use an alias to enable you to change the version of a bot without updating applications that use the bot.

For example, you can create an alias called "PROD" that your applications use to call the Amazon Lex bot.

Examples:

Request syntax with placeholder values


resp = client.create_bot_alias({
  bot_alias_name: "Name", # required
  description: "Description",
  bot_version: "NumericalBotVersion",
  bot_alias_locale_settings: {
    "LocaleId" => {
      enabled: false, # required
      code_hook_specification: {
        lambda_code_hook: { # required
          lambda_arn: "LambdaARN", # required
          code_hook_interface_version: "CodeHookInterfaceVersion", # required
        },
      },
    },
  },
  conversation_log_settings: {
    text_log_settings: [
      {
        enabled: false, # required
        destination: { # required
          cloud_watch: { # required
            cloud_watch_log_group_arn: "CloudWatchLogGroupArn", # required
            log_prefix: "LogPrefix", # required
          },
        },
      },
    ],
    audio_log_settings: [
      {
        enabled: false, # required
        destination: { # required
          s3_bucket: { # required
            kms_key_arn: "KmsKeyArn",
            s3_bucket_arn: "S3BucketArn", # required
            log_prefix: "LogPrefix", # required
          },
        },
      },
    ],
  },
  sentiment_analysis_settings: {
    detect_sentiment: false, # required
  },
  bot_id: "Id", # required
  tags: {
    "TagKey" => "TagValue",
  },
})

Response structure


resp.bot_alias_id #=> String
resp.bot_alias_name #=> String
resp.description #=> String
resp.bot_version #=> String
resp.bot_alias_locale_settings #=> Hash
resp.bot_alias_locale_settings["LocaleId"].enabled #=> Boolean
resp.bot_alias_locale_settings["LocaleId"].code_hook_specification.lambda_code_hook.lambda_arn #=> String
resp.bot_alias_locale_settings["LocaleId"].code_hook_specification.lambda_code_hook.code_hook_interface_version #=> String
resp.conversation_log_settings.text_log_settings #=> Array
resp.conversation_log_settings.text_log_settings[0].enabled #=> Boolean
resp.conversation_log_settings.text_log_settings[0].destination.cloud_watch.cloud_watch_log_group_arn #=> String
resp.conversation_log_settings.text_log_settings[0].destination.cloud_watch.log_prefix #=> String
resp.conversation_log_settings.audio_log_settings #=> Array
resp.conversation_log_settings.audio_log_settings[0].enabled #=> Boolean
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.kms_key_arn #=> String
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.s3_bucket_arn #=> String
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.log_prefix #=> String
resp.sentiment_analysis_settings.detect_sentiment #=> Boolean
resp.bot_alias_status #=> String, one of "Creating", "Available", "Deleting", "Failed"
resp.bot_id #=> String
resp.creation_date_time #=> Time
resp.tags #=> Hash
resp.tags["TagKey"] #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :bot_alias_name (required, String)

    The alias to create. The name must be unique for the bot.

  • :description (String)

    A description of the alias. Use this description to help identify the alias.

  • :bot_version (String)

    The version of the bot that this alias points to. You can use the operation to change the bot version associated with the alias.

  • :bot_alias_locale_settings (Hash<String,Types::BotAliasLocaleSettings>)

    Maps configuration information to a specific locale. You can use this parameter to specify a specific Lambda function to run different functions in different locales.

  • :conversation_log_settings (Types::ConversationLogSettings)

    Specifies whether Amazon Lex logs text and audio for a conversation with the bot. When you enable conversation logs, text logs store text input, transcripts of audio input, and associated metadata in Amazon CloudWatch Logs. Audio logs store audio input in Amazon S3.

  • :sentiment_analysis_settings (Types::SentimentAnalysisSettings)

    Determines whether Amazon Lex will use Amazon Comprehend to detect the sentiment of user utterances.

  • :bot_id (required, String)

    The unique identifier of the bot that the alias applies to.

  • :tags (Hash<String,String>)

    A list of tags to add to the bot alias. You can only add tags when you create an alias, you can't use the UpdateBotAlias operation to update the tags on a bot alias. To update tags, use the TagResource operation.

Returns:

See Also:



616
617
618
619
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 616

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

#create_bot_locale(params = {}) ⇒ Types::CreateBotLocaleResponse

Creates a locale in the bot. The locale contains the intents and slot types that the bot uses in conversations with users in the specified language and locale. You must add a locale to a bot before you can add intents and slot types to the bot.

Examples:

Request syntax with placeholder values


resp = client.create_bot_locale({
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
  description: "Description",
  nlu_intent_confidence_threshold: 1.0, # required
  voice_settings: {
    voice_id: "VoiceId", # required
  },
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_name #=> String
resp.locale_id #=> String
resp.description #=> String
resp.nlu_intent_confidence_threshold #=> Float
resp.voice_settings.voice_id #=> String
resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to create the locale for.

  • :bot_version (required, String)

    The version of the bot to create the locale for. This can only be the draft version of the bot.

  • :locale_id (required, String)

    The identifier of the language and locale that the bot will be used in. The string must match one of the supported locales. All of the intents, slot types, and slots used in the bot must have the same locale. For more information, see Supported languages.

  • :description (String)

    A description of the bot locale. Use this to help identify the bot locale in lists.

  • :nlu_intent_confidence_threshold (required, Float)

    Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot.

    For example, suppose a bot is configured with the confidence threshold of 0.80 and the AMAZON.FallbackIntent. Amazon Lex returns three alternative intents with the following confidence scores: IntentA (0.70), IntentB (0.60), IntentC (0.50). The response from the RecognizeText operation would be:

    • AMAZON.FallbackIntent

    • IntentA

    • IntentB

    • IntentC

  • :voice_settings (Types::VoiceSettings)

    The Amazon Polly voice ID that Amazon Lex uses for voice interaction with the user.

Returns:

See Also:



713
714
715
716
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 713

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

#create_bot_version(params = {}) ⇒ Types::CreateBotVersionResponse

Creates a new version of the bot based on the DRAFT version. If the DRAFT version of this resource hasn't changed since you created the last version, Amazon Lex doesn't create a new version, it returns the last created version.

When you create the first version of a bot, Amazon Lex sets the version to 1. Subsequent versions increment by 1.

Examples:

Request syntax with placeholder values


resp = client.create_bot_version({
  bot_id: "Id", # required
  description: "Description",
  bot_version_locale_specification: { # required
    "LocaleId" => {
      source_bot_version: "BotVersion", # required
    },
  },
})

Response structure


resp.bot_id #=> String
resp.description #=> String
resp.bot_version #=> String
resp.bot_version_locale_specification #=> Hash
resp.bot_version_locale_specification["LocaleId"].source_bot_version #=> String
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to create the version for.

  • :description (String)

    A description of the version. Use the description to help identify the version in lists.

  • :bot_version_locale_specification (required, Hash<String,Types::BotVersionLocaleDetails>)

    Specifies the locales that Amazon Lex adds to this version. You can choose the Draft version or any other previously published version for each locale. When you specify a source version, the locale data is copied from the source version to the new version.

Returns:

See Also:



774
775
776
777
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 774

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

#create_export(params = {}) ⇒ Types::CreateExportResponse

Creates a zip archive containing the contents of a bot or a bot locale. The archive contains a directory structure that contains JSON files that define the bot.

You can create an archive that contains the complete definition of a bot, or you can specify that the archive contain only the definition of a single bot locale.

For more information about exporting bots, and about the structure of the export archive, see Importing and exporting bots

Examples:

Request syntax with placeholder values


resp = client.create_export({
  resource_specification: { # required
    bot_export_specification: {
      bot_id: "Id", # required
      bot_version: "BotVersion", # required
    },
    bot_locale_export_specification: {
      bot_id: "Id", # required
      bot_version: "BotVersion", # required
      locale_id: "LocaleId", # required
    },
  },
  file_format: "LexJson", # required, accepts LexJson
  file_password: "ImportExportFilePassword",
})

Response structure


resp.export_id #=> String
resp.resource_specification.bot_export_specification.bot_id #=> String
resp.resource_specification.bot_export_specification.bot_version #=> String
resp.resource_specification.bot_locale_export_specification.bot_id #=> String
resp.resource_specification.bot_locale_export_specification.bot_version #=> String
resp.resource_specification.bot_locale_export_specification.locale_id #=> String
resp.file_format #=> String, one of "LexJson"
resp.export_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :resource_specification (required, Types::ExportResourceSpecification)

    Specifies the type of resource to export, either a bot or a bot locale. You can only specify one type of resource to export.

  • :file_format (required, String)

    The file format of the bot or bot locale definition files.

  • :file_password (String)

    An password to use to encrypt the exported archive. Using a password is optional, but you should encrypt the archive to protect the data in transit between Amazon Lex and your local computer.

Returns:

See Also:



848
849
850
851
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 848

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

#create_intent(params = {}) ⇒ Types::CreateIntentResponse

Creates an intent.

To define the interaction between the user and your bot, you define one or more intents. For example, for a pizza ordering bot you would create an OrderPizza intent.

When you create an intent, you must provide a name. You can optionally provide the following:

  • Sample utterances. For example, "I want to order a pizza" and "Can I order a pizza." You can't provide utterances for built-in intents.

  • Information to be gathered. You specify slots for the information that you bot requests from the user. You can specify standard slot types, such as date and time, or custom slot types for your application.

  • How the intent is fulfilled. You can provide a Lambda function or configure the intent to return the intent information to your client application. If you use a Lambda function, Amazon Lex invokes the function when all of the intent information is available.

  • A confirmation prompt to send to the user to confirm an intent. For example, "Shall I order your pizza?"

  • A conclusion statement to send to the user after the intent is fulfilled. For example, "I ordered your pizza."

  • A follow-up prompt that asks the user for additional activity. For example, "Do you want a drink with your pizza?"

Examples:

Request syntax with placeholder values


resp = client.create_intent({
  intent_name: "Name", # required
  description: "Description",
  parent_intent_signature: "IntentSignature",
  sample_utterances: [
    {
      utterance: "Utterance", # required
    },
  ],
  dialog_code_hook: {
    enabled: false, # required
  },
  fulfillment_code_hook: {
    enabled: false, # required
    post_fulfillment_status_specification: {
      success_response: {
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      failure_response: {
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      timeout_response: {
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
    },
    fulfillment_updates_specification: {
      active: false, # required
      start_response: {
        delay_in_seconds: 1, # required
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      update_response: {
        frequency_in_seconds: 1, # required
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      timeout_in_seconds: 1,
    },
  },
  intent_confirmation_setting: {
    prompt_specification: { # required
      message_groups: [ # required
        {
          message: { # required
            plain_text_message: {
              value: "PlainTextMessageValue", # required
            },
            custom_payload: {
              value: "CustomPayloadValue", # required
            },
            ssml_message: {
              value: "SSMLMessageValue", # required
            },
            image_response_card: {
              title: "AttachmentTitle", # required
              subtitle: "AttachmentTitle",
              image_url: "AttachmentUrl",
              buttons: [
                {
                  text: "ButtonText", # required
                  value: "ButtonValue", # required
                },
              ],
            },
          },
          variations: [
            {
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
          ],
        },
      ],
      max_retries: 1, # required
      allow_interrupt: false,
    },
    declination_response: { # required
      message_groups: [ # required
        {
          message: { # required
            plain_text_message: {
              value: "PlainTextMessageValue", # required
            },
            custom_payload: {
              value: "CustomPayloadValue", # required
            },
            ssml_message: {
              value: "SSMLMessageValue", # required
            },
            image_response_card: {
              title: "AttachmentTitle", # required
              subtitle: "AttachmentTitle",
              image_url: "AttachmentUrl",
              buttons: [
                {
                  text: "ButtonText", # required
                  value: "ButtonValue", # required
                },
              ],
            },
          },
          variations: [
            {
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
          ],
        },
      ],
      allow_interrupt: false,
    },
    active: false,
  },
  intent_closing_setting: {
    closing_response: { # required
      message_groups: [ # required
        {
          message: { # required
            plain_text_message: {
              value: "PlainTextMessageValue", # required
            },
            custom_payload: {
              value: "CustomPayloadValue", # required
            },
            ssml_message: {
              value: "SSMLMessageValue", # required
            },
            image_response_card: {
              title: "AttachmentTitle", # required
              subtitle: "AttachmentTitle",
              image_url: "AttachmentUrl",
              buttons: [
                {
                  text: "ButtonText", # required
                  value: "ButtonValue", # required
                },
              ],
            },
          },
          variations: [
            {
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
          ],
        },
      ],
      allow_interrupt: false,
    },
    active: false,
  },
  input_contexts: [
    {
      name: "Name", # required
    },
  ],
  output_contexts: [
    {
      name: "Name", # required
      time_to_live_in_seconds: 1, # required
      turns_to_live: 1, # required
    },
  ],
  kendra_configuration: {
    kendra_index: "KendraIndexArn", # required
    query_filter_string_enabled: false,
    query_filter_string: "QueryFilterString",
  },
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.intent_id #=> String
resp.intent_name #=> String
resp.description #=> String
resp.parent_intent_signature #=> String
resp.sample_utterances #=> Array
resp.sample_utterances[0].utterance #=> String
resp.dialog_code_hook.enabled #=> Boolean
resp.fulfillment_code_hook.enabled #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.active #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.delay_in_seconds #=> Integer
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.frequency_in_seconds #=> Integer
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.timeout_in_seconds #=> Integer
resp.intent_confirmation_setting.prompt_specification.message_groups #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.plain_text_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.custom_payload.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.ssml_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.title #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.prompt_specification.max_retries #=> Integer
resp.intent_confirmation_setting.prompt_specification.allow_interrupt #=> Boolean
resp.intent_confirmation_setting.declination_response.message_groups #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].message.plain_text_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.custom_payload.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.ssml_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.title #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.declination_response.allow_interrupt #=> Boolean
resp.intent_confirmation_setting.active #=> Boolean
resp.intent_closing_setting.closing_response.message_groups #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].message.plain_text_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.custom_payload.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.ssml_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.title #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_closing_setting.closing_response.allow_interrupt #=> Boolean
resp.intent_closing_setting.active #=> Boolean
resp.input_contexts #=> Array
resp.input_contexts[0].name #=> String
resp.output_contexts #=> Array
resp.output_contexts[0].name #=> String
resp.output_contexts[0].time_to_live_in_seconds #=> Integer
resp.output_contexts[0].turns_to_live #=> Integer
resp.kendra_configuration.kendra_index #=> String
resp.kendra_configuration.query_filter_string_enabled #=> Boolean
resp.kendra_configuration.query_filter_string #=> String
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :intent_name (required, String)

    The name of the intent. Intent names must be unique in the locale that contains the intent and cannot match the name of any built-in intent.

  • :description (String)

    A description of the intent. Use the description to help identify the intent in lists.

  • :parent_intent_signature (String)

    A unique identifier for the built-in intent to base this intent on.

  • :sample_utterances (Array<Types::SampleUtterance>)

    An array of strings that a user might say to signal the intent. For example, "I want a pizza", or "I want a {PizzaSize\} pizza".

    In an utterance, slot names are enclosed in curly braces ("{", "\}") to indicate where they should be displayed in the utterance shown to the user..

  • :dialog_code_hook (Types::DialogCodeHookSettings)

    Specifies that Amazon Lex invokes the alias Lambda function for each user input. You can invoke this Lambda function to personalize user interaction.

    For example, suppose that your bot determines that the user's name is John. You Lambda function might retrieve John's information from a backend database and prepopulate some of the values. For example, if you find that John is gluten intolerant, you might set the corresponding intent slot, glutenIntolerant to true. You might find John's phone number and set the corresponding session attribute.

  • :fulfillment_code_hook (Types::FulfillmentCodeHookSettings)

    Specifies that Amazon Lex invokes the alias Lambda function when the intent is ready for fulfillment. You can invoke this function to complete the bot's transaction with the user.

    For example, in a pizza ordering bot, the Lambda function can look up the closest pizza restaurant to the customer's location and then place an order on the customer's behalf.

  • :intent_confirmation_setting (Types::IntentConfirmationSetting)

    Provides prompts that Amazon Lex sends to the user to confirm the completion of an intent. If the user answers "no," the settings contain a statement that is sent to the user to end the intent.

  • :intent_closing_setting (Types::IntentClosingSetting)

    Sets the response that Amazon Lex sends to the user when the intent is closed.

  • :input_contexts (Array<Types::InputContext>)

    A list of contexts that must be active for this intent to be considered by Amazon Lex.

    When an intent has an input context list, Amazon Lex only considers using the intent in an interaction with the user when the specified contexts are included in the active context list for the session. If the contexts are not active, then Amazon Lex will not use the intent.

    A context can be automatically activated using the outputContexts property or it can be set at runtime.

    For example, if there are two intents with different input contexts that respond to the same utterances, only the intent with the active context will respond.

    An intent may have up to 5 input contexts. If an intent has multiple input contexts, all of the contexts must be active to consider the intent.

  • :output_contexts (Array<Types::OutputContext>)

    A lists of contexts that the intent activates when it is fulfilled.

    You can use an output context to indicate the intents that Amazon Lex should consider for the next turn of the conversation with a customer.

    When you use the outputContextsList property, all of the contexts specified in the list are activated when the intent is fulfilled. You can set up to 10 output contexts. You can also set the number of conversation turns that the context should be active, or the length of time that the context should be active.

  • :kendra_configuration (Types::KendraConfiguration)

    Configuration information required to use the AMAZON.KendraSearchIntent intent to connect to an Amazon Kendra index. The AMAZON.KendraSearchIntent intent is called when Amazon Lex can't determine another intent to invoke.

  • :bot_id (required, String)

    The identifier of the bot associated with this intent.

  • :bot_version (required, String)

    The identifier of the version of the bot associated with this intent.

  • :locale_id (required, String)

    The identifier of the language and locale where this intent is used. All of the bots, slot types, and slots used by the intent must have the same locale. For more information, see Supported languages.

Returns:

See Also:



1687
1688
1689
1690
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 1687

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

#create_resource_policy(params = {}) ⇒ Types::CreateResourcePolicyResponse

Creates a new resource policy with the specified policy statements.

Examples:

Request syntax with placeholder values


resp = client.create_resource_policy({
  resource_arn: "AmazonResourceName", # required
  policy: "Policy", # required
})

Response structure


resp.resource_arn #=> String
resp.revision_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • :policy (required, String)

    A resource policy to add to the resource. The policy is a JSON structure that contains one or more statements that define the policy. The policy must follow the IAM syntax. For more information about the contents of a JSON policy document, see IAM JSON policy reference .

    If the policy isn't valid, Amazon Lex returns a validation exception.

Returns:

See Also:



1732
1733
1734
1735
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 1732

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

#create_resource_policy_statement(params = {}) ⇒ Types::CreateResourcePolicyStatementResponse

Adds a new resource policy statement to a bot or bot alias. If a resource policy exists, the statement is added to the current resource policy. If a policy doesn't exist, a new policy is created.

You can't create a resource policy statement that allows cross-account access.

Examples:

Request syntax with placeholder values


resp = client.create_resource_policy_statement({
  resource_arn: "AmazonResourceName", # required
  statement_id: "Name", # required
  effect: "Allow", # required, accepts Allow, Deny
  principal: [ # required
    {
      service: "ServicePrincipal",
      arn: "PrincipalArn",
    },
  ],
  action: ["Operation"], # required
  condition: {
    "ConditionOperator" => {
      "ConditionKey" => "ConditionValue",
    },
  },
  expected_revision_id: "RevisionId",
})

Response structure


resp.resource_arn #=> String
resp.revision_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • :statement_id (required, String)

    The name of the statement. The ID is the same as the Sid IAM property. The statement name must be unique within the policy. For more information, see IAM JSON policy elements: Sid.

  • :effect (required, String)

    Determines whether the statement allows or denies access to the resource.

  • :principal (required, Array<Types::Principal>)

    An IAM principal, such as an IAM users, IAM roles, or AWS services that is allowed or denied access to a resource. For more information, see AWS JSON policy elements: Principal.

  • :action (required, Array<String>)

    The Amazon Lex action that this policy either allows or denies. The action must apply to the resource type of the specified ARN. For more information, see Actions, resources, and condition keys for Amazon Lex V2.

  • :condition (Hash<String,Hash>)

    Specifies a condition when the policy is in effect. If the principal of the policy is a service principal, you must provide two condition blocks, one with a SourceAccount global condition key and one with a SourceArn global condition key.

    For more information, see IAM JSON policy elements: Condition .

  • :expected_revision_id (String)

    The identifier of the revision of the policy to edit. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.

    If you don't specify a revision, Amazon Lex overwrites the contents of the policy with the new values.

Returns:

See Also:



1835
1836
1837
1838
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 1835

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

#create_slot(params = {}) ⇒ Types::CreateSlotResponse

Creates a slot in an intent. A slot is a variable needed to fulfill an intent. For example, an OrderPizza intent might need slots for size, crust, and number of pizzas. For each slot, you define one or more utterances that Amazon Lex uses to elicit a response from the user.

Examples:

Request syntax with placeholder values


resp = client.create_slot({
  slot_name: "Name", # required
  description: "Description",
  slot_type_id: "BuiltInOrCustomSlotTypeId", # required
  value_elicitation_setting: { # required
    default_value_specification: {
      default_value_list: [ # required
        {
          default_value: "SlotDefaultValueString", # required
        },
      ],
    },
    slot_constraint: "Required", # required, accepts Required, Optional
    prompt_specification: {
      message_groups: [ # required
        {
          message: { # required
            plain_text_message: {
              value: "PlainTextMessageValue", # required
            },
            custom_payload: {
              value: "CustomPayloadValue", # required
            },
            ssml_message: {
              value: "SSMLMessageValue", # required
            },
            image_response_card: {
              title: "AttachmentTitle", # required
              subtitle: "AttachmentTitle",
              image_url: "AttachmentUrl",
              buttons: [
                {
                  text: "ButtonText", # required
                  value: "ButtonValue", # required
                },
              ],
            },
          },
          variations: [
            {
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
          ],
        },
      ],
      max_retries: 1, # required
      allow_interrupt: false,
    },
    sample_utterances: [
      {
        utterance: "Utterance", # required
      },
    ],
    wait_and_continue_specification: {
      waiting_response: { # required
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      continue_response: { # required
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        allow_interrupt: false,
      },
      still_waiting_response: {
        message_groups: [ # required
          {
            message: { # required
              plain_text_message: {
                value: "PlainTextMessageValue", # required
              },
              custom_payload: {
                value: "CustomPayloadValue", # required
              },
              ssml_message: {
                value: "SSMLMessageValue", # required
              },
              image_response_card: {
                title: "AttachmentTitle", # required
                subtitle: "AttachmentTitle",
                image_url: "AttachmentUrl",
                buttons: [
                  {
                    text: "ButtonText", # required
                    value: "ButtonValue", # required
                  },
                ],
              },
            },
            variations: [
              {
                plain_text_message: {
                  value: "PlainTextMessageValue", # required
                },
                custom_payload: {
                  value: "CustomPayloadValue", # required
                },
                ssml_message: {
                  value: "SSMLMessageValue", # required
                },
                image_response_card: {
                  title: "AttachmentTitle", # required
                  subtitle: "AttachmentTitle",
                  image_url: "AttachmentUrl",
                  buttons: [
                    {
                      text: "ButtonText", # required
                      value: "ButtonValue", # required
                    },
                  ],
                },
              },
            ],
          },
        ],
        frequency_in_seconds: 1, # required
        timeout_in_seconds: 1, # required
        allow_interrupt: false,
      },
      active: false,
    },
  },
  obfuscation_setting: {
    obfuscation_setting_type: "None", # required, accepts None, DefaultObfuscation
  },
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
  intent_id: "Id", # required
  multiple_values_setting: {
    allow_multiple_values: false,
  },
})

Response structure


resp.slot_id #=> String
resp.slot_name #=> String
resp.description #=> String
resp.slot_type_id #=> String
resp.value_elicitation_setting.default_value_specification.default_value_list #=> Array
resp.value_elicitation_setting.default_value_specification.default_value_list[0].default_value #=> String
resp.value_elicitation_setting.slot_constraint #=> String, one of "Required", "Optional"
resp.value_elicitation_setting.prompt_specification.message_groups #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.prompt_specification.max_retries #=> Integer
resp.value_elicitation_setting.prompt_specification.allow_interrupt #=> Boolean
resp.value_elicitation_setting.sample_utterances #=> Array
resp.value_elicitation_setting.sample_utterances[0].utterance #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.frequency_in_seconds #=> Integer
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.timeout_in_seconds #=> Integer
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.active #=> Boolean
resp.obfuscation_setting.obfuscation_setting_type #=> String, one of "None", "DefaultObfuscation"
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.intent_id #=> String
resp.creation_date_time #=> Time
resp.multiple_values_setting.allow_multiple_values #=> Boolean

Parameters:

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

    ({})

Options Hash (params):

  • :slot_name (required, String)

    The name of the slot. Slot names must be unique within the bot that contains the slot.

  • :description (String)

    A description of the slot. Use this to help identify the slot in lists.

  • :slot_type_id (required, String)

    The unique identifier for the slot type associated with this slot. The slot type determines the values that can be entered into the slot.

  • :value_elicitation_setting (required, Types::SlotValueElicitationSetting)

    Specifies prompts that Amazon Lex sends to the user to elicit a response that provides the value for the slot.

  • :obfuscation_setting (Types::ObfuscationSetting)

    Determines how slot values are used in Amazon CloudWatch logs. If the value of the obfuscationSetting parameter is DefaultObfuscation, slot values are obfuscated in the log output. If the value is None, the actual value is present in the log output.

    The default is to obfuscate values in the CloudWatch logs.

  • :bot_id (required, String)

    The identifier of the bot associated with the slot.

  • :bot_version (required, String)

    The version of the bot associated with the slot.

  • :locale_id (required, String)

    The identifier of the language and locale that the slot will be used in. The string must match one of the supported locales. All of the bots, intents, slot types used by the slot must have the same locale. For more information, see Supported languages.

  • :intent_id (required, String)

    The identifier of the intent that contains the slot.

  • :multiple_values_setting (Types::MultipleValuesSetting)

    Indicates whether the slot returns multiple values in one response. Multi-value slots are only available in the en-US locale. If you set this value to true in any other locale, Amazon Lex throws a ValidationException.

    If the multipleValuesSetting is not set, the default value is false.

Returns:

See Also:



2274
2275
2276
2277
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2274

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

#create_slot_type(params = {}) ⇒ Types::CreateSlotTypeResponse

Creates a custom slot type

To create a custom slot type, specify a name for the slot type and a set of enumeration values, the values that a slot of this type can assume.

Examples:

Request syntax with placeholder values


resp = client.create_slot_type({
  slot_type_name: "Name", # required
  description: "Description",
  slot_type_values: [
    {
      sample_value: {
        value: "Value", # required
      },
      synonyms: [
        {
          value: "Value", # required
        },
      ],
    },
  ],
  value_selection_setting: { # required
    resolution_strategy: "OriginalValue", # required, accepts OriginalValue, TopResolution
    regex_filter: {
      pattern: "RegexPattern", # required
    },
  },
  parent_slot_type_signature: "SlotTypeSignature",
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.slot_type_id #=> String
resp.slot_type_name #=> String
resp.description #=> String
resp.slot_type_values #=> Array
resp.slot_type_values[0].sample_value.value #=> String
resp.slot_type_values[0].synonyms #=> Array
resp.slot_type_values[0].synonyms[0].value #=> String
resp.value_selection_setting.resolution_strategy #=> String, one of "OriginalValue", "TopResolution"
resp.value_selection_setting.regex_filter.pattern #=> String
resp.parent_slot_type_signature #=> String
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :slot_type_name (required, String)

    The name for the slot. A slot type name must be unique within the account.

  • :description (String)

    A description of the slot type. Use the description to help identify the slot type in lists.

  • :slot_type_values (Array<Types::SlotTypeValue>)

    A list of SlotTypeValue objects that defines the values that the slot type can take. Each value can have a list of synonyms, additional values that help train the machine learning model about the values that it resolves for a slot.

  • :value_selection_setting (required, Types::SlotValueSelectionSetting)

    Determines the strategy that Amazon Lex uses to select a value from the list of possible values. The field can be set to one of the following values:

    • OriginalValue - Returns the value entered by the user, if the user value is similar to the slot value.

    • TopResolution - If there is a resolution list for the slot, return the first value in the resolution list. If there is no resolution list, return null.

    If you don't specify the valueSelectionSetting parameter, the default is OriginalValue.

  • :parent_slot_type_signature (String)

    The built-in slot type used as a parent of this slot type. When you define a parent slot type, the new slot type has the configuration of the parent slot type.

    Only AMAZON.AlphaNumeric is supported.

  • :bot_id (required, String)

    The identifier of the bot associated with this slot type.

  • :bot_version (required, String)

    The identifier of the bot version associated with this slot type.

  • :locale_id (required, String)

    The identifier of the language and locale that the slot type will be used in. The string must match one of the supported locales. All of the bots, intents, and slots used by the slot type must have the same locale. For more information, see Supported languages.

Returns:

See Also:



2400
2401
2402
2403
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2400

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

#create_upload_url(params = {}) ⇒ Types::CreateUploadUrlResponse

Gets a pre-signed S3 write URL that you use to upload the zip archive when importing a bot or a bot locale.

Examples:

Response structure


resp.import_id #=> String
resp.upload_url #=> String

Parameters:

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

    ({})

Returns:

See Also:



2422
2423
2424
2425
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2422

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

#delete_bot(params = {}) ⇒ Types::DeleteBotResponse

Deletes all versions of a bot, including the Draft version. To delete a specific version, use the DeleteBotVersion operation.

When you delete a bot, all of the resources contained in the bot are also deleted. Deleting a bot removes all locales, intents, slot, and slot types defined for the bot.

If a bot has an alias, the DeleteBot operation returns a ResourceInUseException exception. If you want to delete the bot and the alias, set the skipResourceInUseCheck parameter to true.

Examples:

Request syntax with placeholder values


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

Response structure


resp.bot_id #=> String
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to delete.

  • :skip_resource_in_use_check (Boolean)

    When true, Amazon Lex doesn't check to see if another resource, such as an alias, is using the bot before it is deleted.

Returns:

See Also:



2466
2467
2468
2469
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2466

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

#delete_bot_alias(params = {}) ⇒ Types::DeleteBotAliasResponse

Deletes the specified bot alias.

Examples:

Request syntax with placeholder values


resp = client.delete_bot_alias({
  bot_alias_id: "BotAliasId", # required
  bot_id: "Id", # required
  skip_resource_in_use_check: false,
})

Response structure


resp.bot_alias_id #=> String
resp.bot_id #=> String
resp.bot_alias_status #=> String, one of "Creating", "Available", "Deleting", "Failed"

Parameters:

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

    ({})

Options Hash (params):

  • :bot_alias_id (required, String)

    The unique identifier of the bot alias to delete.

  • :bot_id (required, String)

    The unique identifier of the bot associated with the alias to delete.

  • :skip_resource_in_use_check (Boolean)

    When this parameter is true, Amazon Lex doesn't check to see if any other resource is using the alias before it is deleted.

Returns:

See Also:



2507
2508
2509
2510
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2507

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

#delete_bot_locale(params = {}) ⇒ Types::DeleteBotLocaleResponse

Removes a locale from a bot.

When you delete a locale, all intents, slots, and slot types defined for the locale are also deleted.

Examples:

Request syntax with placeholder values


resp = client.delete_bot_locale({
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The unique identifier of the bot that contains the locale.

  • :bot_version (required, String)

    The version of the bot that contains the locale.

  • :locale_id (required, String)

    The identifier of the language and locale that will be deleted. The string must match one of the supported locales. For more information, see Supported languages.

Returns:

See Also:



2558
2559
2560
2561
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2558

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

#delete_bot_version(params = {}) ⇒ Types::DeleteBotVersionResponse

Deletes a specific version of a bot. To delete all version of a bot, use the DeleteBot operation.

Examples:

Request syntax with placeholder values


resp = client.delete_bot_version({
  bot_id: "Id", # required
  bot_version: "NumericalBotVersion", # required
  skip_resource_in_use_check: false,
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot that contains the version.

  • :bot_version (required, String)

    The version of the bot to delete.

  • :skip_resource_in_use_check (Boolean)

    By default, the DeleteBotVersion operations throws a ResourceInUseException exception if you try to delete a bot version that has an alias pointing at it. Set the skipResourceInUseCheck parameter to true to skip this check and remove the version even if an alias points to it.

Returns:

See Also:



2603
2604
2605
2606
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2603

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

#delete_export(params = {}) ⇒ Types::DeleteExportResponse

Removes a previous export and the associated files stored in an S3 bucket.

Examples:

Request syntax with placeholder values


resp = client.delete_export({
  export_id: "Id", # required
})

Response structure


resp.export_id #=> String
resp.export_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"

Parameters:

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

    ({})

Options Hash (params):

  • :export_id (required, String)

    The unique identifier of the export to delete.

Returns:

See Also:



2634
2635
2636
2637
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2634

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

#delete_import(params = {}) ⇒ Types::DeleteImportResponse

Removes a previous import and the associated file stored in an S3 bucket.

Examples:

Request syntax with placeholder values


resp = client.delete_import({
  import_id: "Id", # required
})

Response structure


resp.import_id #=> String
resp.import_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"

Parameters:

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

    ({})

Options Hash (params):

  • :import_id (required, String)

    The unique identifier of the import to delete.

Returns:

See Also:



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

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

#delete_intent(params = {}) ⇒ Struct

Removes the specified intent.

Deleting an intent also deletes the slots associated with the intent.

Examples:

Request syntax with placeholder values


resp = client.delete_intent({
  intent_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
})

Parameters:

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

    ({})

Options Hash (params):

  • :intent_id (required, String)

    The unique identifier of the intent to delete.

  • :bot_id (required, String)

    The identifier of the bot associated with the intent.

  • :bot_version (required, String)

    The version of the bot associated with the intent.

  • :locale_id (required, String)

    The identifier of the language and locale where the bot will be deleted. The string must match one of the supported locales. For more information, see Supported languages.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2707
2708
2709
2710
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2707

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

#delete_resource_policy(params = {}) ⇒ Types::DeleteResourcePolicyResponse

Removes an existing policy from a bot or bot alias. If the resource doesn't have a policy attached, Amazon Lex returns an exception.

Examples:

Request syntax with placeholder values


resp = client.delete_resource_policy({
  resource_arn: "AmazonResourceName", # required
  expected_revision_id: "RevisionId",
})

Response structure


resp.resource_arn #=> String
resp.revision_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the bot or bot alias that has the resource policy attached.

  • :expected_revision_id (String)

    The identifier of the revision to edit. If this ID doesn't match the current revision number, Amazon Lex returns an exception

    If you don't specify a revision ID, Amazon Lex will delete the current policy.

Returns:

See Also:



2747
2748
2749
2750
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2747

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

#delete_resource_policy_statement(params = {}) ⇒ Types::DeleteResourcePolicyStatementResponse

Deletes a policy statement from a resource policy. If you delete the last statement from a policy, the policy is deleted. If you specify a statement ID that doesn't exist in the policy, or if the bot or bot alias doesn't have a policy attached, Amazon Lex returns an exception.

Examples:

Request syntax with placeholder values


resp = client.delete_resource_policy_statement({
  resource_arn: "AmazonResourceName", # required
  statement_id: "Name", # required
  expected_revision_id: "RevisionId",
})

Response structure


resp.resource_arn #=> String
resp.revision_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

  • :statement_id (required, String)

    The name of the statement (SID) to delete from the policy.

  • :expected_revision_id (String)

    The identifier of the revision of the policy to delete the statement from. If this revision ID doesn't match the current revision ID, Amazon Lex throws an exception.

    If you don't specify a revision, Amazon Lex removes the current contents of the statement.

Returns:

See Also:



2795
2796
2797
2798
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2795

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

#delete_slot(params = {}) ⇒ Struct

Deletes the specified slot from an intent.

Examples:

Request syntax with placeholder values


resp = client.delete_slot({
  slot_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
  intent_id: "Id", # required
})

Parameters:

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

    ({})

Options Hash (params):

  • :slot_id (required, String)

    The identifier of the slot to delete.

  • :bot_id (required, String)

    The identifier of the bot associated with the slot to delete.

  • :bot_version (required, String)

    The version of the bot associated with the slot to delete.

  • :locale_id (required, String)

    The identifier of the language and locale that the slot will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

  • :intent_id (required, String)

    The identifier of the intent associated with the slot.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2839
2840
2841
2842
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2839

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

#delete_slot_type(params = {}) ⇒ Struct

Deletes a slot type from a bot locale.

If a slot is using the slot type, Amazon Lex throws a ResourceInUseException exception. To avoid the exception, set the skipResourceInUseCheck parameter to true.

Examples:

Request syntax with placeholder values


resp = client.delete_slot_type({
  slot_type_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "DraftBotVersion", # required
  locale_id: "LocaleId", # required
  skip_resource_in_use_check: false,
})

Parameters:

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

    ({})

Options Hash (params):

  • :slot_type_id (required, String)

    The identifier of the slot type to delete.

  • :bot_id (required, String)

    The identifier of the bot associated with the slot type.

  • :bot_version (required, String)

    The version of the bot associated with the slot type.

  • :locale_id (required, String)

    The identifier of the language and locale that the slot type will be deleted from. The string must match one of the supported locales. For more information, see Supported languages.

  • :skip_resource_in_use_check (Boolean)

    By default, the DeleteSlotType operations throws a ResourceInUseException exception if you try to delete a slot type used by a slot. Set the skipResourceInUseCheck parameter to true to skip this check and remove the slot type even if a slot uses it.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2890
2891
2892
2893
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2890

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

#delete_utterances(params = {}) ⇒ Struct

Deletes stored utterances.

Amazon Lex stores the utterances that users send to your bot. Utterances are stored for 15 days for use with the operation, and then stored indefinitely for use in improving the ability of your bot to respond to user input..

Use the DeleteUtterances operation to manually delete utterances for a specific session. When you use the DeleteUtterances operation, utterances stored for improving your bot's ability to respond to user input are deleted immediately. Utterances stored for use with the ListAggregatedUtterances operation are deleted after 15 days.

Examples:

Request syntax with placeholder values


resp = client.delete_utterances({
  bot_id: "Id", # required
  locale_id: "LocaleId",
  session_id: "SessionId",
})

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The unique identifier of the bot that contains the utterances.

  • :locale_id (String)

    The identifier of the language and locale where the utterances were collected. The string must match one of the supported locales. For more information, see Supported languages.

  • :session_id (String)

    The unique identifier of the session with the user. The ID is returned in the response from the and operations.

Returns:

  • (Struct)

    Returns an empty response.

See Also:



2938
2939
2940
2941
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2938

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

#describe_bot(params = {}) ⇒ Types::DescribeBotResponse

Provides metadata information about a bot.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_available

Examples:

Request syntax with placeholder values


resp = client.describe_bot({
  bot_id: "Id", # required
})

Response structure


resp.bot_id #=> String
resp.bot_name #=> String
resp.description #=> String
resp.role_arn #=> String
resp.data_privacy.child_directed #=> Boolean
resp.idle_session_ttl_in_seconds #=> Integer
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The unique identifier of the bot to describe.

Returns:

See Also:



2987
2988
2989
2990
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 2987

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

#describe_bot_alias(params = {}) ⇒ Types::DescribeBotAliasResponse

Get information about a specific bot alias.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_alias_available

Examples:

Request syntax with placeholder values


resp = client.describe_bot_alias({
  bot_alias_id: "BotAliasId", # required
  bot_id: "Id", # required
})

Response structure


resp.bot_alias_id #=> String
resp.bot_alias_name #=> String
resp.description #=> String
resp.bot_version #=> String
resp.bot_alias_locale_settings #=> Hash
resp.bot_alias_locale_settings["LocaleId"].enabled #=> Boolean
resp.bot_alias_locale_settings["LocaleId"].code_hook_specification.lambda_code_hook.lambda_arn #=> String
resp.bot_alias_locale_settings["LocaleId"].code_hook_specification.lambda_code_hook.code_hook_interface_version #=> String
resp.conversation_log_settings.text_log_settings #=> Array
resp.conversation_log_settings.text_log_settings[0].enabled #=> Boolean
resp.conversation_log_settings.text_log_settings[0].destination.cloud_watch.cloud_watch_log_group_arn #=> String
resp.conversation_log_settings.text_log_settings[0].destination.cloud_watch.log_prefix #=> String
resp.conversation_log_settings.audio_log_settings #=> Array
resp.conversation_log_settings.audio_log_settings[0].enabled #=> Boolean
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.kms_key_arn #=> String
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.s3_bucket_arn #=> String
resp.conversation_log_settings.audio_log_settings[0].destination.s3_bucket.log_prefix #=> String
resp.sentiment_analysis_settings.detect_sentiment #=> Boolean
resp.bot_alias_history_events #=> Array
resp.bot_alias_history_events[0].bot_version #=> String
resp.bot_alias_history_events[0].start_date #=> Time
resp.bot_alias_history_events[0].end_date #=> Time
resp.bot_alias_status #=> String, one of "Creating", "Available", "Deleting", "Failed"
resp.bot_id #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_alias_id (required, String)

    The identifier of the bot alias to describe.

  • :bot_id (required, String)

    The identifier of the bot associated with the bot alias to describe.

Returns:

See Also:



3060
3061
3062
3063
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3060

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

#describe_bot_locale(params = {}) ⇒ Types::DescribeBotLocaleResponse

Describes the settings that a bot has for a specific locale.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_locale_built
  • bot_locale_created
  • bot_locale_express_testing_available

Examples:

Request syntax with placeholder values


resp = client.describe_bot_locale({
  bot_id: "Id", # required
  bot_version: "BotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.locale_name #=> String
resp.description #=> String
resp.nlu_intent_confidence_threshold #=> Float
resp.voice_settings.voice_id #=> String
resp.intents_count #=> Integer
resp.slot_types_count #=> Integer
resp.bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
resp.failure_reasons #=> Array
resp.failure_reasons[0] #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time
resp. #=> Time
resp.bot_locale_history_events #=> Array
resp.bot_locale_history_events[0].event #=> String
resp.bot_locale_history_events[0].event_date #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot associated with the locale.

  • :bot_version (required, String)

    The identifier of the version of the bot associated with the locale.

  • :locale_id (required, String)

    The unique identifier of the locale to describe. The string must match one of the supported locales. For more information, see Supported languages.

Returns:

See Also:



3140
3141
3142
3143
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3140

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

#describe_bot_version(params = {}) ⇒ Types::DescribeBotVersionResponse

Provides metadata about a version of a bot.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_version_available

Examples:

Request syntax with placeholder values


resp = client.describe_bot_version({
  bot_id: "Id", # required
  bot_version: "NumericalBotVersion", # required
})

Response structure


resp.bot_id #=> String
resp.bot_name #=> String
resp.bot_version #=> String
resp.description #=> String
resp.role_arn #=> String
resp.data_privacy.child_directed #=> Boolean
resp.idle_session_ttl_in_seconds #=> Integer
resp.bot_status #=> String, one of "Creating", "Available", "Inactive", "Deleting", "Failed", "Versioning", "Importing"
resp.failure_reasons #=> Array
resp.failure_reasons[0] #=> String
resp.creation_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot containing the version to return metadata for.

  • :bot_version (required, String)

    The version of the bot to return metadata for.

Returns:

See Also:



3197
3198
3199
3200
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3197

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

#describe_export(params = {}) ⇒ Types::DescribeExportResponse

Gets information about a specific export.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_export_completed

Examples:

Request syntax with placeholder values


resp = client.describe_export({
  export_id: "Id", # required
})

Response structure


resp.export_id #=> String
resp.resource_specification.bot_export_specification.bot_id #=> String
resp.resource_specification.bot_export_specification.bot_version #=> String
resp.resource_specification.bot_locale_export_specification.bot_id #=> String
resp.resource_specification.bot_locale_export_specification.bot_version #=> String
resp.resource_specification.bot_locale_export_specification.locale_id #=> String
resp.file_format #=> String, one of "LexJson"
resp.export_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
resp.failure_reasons #=> Array
resp.failure_reasons[0] #=> String
resp.download_url #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :export_id (required, String)

    The unique identifier of the export to describe.

Returns:

See Also:



3249
3250
3251
3252
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3249

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

#describe_import(params = {}) ⇒ Types::DescribeImportResponse

Gets information about a specific import.

The following waiters are defined for this operation (see #wait_until for detailed usage):

  • bot_import_completed

Examples:

Request syntax with placeholder values


resp = client.describe_import({
  import_id: "Id", # required
})

Response structure


resp.import_id #=> String
resp.resource_specification.bot_import_specification.bot_name #=> String
resp.resource_specification.bot_import_specification.role_arn #=> String
resp.resource_specification.bot_import_specification.data_privacy.child_directed #=> Boolean
resp.resource_specification.bot_import_specification.idle_session_ttl_in_seconds #=> Integer
resp.resource_specification.bot_import_specification.bot_tags #=> Hash
resp.resource_specification.bot_import_specification.bot_tags["TagKey"] #=> String
resp.resource_specification.bot_import_specification.test_bot_alias_tags #=> Hash
resp.resource_specification.bot_import_specification.test_bot_alias_tags["TagKey"] #=> String
resp.resource_specification.bot_locale_import_specification.bot_id #=> String
resp.resource_specification.bot_locale_import_specification.bot_version #=> String
resp.resource_specification.bot_locale_import_specification.locale_id #=> String
resp.resource_specification.bot_locale_import_specification.nlu_intent_confidence_threshold #=> Float
resp.resource_specification.bot_locale_import_specification.voice_settings.voice_id #=> String
resp.imported_resource_id #=> String
resp.imported_resource_name #=> String
resp.merge_strategy #=> String, one of "Overwrite", "FailOnConflict"
resp.import_status #=> String, one of "InProgress", "Completed", "Failed", "Deleting"
resp.failure_reasons #=> Array
resp.failure_reasons[0] #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :import_id (required, String)

    The unique identifier of the import to describe.

Returns:

See Also:



3311
3312
3313
3314
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3311

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

#describe_intent(params = {}) ⇒ Types::DescribeIntentResponse

Returns metadata about an intent.

Examples:

Request syntax with placeholder values


resp = client.describe_intent({
  intent_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "BotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.intent_id #=> String
resp.intent_name #=> String
resp.description #=> String
resp.parent_intent_signature #=> String
resp.sample_utterances #=> Array
resp.sample_utterances[0].utterance #=> String
resp.dialog_code_hook.enabled #=> Boolean
resp.fulfillment_code_hook.enabled #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.success_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.failure_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.post_fulfillment_status_specification.timeout_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.active #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.delay_in_seconds #=> Integer
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.start_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.frequency_in_seconds #=> Integer
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.fulfillment_code_hook.fulfillment_updates_specification.update_response.allow_interrupt #=> Boolean
resp.fulfillment_code_hook.fulfillment_updates_specification.timeout_in_seconds #=> Integer
resp.slot_priorities #=> Array
resp.slot_priorities[0].priority #=> Integer
resp.slot_priorities[0].slot_id #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.plain_text_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.custom_payload.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.ssml_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.title #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.prompt_specification.max_retries #=> Integer
resp.intent_confirmation_setting.prompt_specification.allow_interrupt #=> Boolean
resp.intent_confirmation_setting.declination_response.message_groups #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].message.plain_text_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.custom_payload.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.ssml_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.title #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_confirmation_setting.declination_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_confirmation_setting.declination_response.allow_interrupt #=> Boolean
resp.intent_confirmation_setting.active #=> Boolean
resp.intent_closing_setting.closing_response.message_groups #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].message.plain_text_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.custom_payload.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.ssml_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.title #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.image_url #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.intent_closing_setting.closing_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.intent_closing_setting.closing_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.intent_closing_setting.closing_response.allow_interrupt #=> Boolean
resp.intent_closing_setting.active #=> Boolean
resp.input_contexts #=> Array
resp.input_contexts[0].name #=> String
resp.output_contexts #=> Array
resp.output_contexts[0].name #=> String
resp.output_contexts[0].time_to_live_in_seconds #=> Integer
resp.output_contexts[0].turns_to_live #=> Integer
resp.kendra_configuration.kendra_index #=> String
resp.kendra_configuration.query_filter_string_enabled #=> Boolean
resp.kendra_configuration.query_filter_string #=> String
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :intent_id (required, String)

    The identifier of the intent to describe.

  • :bot_id (required, String)

    The identifier of the bot associated with the intent.

  • :bot_version (required, String)

    The version of the bot associated with the intent.

  • :locale_id (required, String)

    The identifier of the language and locale of the intent to describe. The string must match one of the supported locales. For more information, see Supported languages.

Returns:

See Also:



3573
3574
3575
3576
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3573

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

#describe_resource_policy(params = {}) ⇒ Types::DescribeResourcePolicyResponse

Gets the resource policy and policy revision for a bot or bot alias.

Examples:

Request syntax with placeholder values


resp = client.describe_resource_policy({
  resource_arn: "AmazonResourceName", # required
})

Response structure


resp.resource_arn #=> String
resp.policy #=> String
resp.revision_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :resource_arn (required, String)

    The Amazon Resource Name (ARN) of the bot or bot alias that the resource policy is attached to.

Returns:

See Also:



3606
3607
3608
3609
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3606

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

#describe_slot(params = {}) ⇒ Types::DescribeSlotResponse

Gets metadata information about a slot.

Examples:

Request syntax with placeholder values


resp = client.describe_slot({
  slot_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "BotVersion", # required
  locale_id: "LocaleId", # required
  intent_id: "Id", # required
})

Response structure


resp.slot_id #=> String
resp.slot_name #=> String
resp.description #=> String
resp.slot_type_id #=> String
resp.value_elicitation_setting.default_value_specification.default_value_list #=> Array
resp.value_elicitation_setting.default_value_specification.default_value_list[0].default_value #=> String
resp.value_elicitation_setting.slot_constraint #=> String, one of "Required", "Optional"
resp.value_elicitation_setting.prompt_specification.message_groups #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.prompt_specification.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.prompt_specification.max_retries #=> Integer
resp.value_elicitation_setting.prompt_specification.allow_interrupt #=> Boolean
resp.value_elicitation_setting.sample_utterances #=> Array
resp.value_elicitation_setting.sample_utterances[0].utterance #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.waiting_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.continue_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].message.image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].plain_text_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].custom_payload.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].ssml_message.value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.title #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.subtitle #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.image_url #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons #=> Array
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].text #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.message_groups[0].variations[0].image_response_card.buttons[0].value #=> String
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.frequency_in_seconds #=> Integer
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.timeout_in_seconds #=> Integer
resp.value_elicitation_setting.wait_and_continue_specification.still_waiting_response.allow_interrupt #=> Boolean
resp.value_elicitation_setting.wait_and_continue_specification.active #=> Boolean
resp.obfuscation_setting.obfuscation_setting_type #=> String, one of "None", "DefaultObfuscation"
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.intent_id #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time
resp.multiple_values_setting.allow_multiple_values #=> Boolean

Parameters:

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

    ({})

Options Hash (params):

  • :slot_id (required, String)

    The unique identifier for the slot.

  • :bot_id (required, String)

    The identifier of the bot associated with the slot.

  • :bot_version (required, String)

    The version of the bot associated with the slot.

  • :locale_id (required, String)

    The identifier of the language and locale of the slot to describe. The string must match one of the supported locales. For more information, see Supported languages.

  • :intent_id (required, String)

    The identifier of the intent that contains the slot.

Returns:

See Also:



3772
3773
3774
3775
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3772

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

#describe_slot_type(params = {}) ⇒ Types::DescribeSlotTypeResponse

Gets metadata information about a slot type.

Examples:

Request syntax with placeholder values


resp = client.describe_slot_type({
  slot_type_id: "Id", # required
  bot_id: "Id", # required
  bot_version: "BotVersion", # required
  locale_id: "LocaleId", # required
})

Response structure


resp.slot_type_id #=> String
resp.slot_type_name #=> String
resp.description #=> String
resp.slot_type_values #=> Array
resp.slot_type_values[0].sample_value.value #=> String
resp.slot_type_values[0].synonyms #=> Array
resp.slot_type_values[0].synonyms[0].value #=> String
resp.value_selection_setting.resolution_strategy #=> String, one of "OriginalValue", "TopResolution"
resp.value_selection_setting.regex_filter.pattern #=> String
resp.parent_slot_type_signature #=> String
resp.bot_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.creation_date_time #=> Time
resp.last_updated_date_time #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :slot_type_id (required, String)

    The identifier of the slot type.

  • :bot_id (required, String)

    The identifier of the bot associated with the slot type.

  • :bot_version (required, String)

    The version of the bot associated with the slot type.

  • :locale_id (required, String)

    The identifier of the language and locale of the slot type to describe. The string must match one of the supported locales. For more information, see Supported languages.

Returns:

See Also:



3842
3843
3844
3845
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3842

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

#list_aggregated_utterances(params = {}) ⇒ Types::ListAggregatedUtterancesResponse

Provides a list of utterances that users have sent to the bot.

Utterances are aggregated by the text of the utterance. For example, all instances where customers used the phrase "I want to order pizza" are aggregated into the same line in the response.

You can see both detected utterances and missed utterances. A detected utterance is where the bot properly recognized the utterance and activated the associated intent. A missed utterance was not recognized by the bot and didn't activate an intent.

Utterances can be aggregated for a bot alias or for a bot version, but not both at the same time.

Utterances statistics are not generated under the following conditions:

  • The childDirected field was set to true when the bot was created.

  • You are using slot obfuscation with one or more slots.

  • You opted out of participating in improving Amazon Lex.

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_aggregated_utterances({
  bot_id: "Id", # required
  bot_alias_id: "BotAliasId",
  bot_version: "BotVersion",
  locale_id: "LocaleId", # required
  aggregation_duration: { # required
    relative_aggregation_duration: { # required
      time_dimension: "Hours", # required, accepts Hours, Days, Weeks
      time_value: 1, # required
    },
  },
  sort_by: {
    attribute: "HitCount", # required, accepts HitCount, MissedCount
    order: "Ascending", # required, accepts Ascending, Descending
  },
  filters: [
    {
      name: "Utterance", # required, accepts Utterance
      values: ["FilterValue"], # required
      operator: "CO", # required, accepts CO, EQ
    },
  ],
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.bot_id #=> String
resp.bot_alias_id #=> String
resp.bot_version #=> String
resp.locale_id #=> String
resp.aggregation_duration.relative_aggregation_duration.time_dimension #=> String, one of "Hours", "Days", "Weeks"
resp.aggregation_duration.relative_aggregation_duration.time_value #=> Integer
resp.aggregation_window_start_time #=> Time
resp.aggregation_window_end_time #=> Time
resp.aggregation_last_refreshed_date_time #=> Time
resp.aggregated_utterances_summaries #=> Array
resp.aggregated_utterances_summaries[0].utterance #=> String
resp.aggregated_utterances_summaries[0].hit_count #=> Integer
resp.aggregated_utterances_summaries[0].missed_count #=> Integer
resp.aggregated_utterances_summaries[0].utterance_first_recorded_in_aggregation_duration #=> Time
resp.aggregated_utterances_summaries[0].utterance_last_recorded_in_aggregation_duration #=> Time
resp.aggregated_utterances_summaries[0].contains_data_from_deleted_resources #=> Boolean
resp.next_token #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The unique identifier of the bot associated with this request.

  • :bot_alias_id (String)

    The identifier of the bot alias associated with this request. If you specify the bot alias, you can't specify the bot version.

  • :bot_version (String)

    The identifier of the bot version associated with this request. If you specify the bot version, you can't specify the bot alias.

  • :locale_id (required, String)

    The identifier of the language and locale where the utterances were collected. For more information, see Supported languages.

  • :aggregation_duration (required, Types::UtteranceAggregationDuration)

    The time window for aggregating the utterance information. You can specify a time between one hour and two weeks.

  • :sort_by (Types::AggregatedUtterancesSortBy)

    Specifies sorting parameters for the list of utterances. You can sort by the hit count, the missed count, or the number of distinct sessions the utterance appeared in.

  • :filters (Array<Types::AggregatedUtterancesFilter>)

    Provides the specification of a filter used to limit the utterances in the response to only those that match the filter specification. You can only specify one filter and one string to filter on.

  • :max_results (Integer)

    The maximum number of utterances to return in each page of results. If there are fewer results than the maximum page size, only the actual number of results are returned. If you don't specify the maxResults parameter, 1,000 results are returned.

  • :next_token (String)

    If the response from the ListAggregatedUtterances operation contains more results that specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.

Returns:

See Also:



3982
3983
3984
3985
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 3982

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

#list_bot_aliases(params = {}) ⇒ Types::ListBotAliasesResponse

Gets a list of aliases for the specified bot.

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_bot_aliases({
  bot_id: "Id", # required
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.bot_alias_summaries #=> Array
resp.bot_alias_summaries[0].bot_alias_id #=> String
resp.bot_alias_summaries[0].bot_alias_name #=> String
resp.bot_alias_summaries[0].description #=> String
resp.bot_alias_summaries[0].bot_version #=> String
resp.bot_alias_summaries[0].bot_alias_status #=> String, one of "Creating", "Available", "Deleting", "Failed"
resp.bot_alias_summaries[0].creation_date_time #=> Time
resp.bot_alias_summaries[0].last_updated_date_time #=> Time
resp.next_token #=> String
resp.bot_id #=> String

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to list aliases for.

  • :max_results (Integer)

    The maximum number of aliases to return in each page of results. If there are fewer results than the max page size, only the actual number of results are returned.

  • :next_token (String)

    If the response from the ListBotAliases operation contains more results than specified in the maxResults parameter, a token is returned in the response. Use that token in the nextToken parameter to return the next page of results.

Returns:

See Also:



4036
4037
4038
4039
# File 'gems/aws-sdk-lexmodelsv2/lib/aws-sdk-lexmodelsv2/client.rb', line 4036

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

#list_bot_locales(params = {}) ⇒ Types::ListBotLocalesResponse

Gets a list of locales for the specified bot.

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_bot_locales({
  bot_id: "Id", # required
  bot_version: "BotVersion", # required
  sort_by: {
    attribute: "BotLocaleName", # required, accepts BotLocaleName
    order: "Ascending", # required, accepts Ascending, Descending
  },
  filters: [
    {
      name: "BotLocaleName", # required, accepts BotLocaleName
      values: ["FilterValue"], # required
      operator: "CO", # required, accepts CO, EQ
    },
  ],
  max_results: 1,
  next_token: "NextToken",
})

Response structure


resp.bot_id #=> String
resp.bot_version #=> String
resp.next_token #=> String
resp.bot_locale_summaries #=> Array
resp.bot_locale_summaries[0].locale_id #=> String
resp.bot_locale_summaries[0].locale_name #=> String
resp.bot_locale_summaries[0].description #=> String
resp.bot_locale_summaries[0].bot_locale_status #=> String, one of "Creating", "Building", "Built", "ReadyExpressTesting", "Failed", "Deleting", "NotBuilt", "Importing"
resp.bot_locale_summaries[0].last_updated_date_time #=> Time
resp.bot_locale_summaries[0]. #=> Time

Parameters:

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

    ({})

Options Hash (params):

  • :bot_id (required, String)

    The identifier of the bot to list locales for.

  • :bot_version (required, String)

    The version of the bot to list locales for.

  • :sort_by (Types::BotLocaleSortBy)

    Specifies sorting parameters for the list of locales. You can sort by locale name in ascending or descending order.

  • :filters (Array<Types::BotLocaleFilter>)

    Provides the specification for a filter used to limit the response to only those locales that match the filter specification. You can only specify one filter and one value to filter on.

  • :max_results (Integer)