AWS Fundamentals Logo
AWS Fundamentals
AWS::Bedrock::Agent

Bedrock Agent

Definition of AWS::Bedrock::Agent Resource Type

Properties

20 configurable properties. 1 required. Click a row to see details.

Filter:
PropertyTypeFlags
AgentName
string
Required
ActionGroups
Array<AgentActionGroup>
AgentCollaboration
string
AgentCollaborators
Array<AgentCollaborator>
AgentResourceRoleArn
string
AutoPrepare
boolean
Write-only
CustomerEncryptionKeyArn
string
CustomOrchestration
CustomOrchestration
Description
string
FoundationModel
string
GuardrailConfiguration
GuardrailConfiguration
IdleSessionTTLInSeconds
number
Instruction
string
KnowledgeBases
Array<AgentKnowledgeBase>
MemoryConfiguration
MemoryConfiguration
OrchestrationType
string
PromptOverrideConfiguration
PromptOverrideConfiguration
SkipResourceInUseCheckOnDelete
boolean
Write-only
Tags
TagsMap
TestAliasTags
TagsMap

Return Values

Values returned after the resource is created. Access these with Fn::GetAtt.

AttributeTypeDescription
AgentArnstringArn representation of the Agent.
AgentIdstringIdentifier for a resource.
AgentStatusstring-
AgentVersionstringDraft Agent Version.
CreatedAtstringTime Stamp.
FailureReasonsArray<string>Failure Reasons for Error.
PreparedAtstringTime Stamp.
RecommendedActionsArray<string>The recommended actions users can take to resolve an error in failureReasons.
UpdatedAtstringTime Stamp.

Sample CloudFormation Template

A minimal template with required properties and common optional ones.

template.yaml
AWSTemplateFormatVersion: "2010-09-09"
Description: Sample template for AWS::Bedrock::Agent

Resources:
  MyResource:
    Type: AWS::Bedrock::Agent
    Properties:
      AgentName: "my-agentname"
      Tags:
        - Key: Environment
          Value: Production
      Description: !Ref "AWS::StackName"

Required IAM Permissions

Permissions CloudFormation needs in your IAM role to manage this resource.

create

bedrock:CreateAgentbedrock:GetAgentbedrock:PrepareAgentbedrock:GetAgentKnowledgeBasebedrock:AssociateAgentKnowledgeBasebedrock:ListAgentKnowledgeBasesbedrock:CreateAgentActionGroupbedrock:GetAgentActionGroup

read

bedrock:GetAgentbedrock:GetAgentActionGroupbedrock:ListAgentActionGroupsbedrock:GetAgentKnowledgeBasebedrock:ListAgentKnowledgeBasesbedrock:ListTagsForResourcebedrock:GetGuardrailbedrock:GetAgentCollaborator

update

bedrock:GetAgentbedrock:UpdateAgentbedrock:PrepareAgentbedrock:GetAgentKnowledgeBasebedrock:UpdateAgentKnowledgeBasebedrock:AssociateAgentKnowledgeBasebedrock:DisassociateAgentKnowledgeBasebedrock:ListAgentKnowledgeBases

delete

bedrock:GetAgentbedrock:DeleteAgentbedrock:DeleteGuardrailbedrock:GetGuardrailkms:Decryptkms:Encryptkms:GenerateDataKey

list

bedrock:ListAgentsbedrock:ListGuardrails

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

ServiceBedrock
Properties29
Required1
TaggingSupported
Primary IDAgentId

Supported Operations

CreateReadUpdateDeleteList

External Links