Try AWS Native preview for resources not in the classic version.
aws.bedrock.AgentAgent
Explore with Pulumi AI
Try AWS Native preview for resources not in the classic version.
Resource for managing an AWS Agents for Amazon Bedrock Agent.
Example Usage
Basic Usage
import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";
const current = aws.getCallerIdentity({});
const currentGetPartition = aws.getPartition({});
const currentGetRegion = aws.getRegion({});
const exampleAgentTrust = Promise.all([current, currentGetPartition, currentGetRegion, current]).then(([current, currentGetPartition, currentGetRegion, current1]) => aws.iam.getPolicyDocument({
statements: [{
actions: ["sts:AssumeRole"],
principals: [{
identifiers: ["bedrock.amazonaws.com"],
type: "Service",
}],
conditions: [
{
test: "StringEquals",
values: [current.accountId],
variable: "aws:SourceAccount",
},
{
test: "ArnLike",
values: [`arn:${currentGetPartition.partition}:bedrock:${currentGetRegion.name}:${current1.accountId}:agent/*`],
variable: "AWS:SourceArn",
},
],
}],
}));
const exampleAgentPermissions = Promise.all([currentGetPartition, currentGetRegion]).then(([currentGetPartition, currentGetRegion]) => aws.iam.getPolicyDocument({
statements: [{
actions: ["bedrock:InvokeModel"],
resources: [`arn:${currentGetPartition.partition}:bedrock:${currentGetRegion.name}::foundation-model/anthropic.claude-v2`],
}],
}));
const example = new aws.iam.Role("example", {
assumeRolePolicy: exampleAgentTrust.then(exampleAgentTrust => exampleAgentTrust.json),
namePrefix: "AmazonBedrockExecutionRoleForAgents_",
});
const exampleRolePolicy = new aws.iam.RolePolicy("example", {
policy: exampleAgentPermissions.then(exampleAgentPermissions => exampleAgentPermissions.json),
role: example.id,
});
const exampleAgentAgent = new aws.bedrock.AgentAgent("example", {
agentName: "my-agent-name",
agentResourceRoleArn: example.arn,
idleSessionTtlInSeconds: 500,
foundationModel: "anthropic.claude-v2",
});
import pulumi
import pulumi_aws as aws
current = aws.get_caller_identity()
current_get_partition = aws.get_partition()
current_get_region = aws.get_region()
example_agent_trust = aws.iam.get_policy_document(statements=[{
"actions": ["sts:AssumeRole"],
"principals": [{
"identifiers": ["bedrock.amazonaws.com"],
"type": "Service",
}],
"conditions": [
{
"test": "StringEquals",
"values": [current.account_id],
"variable": "aws:SourceAccount",
},
{
"test": "ArnLike",
"values": [f"arn:{current_get_partition.partition}:bedrock:{current_get_region.name}:{current.account_id}:agent/*"],
"variable": "AWS:SourceArn",
},
],
}])
example_agent_permissions = aws.iam.get_policy_document(statements=[{
"actions": ["bedrock:InvokeModel"],
"resources": [f"arn:{current_get_partition.partition}:bedrock:{current_get_region.name}::foundation-model/anthropic.claude-v2"],
}])
example = aws.iam.Role("example",
assume_role_policy=example_agent_trust.json,
name_prefix="AmazonBedrockExecutionRoleForAgents_")
example_role_policy = aws.iam.RolePolicy("example",
policy=example_agent_permissions.json,
role=example.id)
example_agent_agent = aws.bedrock.AgentAgent("example",
agent_name="my-agent-name",
agent_resource_role_arn=example.arn,
idle_session_ttl_in_seconds=500,
foundation_model="anthropic.claude-v2")
package main
import (
"fmt"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/bedrock"
"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/iam"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
current, err := aws.GetCallerIdentity(ctx, nil, nil);
if err != nil {
return err
}
currentGetPartition, err := aws.GetPartition(ctx, nil, nil);
if err != nil {
return err
}
currentGetRegion, err := aws.GetRegion(ctx, nil, nil);
if err != nil {
return err
}
exampleAgentTrust, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{
Statements: []iam.GetPolicyDocumentStatement{
{
Actions: []string{
"sts:AssumeRole",
},
Principals: []iam.GetPolicyDocumentStatementPrincipal{
{
Identifiers: []string{
"bedrock.amazonaws.com",
},
Type: "Service",
},
},
Conditions: []iam.GetPolicyDocumentStatementCondition{
{
Test: "StringEquals",
Values: interface{}{
current.AccountId,
},
Variable: "aws:SourceAccount",
},
{
Test: "ArnLike",
Values: []string{
fmt.Sprintf("arn:%v:bedrock:%v:%v:agent/*", currentGetPartition.Partition, currentGetRegion.Name, current.AccountId),
},
Variable: "AWS:SourceArn",
},
},
},
},
}, nil);
if err != nil {
return err
}
exampleAgentPermissions, err := iam.GetPolicyDocument(ctx, &iam.GetPolicyDocumentArgs{
Statements: []iam.GetPolicyDocumentStatement{
{
Actions: []string{
"bedrock:InvokeModel",
},
Resources: []string{
fmt.Sprintf("arn:%v:bedrock:%v::foundation-model/anthropic.claude-v2", currentGetPartition.Partition, currentGetRegion.Name),
},
},
},
}, nil);
if err != nil {
return err
}
example, err := iam.NewRole(ctx, "example", &iam.RoleArgs{
AssumeRolePolicy: pulumi.String(exampleAgentTrust.Json),
NamePrefix: pulumi.String("AmazonBedrockExecutionRoleForAgents_"),
})
if err != nil {
return err
}
_, err = iam.NewRolePolicy(ctx, "example", &iam.RolePolicyArgs{
Policy: pulumi.String(exampleAgentPermissions.Json),
Role: example.ID(),
})
if err != nil {
return err
}
_, err = bedrock.NewAgentAgent(ctx, "example", &bedrock.AgentAgentArgs{
AgentName: pulumi.String("my-agent-name"),
AgentResourceRoleArn: example.Arn,
IdleSessionTtlInSeconds: pulumi.Int(500),
FoundationModel: pulumi.String("anthropic.claude-v2"),
})
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 current = Aws.GetCallerIdentity.Invoke();
var currentGetPartition = Aws.GetPartition.Invoke();
var currentGetRegion = Aws.GetRegion.Invoke();
var exampleAgentTrust = Aws.Iam.GetPolicyDocument.Invoke(new()
{
Statements = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
{
Actions = new[]
{
"sts:AssumeRole",
},
Principals = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementPrincipalInputArgs
{
Identifiers = new[]
{
"bedrock.amazonaws.com",
},
Type = "Service",
},
},
Conditions = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementConditionInputArgs
{
Test = "StringEquals",
Values = new[]
{
current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId),
},
Variable = "aws:SourceAccount",
},
new Aws.Iam.Inputs.GetPolicyDocumentStatementConditionInputArgs
{
Test = "ArnLike",
Values = new[]
{
$"arn:{currentGetPartition.Apply(getPartitionResult => getPartitionResult.Partition)}:bedrock:{currentGetRegion.Apply(getRegionResult => getRegionResult.Name)}:{current.Apply(getCallerIdentityResult => getCallerIdentityResult.AccountId)}:agent/*",
},
Variable = "AWS:SourceArn",
},
},
},
},
});
var exampleAgentPermissions = Aws.Iam.GetPolicyDocument.Invoke(new()
{
Statements = new[]
{
new Aws.Iam.Inputs.GetPolicyDocumentStatementInputArgs
{
Actions = new[]
{
"bedrock:InvokeModel",
},
Resources = new[]
{
$"arn:{currentGetPartition.Apply(getPartitionResult => getPartitionResult.Partition)}:bedrock:{currentGetRegion.Apply(getRegionResult => getRegionResult.Name)}::foundation-model/anthropic.claude-v2",
},
},
},
});
var example = new Aws.Iam.Role("example", new()
{
AssumeRolePolicy = exampleAgentTrust.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json),
NamePrefix = "AmazonBedrockExecutionRoleForAgents_",
});
var exampleRolePolicy = new Aws.Iam.RolePolicy("example", new()
{
Policy = exampleAgentPermissions.Apply(getPolicyDocumentResult => getPolicyDocumentResult.Json),
Role = example.Id,
});
var exampleAgentAgent = new Aws.Bedrock.AgentAgent("example", new()
{
AgentName = "my-agent-name",
AgentResourceRoleArn = example.Arn,
IdleSessionTtlInSeconds = 500,
FoundationModel = "anthropic.claude-v2",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.AwsFunctions;
import com.pulumi.aws.inputs.GetCallerIdentityArgs;
import com.pulumi.aws.inputs.GetPartitionArgs;
import com.pulumi.aws.inputs.GetRegionArgs;
import com.pulumi.aws.iam.IamFunctions;
import com.pulumi.aws.iam.inputs.GetPolicyDocumentArgs;
import com.pulumi.aws.iam.Role;
import com.pulumi.aws.iam.RoleArgs;
import com.pulumi.aws.iam.RolePolicy;
import com.pulumi.aws.iam.RolePolicyArgs;
import com.pulumi.aws.bedrock.AgentAgent;
import com.pulumi.aws.bedrock.AgentAgentArgs;
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) {
final var current = AwsFunctions.getCallerIdentity();
final var currentGetPartition = AwsFunctions.getPartition();
final var currentGetRegion = AwsFunctions.getRegion();
final var exampleAgentTrust = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
.statements(GetPolicyDocumentStatementArgs.builder()
.actions("sts:AssumeRole")
.principals(GetPolicyDocumentStatementPrincipalArgs.builder()
.identifiers("bedrock.amazonaws.com")
.type("Service")
.build())
.conditions(
GetPolicyDocumentStatementConditionArgs.builder()
.test("StringEquals")
.values(current.applyValue(getCallerIdentityResult -> getCallerIdentityResult.accountId()))
.variable("aws:SourceAccount")
.build(),
GetPolicyDocumentStatementConditionArgs.builder()
.test("ArnLike")
.values(String.format("arn:%s:bedrock:%s:%s:agent/*", currentGetPartition.applyValue(getPartitionResult -> getPartitionResult.partition()),currentGetRegion.applyValue(getRegionResult -> getRegionResult.name()),current.applyValue(getCallerIdentityResult -> getCallerIdentityResult.accountId())))
.variable("AWS:SourceArn")
.build())
.build())
.build());
final var exampleAgentPermissions = IamFunctions.getPolicyDocument(GetPolicyDocumentArgs.builder()
.statements(GetPolicyDocumentStatementArgs.builder()
.actions("bedrock:InvokeModel")
.resources(String.format("arn:%s:bedrock:%s::foundation-model/anthropic.claude-v2", currentGetPartition.applyValue(getPartitionResult -> getPartitionResult.partition()),currentGetRegion.applyValue(getRegionResult -> getRegionResult.name())))
.build())
.build());
var example = new Role("example", RoleArgs.builder()
.assumeRolePolicy(exampleAgentTrust.applyValue(getPolicyDocumentResult -> getPolicyDocumentResult.json()))
.namePrefix("AmazonBedrockExecutionRoleForAgents_")
.build());
var exampleRolePolicy = new RolePolicy("exampleRolePolicy", RolePolicyArgs.builder()
.policy(exampleAgentPermissions.applyValue(getPolicyDocumentResult -> getPolicyDocumentResult.json()))
.role(example.id())
.build());
var exampleAgentAgent = new AgentAgent("exampleAgentAgent", AgentAgentArgs.builder()
.agentName("my-agent-name")
.agentResourceRoleArn(example.arn())
.idleSessionTtlInSeconds(500)
.foundationModel("anthropic.claude-v2")
.build());
}
}
resources:
example:
type: aws:iam:Role
properties:
assumeRolePolicy: ${exampleAgentTrust.json}
namePrefix: AmazonBedrockExecutionRoleForAgents_
exampleRolePolicy:
type: aws:iam:RolePolicy
name: example
properties:
policy: ${exampleAgentPermissions.json}
role: ${example.id}
exampleAgentAgent:
type: aws:bedrock:AgentAgent
name: example
properties:
agentName: my-agent-name
agentResourceRoleArn: ${example.arn}
idleSessionTtlInSeconds: 500
foundationModel: anthropic.claude-v2
variables:
current:
fn::invoke:
Function: aws:getCallerIdentity
Arguments: {}
currentGetPartition:
fn::invoke:
Function: aws:getPartition
Arguments: {}
currentGetRegion:
fn::invoke:
Function: aws:getRegion
Arguments: {}
exampleAgentTrust:
fn::invoke:
Function: aws:iam:getPolicyDocument
Arguments:
statements:
- actions:
- sts:AssumeRole
principals:
- identifiers:
- bedrock.amazonaws.com
type: Service
conditions:
- test: StringEquals
values:
- ${current.accountId}
variable: aws:SourceAccount
- test: ArnLike
values:
- arn:${currentGetPartition.partition}:bedrock:${currentGetRegion.name}:${current.accountId}:agent/*
variable: AWS:SourceArn
exampleAgentPermissions:
fn::invoke:
Function: aws:iam:getPolicyDocument
Arguments:
statements:
- actions:
- bedrock:InvokeModel
resources:
- arn:${currentGetPartition.partition}:bedrock:${currentGetRegion.name}::foundation-model/anthropic.claude-v2
Create AgentAgent Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new AgentAgent(name: string, args: AgentAgentArgs, opts?: CustomResourceOptions);
@overload
def AgentAgent(resource_name: str,
args: AgentAgentArgs,
opts: Optional[ResourceOptions] = None)
@overload
def AgentAgent(resource_name: str,
opts: Optional[ResourceOptions] = None,
agent_name: Optional[str] = None,
agent_resource_role_arn: Optional[str] = None,
foundation_model: Optional[str] = None,
customer_encryption_key_arn: Optional[str] = None,
description: Optional[str] = None,
idle_session_ttl_in_seconds: Optional[int] = None,
instruction: Optional[str] = None,
prepare_agent: Optional[bool] = None,
prompt_override_configurations: Optional[Sequence[AgentAgentPromptOverrideConfigurationArgs]] = None,
tags: Optional[Mapping[str, str]] = None,
timeouts: Optional[AgentAgentTimeoutsArgs] = None)
func NewAgentAgent(ctx *Context, name string, args AgentAgentArgs, opts ...ResourceOption) (*AgentAgent, error)
public AgentAgent(string name, AgentAgentArgs args, CustomResourceOptions? opts = null)
public AgentAgent(String name, AgentAgentArgs args)
public AgentAgent(String name, AgentAgentArgs args, CustomResourceOptions options)
type: aws:bedrock:AgentAgent
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 AgentAgentArgs
- 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 AgentAgentArgs
- 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 AgentAgentArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args AgentAgentArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args AgentAgentArgs
- 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 agentAgentResource = new Aws.Bedrock.AgentAgent("agentAgentResource", new()
{
AgentName = "string",
AgentResourceRoleArn = "string",
FoundationModel = "string",
CustomerEncryptionKeyArn = "string",
Description = "string",
IdleSessionTtlInSeconds = 0,
Instruction = "string",
PrepareAgent = false,
PromptOverrideConfigurations = new[]
{
new Aws.Bedrock.Inputs.AgentAgentPromptOverrideConfigurationArgs
{
OverrideLambda = "string",
PromptConfigurations = new[]
{
"any",
},
},
},
Tags =
{
{ "string", "string" },
},
Timeouts = new Aws.Bedrock.Inputs.AgentAgentTimeoutsArgs
{
Create = "string",
Delete = "string",
Update = "string",
},
});
example, err := bedrock.NewAgentAgent(ctx, "agentAgentResource", &bedrock.AgentAgentArgs{
AgentName: pulumi.String("string"),
AgentResourceRoleArn: pulumi.String("string"),
FoundationModel: pulumi.String("string"),
CustomerEncryptionKeyArn: pulumi.String("string"),
Description: pulumi.String("string"),
IdleSessionTtlInSeconds: pulumi.Int(0),
Instruction: pulumi.String("string"),
PrepareAgent: pulumi.Bool(false),
PromptOverrideConfigurations: bedrock.AgentAgentPromptOverrideConfigurationArray{
&bedrock.AgentAgentPromptOverrideConfigurationArgs{
OverrideLambda: pulumi.String("string"),
PromptConfigurations: pulumi.Array{
pulumi.Any("any"),
},
},
},
Tags: pulumi.StringMap{
"string": pulumi.String("string"),
},
Timeouts: &bedrock.AgentAgentTimeoutsArgs{
Create: pulumi.String("string"),
Delete: pulumi.String("string"),
Update: pulumi.String("string"),
},
})
var agentAgentResource = new AgentAgent("agentAgentResource", AgentAgentArgs.builder()
.agentName("string")
.agentResourceRoleArn("string")
.foundationModel("string")
.customerEncryptionKeyArn("string")
.description("string")
.idleSessionTtlInSeconds(0)
.instruction("string")
.prepareAgent(false)
.promptOverrideConfigurations(AgentAgentPromptOverrideConfigurationArgs.builder()
.overrideLambda("string")
.promptConfigurations("any")
.build())
.tags(Map.of("string", "string"))
.timeouts(AgentAgentTimeoutsArgs.builder()
.create("string")
.delete("string")
.update("string")
.build())
.build());
agent_agent_resource = aws.bedrock.AgentAgent("agentAgentResource",
agent_name="string",
agent_resource_role_arn="string",
foundation_model="string",
customer_encryption_key_arn="string",
description="string",
idle_session_ttl_in_seconds=0,
instruction="string",
prepare_agent=False,
prompt_override_configurations=[{
"overrideLambda": "string",
"promptConfigurations": ["any"],
}],
tags={
"string": "string",
},
timeouts={
"create": "string",
"delete": "string",
"update": "string",
})
const agentAgentResource = new aws.bedrock.AgentAgent("agentAgentResource", {
agentName: "string",
agentResourceRoleArn: "string",
foundationModel: "string",
customerEncryptionKeyArn: "string",
description: "string",
idleSessionTtlInSeconds: 0,
instruction: "string",
prepareAgent: false,
promptOverrideConfigurations: [{
overrideLambda: "string",
promptConfigurations: ["any"],
}],
tags: {
string: "string",
},
timeouts: {
create: "string",
"delete": "string",
update: "string",
},
});
type: aws:bedrock:AgentAgent
properties:
agentName: string
agentResourceRoleArn: string
customerEncryptionKeyArn: string
description: string
foundationModel: string
idleSessionTtlInSeconds: 0
instruction: string
prepareAgent: false
promptOverrideConfigurations:
- overrideLambda: string
promptConfigurations:
- any
tags:
string: string
timeouts:
create: string
delete: string
update: string
AgentAgent Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
The AgentAgent resource accepts the following input properties:
- Agent
Name string - Name of the agent.
- Agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- Foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- Customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- Description string
- Description of the agent.
- Idle
Session intTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- Instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- Prepare
Agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - Prompt
Override List<AgentConfigurations Agent Prompt Override Configuration> - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Dictionary<string, string>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Timeouts
Agent
Agent Timeouts
- Agent
Name string - Name of the agent.
- Agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- Foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- Customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- Description string
- Description of the agent.
- Idle
Session intTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- Instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- Prepare
Agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - Prompt
Override []AgentConfigurations Agent Prompt Override Configuration Args - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - map[string]string
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Timeouts
Agent
Agent Timeouts Args
- agent
Name String - Name of the agent.
- agent
Resource StringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- foundation
Model String Foundation model used for orchestration by the agent.
The following arguments are optional:
- customer
Encryption StringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description String
- Description of the agent.
- idle
Session IntegerTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction String
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent Boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override List<AgentConfigurations Agent Prompt Override Configuration> - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Map<String,String>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Agent
Agent Timeouts
- agent
Name string - Name of the agent.
- agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description string
- Description of the agent.
- idle
Session numberTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override AgentConfigurations Agent Prompt Override Configuration[] - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - {[key: string]: string}
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Agent
Agent Timeouts
- agent_
name str - Name of the agent.
- agent_
resource_ strrole_ arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- foundation_
model str Foundation model used for orchestration by the agent.
The following arguments are optional:
- customer_
encryption_ strkey_ arn - ARN of the AWS KMS key that encrypts the agent.
- description str
- Description of the agent.
- idle_
session_ intttl_ in_ seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction str
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare_
agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt_
override_ Sequence[Agentconfigurations Agent Prompt Override Configuration Args] - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Mapping[str, str]
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts
Agent
Agent Timeouts Args
- agent
Name String - Name of the agent.
- agent
Resource StringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- foundation
Model String Foundation model used for orchestration by the agent.
The following arguments are optional:
- customer
Encryption StringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description String
- Description of the agent.
- idle
Session NumberTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction String
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent Boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override List<Property Map>Configurations - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Map<String>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - timeouts Property Map
Outputs
All input properties are implicitly available as output properties. Additionally, the AgentAgent resource produces the following output properties:
- Agent
Arn string - ARN of the agent.
- Agent
Id string - Unique identifier of the agent.
- Agent
Version string - Version of the agent.
- Id string
- The provider-assigned unique ID for this managed resource.
- Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- Agent
Arn string - ARN of the agent.
- Agent
Id string - Unique identifier of the agent.
- Agent
Version string - Version of the agent.
- Id string
- The provider-assigned unique ID for this managed resource.
- map[string]string
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- agent
Arn String - ARN of the agent.
- agent
Id String - Unique identifier of the agent.
- agent
Version String - Version of the agent.
- id String
- The provider-assigned unique ID for this managed resource.
- Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- agent
Arn string - ARN of the agent.
- agent
Id string - Unique identifier of the agent.
- agent
Version string - Version of the agent.
- id string
- The provider-assigned unique ID for this managed resource.
- {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- agent_
arn str - ARN of the agent.
- agent_
id str - Unique identifier of the agent.
- agent_
version str - Version of the agent.
- id str
- The provider-assigned unique ID for this managed resource.
- Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
- agent
Arn String - ARN of the agent.
- agent
Id String - Unique identifier of the agent.
- agent
Version String - Version of the agent.
- id String
- The provider-assigned unique ID for this managed resource.
- Map<String>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block.
Look up Existing AgentAgent Resource
Get an existing AgentAgent 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?: AgentAgentState, opts?: CustomResourceOptions): AgentAgent
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
agent_arn: Optional[str] = None,
agent_id: Optional[str] = None,
agent_name: Optional[str] = None,
agent_resource_role_arn: Optional[str] = None,
agent_version: Optional[str] = None,
customer_encryption_key_arn: Optional[str] = None,
description: Optional[str] = None,
foundation_model: Optional[str] = None,
idle_session_ttl_in_seconds: Optional[int] = None,
instruction: Optional[str] = None,
prepare_agent: Optional[bool] = None,
prompt_override_configurations: Optional[Sequence[AgentAgentPromptOverrideConfigurationArgs]] = None,
tags: Optional[Mapping[str, str]] = None,
tags_all: Optional[Mapping[str, str]] = None,
timeouts: Optional[AgentAgentTimeoutsArgs] = None) -> AgentAgent
func GetAgentAgent(ctx *Context, name string, id IDInput, state *AgentAgentState, opts ...ResourceOption) (*AgentAgent, error)
public static AgentAgent Get(string name, Input<string> id, AgentAgentState? state, CustomResourceOptions? opts = null)
public static AgentAgent get(String name, Output<String> id, AgentAgentState 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.
- Agent
Arn string - ARN of the agent.
- Agent
Id string - Unique identifier of the agent.
- Agent
Name string - Name of the agent.
- Agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- Agent
Version string - Version of the agent.
- Customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- Description string
- Description of the agent.
- Foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- Idle
Session intTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- Instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- Prepare
Agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - Prompt
Override List<AgentConfigurations Agent Prompt Override Configuration> - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Dictionary<string, string>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Dictionary<string, string>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Timeouts
Agent
Agent Timeouts
- Agent
Arn string - ARN of the agent.
- Agent
Id string - Unique identifier of the agent.
- Agent
Name string - Name of the agent.
- Agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- Agent
Version string - Version of the agent.
- Customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- Description string
- Description of the agent.
- Foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- Idle
Session intTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- Instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- Prepare
Agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - Prompt
Override []AgentConfigurations Agent Prompt Override Configuration Args - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - map[string]string
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - map[string]string
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - Timeouts
Agent
Agent Timeouts Args
- agent
Arn String - ARN of the agent.
- agent
Id String - Unique identifier of the agent.
- agent
Name String - Name of the agent.
- agent
Resource StringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- agent
Version String - Version of the agent.
- customer
Encryption StringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description String
- Description of the agent.
- foundation
Model String Foundation model used for orchestration by the agent.
The following arguments are optional:
- idle
Session IntegerTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction String
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent Boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override List<AgentConfigurations Agent Prompt Override Configuration> - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Map<String,String>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String,String>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - timeouts
Agent
Agent Timeouts
- agent
Arn string - ARN of the agent.
- agent
Id string - Unique identifier of the agent.
- agent
Name string - Name of the agent.
- agent
Resource stringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- agent
Version string - Version of the agent.
- customer
Encryption stringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description string
- Description of the agent.
- foundation
Model string Foundation model used for orchestration by the agent.
The following arguments are optional:
- idle
Session numberTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction string
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override AgentConfigurations Agent Prompt Override Configuration[] - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - {[key: string]: string}
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - {[key: string]: string}
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - timeouts
Agent
Agent Timeouts
- agent_
arn str - ARN of the agent.
- agent_
id str - Unique identifier of the agent.
- agent_
name str - Name of the agent.
- agent_
resource_ strrole_ arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- agent_
version str - Version of the agent.
- customer_
encryption_ strkey_ arn - ARN of the AWS KMS key that encrypts the agent.
- description str
- Description of the agent.
- foundation_
model str Foundation model used for orchestration by the agent.
The following arguments are optional:
- idle_
session_ intttl_ in_ seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction str
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare_
agent bool - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt_
override_ Sequence[Agentconfigurations Agent Prompt Override Configuration Args] - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Mapping[str, str]
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Mapping[str, str]
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - timeouts
Agent
Agent Timeouts Args
- agent
Arn String - ARN of the agent.
- agent
Id String - Unique identifier of the agent.
- agent
Name String - Name of the agent.
- agent
Resource StringRole Arn - ARN of the IAM role with permissions to invoke API operations on the agent.
- agent
Version String - Version of the agent.
- customer
Encryption StringKey Arn - ARN of the AWS KMS key that encrypts the agent.
- description String
- Description of the agent.
- foundation
Model String Foundation model used for orchestration by the agent.
The following arguments are optional:
- idle
Session NumberTtl In Seconds - Number of seconds for which Amazon Bedrock keeps information about a user's conversation with the agent. A user interaction remains active for the amount of time specified. If no conversation occurs during this time, the session expires and Amazon Bedrock deletes any data provided before the timeout.
- instruction String
- Instructions that tell the agent what it should do and how it should interact with users.
- prepare
Agent Boolean - Whether to prepare the agent after creation or modification. Defaults to
true
. - prompt
Override List<Property Map>Configurations - Configurations to override prompt templates in different parts of an agent sequence. For more information, see Advanced prompts. See
prompt_override_configuration
block for details. - Map<String>
- Map of tags assigned to the resource. If configured with a provider
default_tags
configuration block present, tags with matching keys will overwrite those defined at the provider-level. - Map<String>
- Map of tags assigned to the resource, including those inherited from the provider
default_tags
configuration block. - timeouts Property Map
Supporting Types
AgentAgentPromptOverrideConfiguration, AgentAgentPromptOverrideConfigurationArgs
- Override
Lambda string - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - Prompt
Configurations List<object> - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
- Override
Lambda string - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - Prompt
Configurations []interface{} - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
- override
Lambda String - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - prompt
Configurations List<Object> - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
- override
Lambda string - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - prompt
Configurations any[] - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
- override_
lambda str - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - prompt_
configurations Sequence[Any] - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
- override
Lambda String - ARN of the Lambda function to use when parsing the raw foundation model output in parts of the agent sequence. If you specify this field, at least one of the
prompt_configurations
block must contain aparser_mode
value that is set toOVERRIDDEN
. - prompt
Configurations List<Any> - Configurations to override a prompt template in one part of an agent sequence. See
prompt_configurations
block for details.
AgentAgentTimeouts, AgentAgentTimeoutsArgs
- Create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- Update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- Delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- Update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- update String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- update string
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- update str
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- create String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
- delete String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours). Setting a timeout for a Delete operation is only applicable if changes are saved into state before the destroy operation occurs.
- update String
- A string that can be parsed as a duration consisting of numbers and unit suffixes, such as "30s" or "2h45m". Valid time units are "s" (seconds), "m" (minutes), "h" (hours).
Import
Using pulumi import
, import Agents for Amazon Bedrock Agent using the agent ID. For example:
$ pulumi import aws:bedrock/agentAgent:AgentAgent example GGRRAED6JP
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.
Try AWS Native preview for resources not in the classic version.