aws.lex.Bot
Explore with Pulumi AI
Provides an Amazon Lex Bot resource. For more information see Amazon Lex: How It Works
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const orderFlowersBot = new aws.lex.Bot("order_flowers_bot", {
abortStatement: {
messages: [{
content: "Sorry, I am not able to assist at this time",
contentType: "PlainText",
}],
},
childDirected: false,
clarificationPrompt: {
maxAttempts: 2,
messages: [{
content: "I didn't understand you, what would you like to do?",
contentType: "PlainText",
}],
},
createVersion: false,
description: "Bot to order flowers on the behalf of a user",
idleSessionTtlInSeconds: 600,
intents: [{
intentName: "OrderFlowers",
intentVersion: "1",
}],
locale: "en-US",
name: "OrderFlowers",
processBehavior: "BUILD",
voiceId: "Salli",
});
import pulumi
import pulumi_aws as aws
order_flowers_bot = aws.lex.Bot("order_flowers_bot",
abort_statement={
"messages": [{
"content": "Sorry, I am not able to assist at this time",
"content_type": "PlainText",
}],
},
child_directed=False,
clarification_prompt={
"max_attempts": 2,
"messages": [{
"content": "I didn't understand you, what would you like to do?",
"content_type": "PlainText",
}],
},
create_version=False,
description="Bot to order flowers on the behalf of a user",
idle_session_ttl_in_seconds=600,
intents=[{
"intent_name": "OrderFlowers",
"intent_version": "1",
}],
locale="en-US",
name="OrderFlowers",
process_behavior="BUILD",
voice_id="Salli")
package main
import (
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/lex"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := lex.NewBot(ctx, "order_flowers_bot", &lex.BotArgs{
AbortStatement: &lex.BotAbortStatementArgs{
Messages: lex.BotAbortStatementMessageArray{
&lex.BotAbortStatementMessageArgs{
Content: pulumi.String("Sorry, I am not able to assist at this time"),
ContentType: pulumi.String("PlainText"),
},
},
},
ChildDirected: pulumi.Bool(false),
ClarificationPrompt: &lex.BotClarificationPromptArgs{
MaxAttempts: pulumi.Int(2),
Messages: lex.BotClarificationPromptMessageArray{
&lex.BotClarificationPromptMessageArgs{
Content: pulumi.String("I didn't understand you, what would you like to do?"),
ContentType: pulumi.String("PlainText"),
},
},
},
CreateVersion: pulumi.Bool(false),
Description: pulumi.String("Bot to order flowers on the behalf of a user"),
IdleSessionTtlInSeconds: pulumi.Int(600),
Intents: lex.BotIntentArray{
&lex.BotIntentArgs{
IntentName: pulumi.String("OrderFlowers"),
IntentVersion: pulumi.String("1"),
},
},
Locale: pulumi.String("en-US"),
Name: pulumi.String("OrderFlowers"),
ProcessBehavior: pulumi.String("BUILD"),
VoiceId: pulumi.String("Salli"),
})
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;
return await Deployment.RunAsync(() =>
{
var orderFlowersBot = new Aws.Lex.Bot("order_flowers_bot", new()
{
AbortStatement = new Aws.Lex.Inputs.BotAbortStatementArgs
{
Messages = new[]
{
new Aws.Lex.Inputs.BotAbortStatementMessageArgs
{
Content = "Sorry, I am not able to assist at this time",
ContentType = "PlainText",
},
},
},
ChildDirected = false,
ClarificationPrompt = new Aws.Lex.Inputs.BotClarificationPromptArgs
{
MaxAttempts = 2,
Messages = new[]
{
new Aws.Lex.Inputs.BotClarificationPromptMessageArgs
{
Content = "I didn't understand you, what would you like to do?",
ContentType = "PlainText",
},
},
},
CreateVersion = false,
Description = "Bot to order flowers on the behalf of a user",
IdleSessionTtlInSeconds = 600,
Intents = new[]
{
new Aws.Lex.Inputs.BotIntentArgs
{
IntentName = "OrderFlowers",
IntentVersion = "1",
},
},
Locale = "en-US",
Name = "OrderFlowers",
ProcessBehavior = "BUILD",
VoiceId = "Salli",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.lex.Bot;
import com.pulumi.aws.lex.BotArgs;
import com.pulumi.aws.lex.inputs.BotAbortStatementArgs;
import com.pulumi.aws.lex.inputs.BotClarificationPromptArgs;
import com.pulumi.aws.lex.inputs.BotIntentArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var orderFlowersBot = new Bot("orderFlowersBot", BotArgs.builder()
.abortStatement(BotAbortStatementArgs.builder()
.messages(BotAbortStatementMessageArgs.builder()
.content("Sorry, I am not able to assist at this time")
.contentType("PlainText")
.build())
.build())
.childDirected(false)
.clarificationPrompt(BotClarificationPromptArgs.builder()
.maxAttempts(2)
.messages(BotClarificationPromptMessageArgs.builder()
.content("I didn't understand you, what would you like to do?")
.contentType("PlainText")
.build())
.build())
.createVersion(false)
.description("Bot to order flowers on the behalf of a user")
.idleSessionTtlInSeconds(600)
.intents(BotIntentArgs.builder()
.intentName("OrderFlowers")
.intentVersion("1")
.build())
.locale("en-US")
.name("OrderFlowers")
.processBehavior("BUILD")
.voiceId("Salli")
.build());
}
}
resources:
orderFlowersBot:
type: aws:lex:Bot
name: order_flowers_bot
properties:
abortStatement:
messages:
- content: Sorry, I am not able to assist at this time
contentType: PlainText
childDirected: false
clarificationPrompt:
maxAttempts: 2
messages:
- content: I didn't understand you, what would you like to do?
contentType: PlainText
createVersion: false
description: Bot to order flowers on the behalf of a user
idleSessionTtlInSeconds: 600
intents:
- intentName: OrderFlowers
intentVersion: '1'
locale: en-US
name: OrderFlowers
processBehavior: BUILD
voiceId: Salli
Create Bot Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Bot(name: string, args: BotArgs, opts?: CustomResourceOptions);
@overload
def Bot(resource_name: str,
args: BotArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Bot(resource_name: str,
opts: Optional[ResourceOptions] = None,
abort_statement: Optional[BotAbortStatementArgs] = None,
child_directed: Optional[bool] = None,
intents: Optional[Sequence[BotIntentArgs]] = None,
enable_model_improvements: Optional[bool] = None,
description: Optional[str] = None,
detect_sentiment: Optional[bool] = None,
create_version: Optional[bool] = None,
idle_session_ttl_in_seconds: Optional[int] = None,
clarification_prompt: Optional[BotClarificationPromptArgs] = None,
locale: Optional[str] = None,
name: Optional[str] = None,
nlu_intent_confidence_threshold: Optional[float] = None,
process_behavior: Optional[str] = None,
voice_id: Optional[str] = None)
func NewBot(ctx *Context, name string, args BotArgs, opts ...ResourceOption) (*Bot, error)
public Bot(string name, BotArgs args, CustomResourceOptions? opts = null)
type: aws:lex:Bot
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args BotArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args BotArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args BotArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args BotArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args BotArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Constructor example
The following reference example uses placeholder values for all input properties.
var botResource = new Aws.Lex.Bot("botResource", new()
{
AbortStatement = new Aws.Lex.Inputs.BotAbortStatementArgs
{
Messages = new[]
{
new Aws.Lex.Inputs.BotAbortStatementMessageArgs
{
Content = "string",
ContentType = "string",
GroupNumber = 0,
},
},
ResponseCard = "string",
},
ChildDirected = false,
Intents = new[]
{
new Aws.Lex.Inputs.BotIntentArgs
{
IntentName = "string",
IntentVersion = "string",
},
},
EnableModelImprovements = false,
Description = "string",
DetectSentiment = false,
CreateVersion = false,
IdleSessionTtlInSeconds = 0,
ClarificationPrompt = new Aws.Lex.Inputs.BotClarificationPromptArgs
{
MaxAttempts = 0,
Messages = new[]
{
new Aws.Lex.Inputs.BotClarificationPromptMessageArgs
{
Content = "string",
ContentType = "string",
GroupNumber = 0,
},
},
ResponseCard = "string",
},
Locale = "string",
Name = "string",
NluIntentConfidenceThreshold = 0,
ProcessBehavior = "string",
VoiceId = "string",
});
example, err := lex.NewBot(ctx, "botResource", &lex.BotArgs{
AbortStatement: &lex.BotAbortStatementArgs{
Messages: lex.BotAbortStatementMessageArray{
&lex.BotAbortStatementMessageArgs{
Content: pulumi.String("string"),
ContentType: pulumi.String("string"),
GroupNumber: pulumi.Int(0),
},
},
ResponseCard: pulumi.String("string"),
},
ChildDirected: pulumi.Bool(false),
Intents: lex.BotIntentArray{
&lex.BotIntentArgs{
IntentName: pulumi.String("string"),
IntentVersion: pulumi.String("string"),
},
},
EnableModelImprovements: pulumi.Bool(false),
Description: pulumi.String("string"),
DetectSentiment: pulumi.Bool(false),
CreateVersion: pulumi.Bool(false),
IdleSessionTtlInSeconds: pulumi.Int(0),
ClarificationPrompt: &lex.BotClarificationPromptArgs{
MaxAttempts: pulumi.Int(0),
Messages: lex.BotClarificationPromptMessageArray{
&lex.BotClarificationPromptMessageArgs{
Content: pulumi.String("string"),
ContentType: pulumi.String("string"),
GroupNumber: pulumi.Int(0),
},
},
ResponseCard: pulumi.String("string"),
},
Locale: pulumi.String("string"),
Name: pulumi.String("string"),
NluIntentConfidenceThreshold: pulumi.Float64(0),
ProcessBehavior: pulumi.String("string"),
VoiceId: pulumi.String("string"),
})
var botResource = new Bot("botResource", BotArgs.builder()
.abortStatement(BotAbortStatementArgs.builder()
.messages(BotAbortStatementMessageArgs.builder()
.content("string")
.contentType("string")
.groupNumber(0)
.build())
.responseCard("string")
.build())
.childDirected(false)
.intents(BotIntentArgs.builder()
.intentName("string")
.intentVersion("string")
.build())
.enableModelImprovements(false)
.description("string")
.detectSentiment(false)
.createVersion(false)
.idleSessionTtlInSeconds(0)
.clarificationPrompt(BotClarificationPromptArgs.builder()
.maxAttempts(0)
.messages(BotClarificationPromptMessageArgs.builder()
.content("string")
.contentType("string")
.groupNumber(0)
.build())
.responseCard("string")
.build())
.locale("string")
.name("string")
.nluIntentConfidenceThreshold(0)
.processBehavior("string")
.voiceId("string")
.build());
bot_resource = aws.lex.Bot("botResource",
abort_statement={
"messages": [{
"content": "string",
"content_type": "string",
"group_number": 0,
}],
"response_card": "string",
},
child_directed=False,
intents=[{
"intent_name": "string",
"intent_version": "string",
}],
enable_model_improvements=False,
description="string",
detect_sentiment=False,
create_version=False,
idle_session_ttl_in_seconds=0,
clarification_prompt={
"max_attempts": 0,
"messages": [{
"content": "string",
"content_type": "string",
"group_number": 0,
}],
"response_card": "string",
},
locale="string",
name="string",
nlu_intent_confidence_threshold=0,
process_behavior="string",
voice_id="string")
const botResource = new aws.lex.Bot("botResource", {
abortStatement: {
messages: [{
content: "string",
contentType: "string",
groupNumber: 0,
}],
responseCard: "string",
},
childDirected: false,
intents: [{
intentName: "string",
intentVersion: "string",
}],
enableModelImprovements: false,
description: "string",
detectSentiment: false,
createVersion: false,
idleSessionTtlInSeconds: 0,
clarificationPrompt: {
maxAttempts: 0,
messages: [{
content: "string",
contentType: "string",
groupNumber: 0,
}],
responseCard: "string",
},
locale: "string",
name: "string",
nluIntentConfidenceThreshold: 0,
processBehavior: "string",
voiceId: "string",
});
type: aws:lex:Bot
properties:
abortStatement:
messages:
- content: string
contentType: string
groupNumber: 0
responseCard: string
childDirected: false
clarificationPrompt:
maxAttempts: 0
messages:
- content: string
contentType: string
groupNumber: 0
responseCard: string
createVersion: false
description: string
detectSentiment: false
enableModelImprovements: false
idleSessionTtlInSeconds: 0
intents:
- intentName: string
intentVersion: string
locale: string
name: string
nluIntentConfidenceThreshold: 0
processBehavior: string
voiceId: string
Bot Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Bot resource accepts the following input properties:
- Abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- Child
Directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- Intents
List<Bot
Intent> - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- Clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- Create
Version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - Description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- Detect
Sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - Enable
Model boolImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - Idle
Session intTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - Locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - Name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- Nlu
Intent doubleConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - Process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - Voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- Abort
Statement BotAbort Statement Args - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- Child
Directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- Intents
[]Bot
Intent Args - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- Clarification
Prompt BotClarification Prompt Args - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- Create
Version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - Description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- Detect
Sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - Enable
Model boolImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - Idle
Session intTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - Locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - Name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- Nlu
Intent float64Confidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - Process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - Voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- child
Directed Boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- intents
List<Bot
Intent> - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version Boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - description String
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment Boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model BooleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - idle
Session IntegerTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - locale String
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name String
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent DoubleConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior String - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - voice
Id String - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- child
Directed boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- intents
Bot
Intent[] - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model booleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - idle
Session numberTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent numberConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort_
statement BotAbort Statement Args - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- child_
directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- intents
Sequence[Bot
Intent Args] - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- clarification_
prompt BotClarification Prompt Args - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create_
version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - description str
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect_
sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable_
model_ boolimprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - idle_
session_ intttl_ in_ seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - locale str
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name str
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu_
intent_ floatconfidence_ threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process_
behavior str - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - voice_
id str - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement Property Map - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- child
Directed Boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- intents List<Property Map>
- A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- clarification
Prompt Property Map - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version Boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - description String
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment Boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model BooleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - idle
Session NumberTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - locale String
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name String
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent NumberConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior String - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - voice
Id String - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
Outputs
All input properties are implicitly available as output properties. Additionally, the Bot resource produces the following output properties:
- Arn string
- Checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- Created
Date string - The date when the bot version was created.
- Failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- Status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- Version string
- The version of the bot.
- Arn string
- Checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- Created
Date string - The date when the bot version was created.
- Failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- Id string
- The provider-assigned unique ID for this managed resource.
- Last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- Status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- Version string
- The version of the bot.
- arn String
- checksum String
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- created
Date String - The date when the bot version was created.
- failure
Reason String - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Updated StringDate - The date when the $LATEST version of this bot was updated.
- status String
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version String
- The version of the bot.
- arn string
- checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- created
Date string - The date when the bot version was created.
- failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- id string
- The provider-assigned unique ID for this managed resource.
- last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version string
- The version of the bot.
- arn str
- checksum str
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- created_
date str - The date when the bot version was created.
- failure_
reason str - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- id str
- The provider-assigned unique ID for this managed resource.
- last_
updated_ strdate - The date when the $LATEST version of this bot was updated.
- status str
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version str
- The version of the bot.
- arn String
- checksum String
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- created
Date String - The date when the bot version was created.
- failure
Reason String - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- id String
- The provider-assigned unique ID for this managed resource.
- last
Updated StringDate - The date when the $LATEST version of this bot was updated.
- status String
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version String
- The version of the bot.
Look up Existing Bot Resource
Get an existing Bot resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.
public static get(name: string, id: Input<ID>, state?: BotState, opts?: CustomResourceOptions): Bot
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
abort_statement: Optional[BotAbortStatementArgs] = None,
arn: Optional[str] = None,
checksum: Optional[str] = None,
child_directed: Optional[bool] = None,
clarification_prompt: Optional[BotClarificationPromptArgs] = None,
create_version: Optional[bool] = None,
created_date: Optional[str] = None,
description: Optional[str] = None,
detect_sentiment: Optional[bool] = None,
enable_model_improvements: Optional[bool] = None,
failure_reason: Optional[str] = None,
idle_session_ttl_in_seconds: Optional[int] = None,
intents: Optional[Sequence[BotIntentArgs]] = None,
last_updated_date: Optional[str] = None,
locale: Optional[str] = None,
name: Optional[str] = None,
nlu_intent_confidence_threshold: Optional[float] = None,
process_behavior: Optional[str] = None,
status: Optional[str] = None,
version: Optional[str] = None,
voice_id: Optional[str] = None) -> Bot
func GetBot(ctx *Context, name string, id IDInput, state *BotState, opts ...ResourceOption) (*Bot, error)
public static Bot Get(string name, Input<string> id, BotState? state, CustomResourceOptions? opts = null)
public static Bot get(String name, Output<String> id, BotState state, CustomResourceOptions options)
Resource lookup is not supported in YAML
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- resource_name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- name
- The unique name of the resulting resource.
- id
- The unique provider ID of the resource to lookup.
- state
- Any extra arguments used during the lookup.
- opts
- A bag of options that control this resource's behavior.
- Abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- Arn string
- Checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- Child
Directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- Clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- Create
Version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - Created
Date string - The date when the bot version was created.
- Description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- Detect
Sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - Enable
Model boolImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - Failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- Idle
Session intTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - Intents
List<Bot
Intent> - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- Last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- Locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - Name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- Nlu
Intent doubleConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - Process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - Status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- Version string
- The version of the bot.
- Voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- Abort
Statement BotAbort Statement Args - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- Arn string
- Checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- Child
Directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- Clarification
Prompt BotClarification Prompt Args - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- Create
Version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - Created
Date string - The date when the bot version was created.
- Description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- Detect
Sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - Enable
Model boolImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - Failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- Idle
Session intTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - Intents
[]Bot
Intent Args - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- Last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- Locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - Name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- Nlu
Intent float64Confidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - Process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - Status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- Version string
- The version of the bot.
- Voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- arn String
- checksum String
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- child
Directed Boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version Boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - created
Date String - The date when the bot version was created.
- description String
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment Boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model BooleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - failure
Reason String - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- idle
Session IntegerTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - intents
List<Bot
Intent> - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- last
Updated StringDate - The date when the $LATEST version of this bot was updated.
- locale String
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name String
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent DoubleConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior String - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - status String
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version String
- The version of the bot.
- voice
Id String - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement BotAbort Statement - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- arn string
- checksum string
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- child
Directed boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- clarification
Prompt BotClarification Prompt - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - created
Date string - The date when the bot version was created.
- description string
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model booleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - failure
Reason string - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- idle
Session numberTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - intents
Bot
Intent[] - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- last
Updated stringDate - The date when the $LATEST version of this bot was updated.
- locale string
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name string
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent numberConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior string - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - status string
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version string
- The version of the bot.
- voice
Id string - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort_
statement BotAbort Statement Args - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- arn str
- checksum str
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- child_
directed bool - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- clarification_
prompt BotClarification Prompt Args - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create_
version bool - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - created_
date str - The date when the bot version was created.
- description str
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect_
sentiment bool - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable_
model_ boolimprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - failure_
reason str - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- idle_
session_ intttl_ in_ seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - intents
Sequence[Bot
Intent Args] - A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- last_
updated_ strdate - The date when the $LATEST version of this bot was updated.
- locale str
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name str
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu_
intent_ floatconfidence_ threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process_
behavior str - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - status str
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version str
- The version of the bot.
- voice_
id str - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
- abort
Statement Property Map - The message that Amazon Lex uses to abort a conversation. Attributes are documented under statement.
- arn String
- checksum String
- Checksum identifying the version of the bot that was created. The checksum is not included as an argument because the resource will add it automatically when updating the bot.
- child
Directed Boolean - By specifying true, you confirm that your use of Amazon Lex is related to a website, program, or other application that is directed or targeted, in whole or in part, to children under age 13 and subject to COPPA. For more information see the Amazon Lex FAQ and the Amazon Lex PutBot API Docs.
- clarification
Prompt Property Map - The message that Amazon Lex uses when it doesn't understand the user's request. Attributes are documented under prompt.
- create
Version Boolean - Determines if a new bot version is created when the initial resource is created and on each update. Defaults to
false
. - created
Date String - The date when the bot version was created.
- description String
- A description of the bot. Must be less than or equal to 200 characters in length.
- detect
Sentiment Boolean - When set to true user utterances are sent to Amazon Comprehend for sentiment analysis. If you don't specify detectSentiment, the default is
false
. - enable
Model BooleanImprovements - Set to
true
to enable access to natural language understanding improvements. When you set theenable_model_improvements
parameter to true you can use thenlu_intent_confidence_threshold
parameter to configure confidence scores. For more information, see Confidence Scores. You can only set theenable_model_improvements
parameter in certain Regions. If you set the parameter to true, your bot has access to accuracy improvements. For more information see the Amazon Lex Bot PutBot API Docs. - failure
Reason String - If status is FAILED, Amazon Lex provides the reason that it failed to build the bot.
- idle
Session NumberTtl In Seconds - The maximum time in seconds that Amazon Lex retains the data gathered in a conversation. Default is
300
. Must be a number between 60 and 86400 (inclusive). - intents List<Property Map>
- A set of Intent objects. Each intent represents a command that a user can express. Attributes are documented under intent. Can have up to 250 Intent objects.
- last
Updated StringDate - The date when the $LATEST version of this bot was updated.
- locale String
- Specifies the target locale for the bot. Any intent used in the bot must be compatible with the locale of the bot. For available locales, see Amazon Lex Bot PutBot API Docs. Default is
en-US
. - name String
- The name of the bot that you want to create, case sensitive. Must be between 2 and 50 characters in length.
- nlu
Intent NumberConfidence Threshold - Determines the threshold where Amazon Lex will insert the AMAZON.FallbackIntent, AMAZON.KendraSearchIntent, or both when returning alternative intents in a PostContent or PostText response. AMAZON.FallbackIntent and AMAZON.KendraSearchIntent are only inserted if they are configured for the bot. For more information see Amazon Lex Bot PutBot API Docs This value requires
enable_model_improvements
to be set totrue
and the default is0
. Must be a float between 0 and 1. - process
Behavior String - If you set the
process_behavior
element toBUILD
, Amazon Lex builds the bot so that it can be run. If you set the element toSAVE
Amazon Lex saves the bot, but doesn't build it. Default isSAVE
. - status String
- When you send a request to create or update a bot, Amazon Lex sets the status response element to BUILDING. After Amazon Lex builds the bot, it sets status to READY. If Amazon Lex can't build the bot, it sets status to FAILED. Amazon Lex returns the reason for the failure in the failure_reason response element.
- version String
- The version of the bot.
- voice
Id String - The Amazon Polly voice ID that you want Amazon Lex to use for voice interactions with the user. The locale configured for the voice must match the locale of the bot. For more information, see Available Voices in the Amazon Polly Developer Guide.
Supporting Types
BotAbortStatement, BotAbortStatementArgs
BotAbortStatementMessage, BotAbortStatementMessageArgs
- Content string
- The text of the message.
- Content
Type string - The content type of the message string.
- Group
Number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- Content string
- The text of the message.
- Content
Type string - The content type of the message string.
- Group
Number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content String
- The text of the message.
- content
Type String - The content type of the message string.
- group
Number Integer - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content string
- The text of the message.
- content
Type string - The content type of the message string.
- group
Number number - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content str
- The text of the message.
- content_
type str - The content type of the message string.
- group_
number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content String
- The text of the message.
- content
Type String - The content type of the message string.
- group
Number Number - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
BotClarificationPrompt, BotClarificationPromptArgs
- Max
Attempts int - The number of times to prompt the user for information.
- Messages
List<Bot
Clarification Prompt Message> - Response
Card string
- Max
Attempts int - The number of times to prompt the user for information.
- Messages
[]Bot
Clarification Prompt Message - Response
Card string
- max
Attempts Integer - The number of times to prompt the user for information.
- messages
List<Bot
Clarification Prompt Message> - response
Card String
- max
Attempts number - The number of times to prompt the user for information.
- messages
Bot
Clarification Prompt Message[] - response
Card string
- max_
attempts int - The number of times to prompt the user for information.
- messages
Sequence[Bot
Clarification Prompt Message] - response_
card str
- max
Attempts Number - The number of times to prompt the user for information.
- messages List<Property Map>
- response
Card String
BotClarificationPromptMessage, BotClarificationPromptMessageArgs
- Content string
- The text of the message.
- Content
Type string - The content type of the message string.
- Group
Number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- Content string
- The text of the message.
- Content
Type string - The content type of the message string.
- Group
Number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content String
- The text of the message.
- content
Type String - The content type of the message string.
- group
Number Integer - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content string
- The text of the message.
- content
Type string - The content type of the message string.
- group
Number number - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content str
- The text of the message.
- content_
type str - The content type of the message string.
- group_
number int - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
- content String
- The text of the message.
- content
Type String - The content type of the message string.
- group
Number Number - Identifies the message group that the message belongs to. When a group is assigned to a message, Amazon Lex returns one message from each group in the response.
BotIntent, BotIntentArgs
- Intent
Name string - The name of the intent. Must be less than or equal to 100 characters in length.
- Intent
Version string - The version of the intent. Must be less than or equal to 64 characters in length.
- Intent
Name string - The name of the intent. Must be less than or equal to 100 characters in length.
- Intent
Version string - The version of the intent. Must be less than or equal to 64 characters in length.
- intent
Name String - The name of the intent. Must be less than or equal to 100 characters in length.
- intent
Version String - The version of the intent. Must be less than or equal to 64 characters in length.
- intent
Name string - The name of the intent. Must be less than or equal to 100 characters in length.
- intent
Version string - The version of the intent. Must be less than or equal to 64 characters in length.
- intent_
name str - The name of the intent. Must be less than or equal to 100 characters in length.
- intent_
version str - The version of the intent. Must be less than or equal to 64 characters in length.
- intent
Name String - The name of the intent. Must be less than or equal to 100 characters in length.
- intent
Version String - The version of the intent. Must be less than or equal to 64 characters in length.
Import
Using pulumi import
, import bots using their name. For example:
$ pulumi import aws:lex/bot:Bot order_flowers_bot OrderFlowers
To learn more about importing existing cloud resources, see Importing resources.
Package Details
- Repository
- AWS Classic pulumi/pulumi-aws
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
aws
Terraform Provider.