class AgentRuntimeArtifact 🔹

Language	Type name
.NET	Amazon.CDK.AWS.Bedrock.Agentcore.Alpha.AgentRuntimeArtifact
Go	github.com/aws/aws-cdk-go/awsbedrockagentcorealpha/v2#AgentRuntimeArtifact
Java	software.amazon.awscdk.services.bedrock.agentcore.alpha.AgentRuntimeArtifact
Python	aws_cdk.aws_bedrock_agentcore_alpha.AgentRuntimeArtifact
TypeScript (source)	@aws-cdk/aws-bedrock-agentcore-alpha » AgentRuntimeArtifact

Abstract base class for agent runtime artifacts.

Provides methods to reference container images from ECR repositories or local assets.

Example

const repository = new ecr.Repository(this, "TestRepository", {
  repositoryName: "test-agent-runtime",
});
const agentRuntimeArtifact = agentcore.AgentRuntimeArtifact.fromEcrRepository(repository, "v1.0.0");

const runtime = new agentcore.Runtime(this, "MyAgentRuntime", {
  runtimeName: "myAgent",
  agentRuntimeArtifact: agentRuntimeArtifact,
  authorizerConfiguration: agentcore.RuntimeAuthorizerConfiguration.usingOAuth(
    "https://github.com/.well-known/openid-configuration",
    "oauth_client_123",
  ),
});

Initializer

new AgentRuntimeArtifact()

Methods

Name	Description
bind(scope, runtime)🔹	Called when the image is used by a Runtime to handle side effects like permissions.
static fromAsset(directory, options?)🔹	Reference an agent runtime artifact that's constructed directly from sources on disk.
static fromEcrRepository(repository, tag?)🔹	Reference an image in an ECR repository.

---

bind(scope, runtime)🔹

public bind(scope: Construct, runtime: Runtime): void

Parameters

• scope Construct
• runtime Runtime

Called when the image is used by a Runtime to handle side effects like permissions.

---

static fromAsset(directory, options?)🔹

public static fromAsset(directory: string, options?: DockerImageAssetOptions): AgentRuntimeArtifact

Parameters

• directory string — The directory where the Dockerfile is stored.
• options DockerImageAssetOptions — The options to further configure the selected image.

Returns

• AgentRuntimeArtifact

Reference an agent runtime artifact that's constructed directly from sources on disk.

---

static fromEcrRepository(repository, tag?)🔹

public static fromEcrRepository(repository: IRepository, tag?: string): AgentRuntimeArtifact

Parameters

• repository IRepository
• tag string

Returns

• AgentRuntimeArtifact

Reference an image in an ECR repository.