AWS::BedrockAgentCore::Runtime

Note

Amazon Bedrock AgentCore is in preview release and is subject to change.

Contains information about an agent runtime. An agent runtime is the execution environment for a Amazon Bedrock Agent.

AgentCore Runtime is a secure, serverless runtime purpose-built for deploying and scaling dynamic AI agents and tools using any open-source framework including LangGraph, CrewAI, and Strands Agents, any protocol, and any model.

For more information about using agent runtime in Amazon Bedrock AgentCore, see Host agent or tools with Amazon Bedrock AgentCore Runtime.

See the Properties section below for descriptions of both the required and optional properties.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::BedrockAgentCore::Runtime",
  "Properties" : {
      "AgentRuntimeArtifact" : AgentRuntimeArtifact,
      "AgentRuntimeName" : String,
      "AuthorizerConfiguration" : AuthorizerConfiguration,
      "Description" : String,
      "EnvironmentVariables" : {Key: Value, ...},
      "NetworkConfiguration" : NetworkConfiguration,
      "ProtocolConfiguration" : String,
      "RoleArn" : String,
      "Tags" : {Key: Value, ...}
    }
}

YAML

Type: AWS::BedrockAgentCore::Runtime
Properties:
  AgentRuntimeArtifact: 
    AgentRuntimeArtifact
  AgentRuntimeName: String
  AuthorizerConfiguration: 
    AuthorizerConfiguration
  Description: String
  EnvironmentVariables: 
    Key: Value
  NetworkConfiguration: 
    NetworkConfiguration
  ProtocolConfiguration: String
  RoleArn: String
  Tags: 
    Key: Value

Properties

AgentRuntimeArtifact

The artifact of the agent.

Required: Yes

Type: AgentRuntimeArtifact

Update requires: No interruption

AgentRuntimeName

The name of the AgentCore Runtime endpoint.

Required: Yes

Type: String

Pattern: [a-zA-Z][a-zA-Z0-9_]{0,47}

Update requires: Replacement

AuthorizerConfiguration

Represents inbound authorization configuration options used to authenticate incoming requests.

Required: No

Type: AuthorizerConfiguration

Update requires: No interruption

Description

The agent runtime description.

Required: No

Type: String

Minimum: 1

Maximum: 1200

Update requires: No interruption

EnvironmentVariables

The environment variables for the agent.

Required: No

Type: Object of String

Pattern: ^[a-zA-Z_][a-zA-Z0-9_]*$

Maximum: 2048

Update requires: No interruption

NetworkConfiguration

The network configuration.

Required: Yes

Type: NetworkConfiguration

Update requires: No interruption

ProtocolConfiguration

The protocol configuration for an agent runtime. This structure defines how the agent runtime communicates with clients.

Required: No

Type: String

Allowed values: MCP | HTTP

Update requires: No interruption

RoleArn

The Amazon Resource Name (ARN) for for the role.

Required: Yes

Type: String

Pattern: arn:aws(-[^:]+)?:iam::([0-9]{12})?:role/.+

Update requires: No interruption

Tags

The tags for the agent.

Required: No

Type: Object of String

Pattern: ^[a-zA-Z0-9\s._:/=+@-]*$

Minimum: 0

Maximum: 256

Update requires: No interruption

Return values

Ref

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

AgentRuntimeArn

The agent runtime ARN.

AgentRuntimeId

The ID for the agent runtime.

AgentRuntimeVersion

The version for the agent runtime.

CreatedAt

The time at which the runtime was created.

LastUpdatedAt

The time at which the runtime was last updated.

Status

The status for the agent runtime.