Package software.amazon.awscdk.services.bedrock.alpha

Class AgentBase

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.Resource
software.amazon.awscdk.services.bedrock.alpha.AgentBase
All Implemented Interfaces:
IEnvironmentAware, IResource, IAgent, IGrantable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable
Direct Known Subclasses:
Agent
@Generated(value="jsii-pacmak/1.120.0 (build 192dc88)", date="2025-12-05T22:26:49.438Z") @Stability(Experimental) public abstract class AgentBase extends Resource implements IAgent
(experimental) Abstract base class for an Agent.

Contains methods and attributes valid for Agents either created with CDK or imported.

  • Constructor Details

    • AgentBase

      protected AgentBase(software.amazon.jsii.JsiiObjectRef objRef)

    • AgentBase

      protected AgentBase(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • AgentBase

      @Stability(Stable) protected AgentBase(@NotNull software.constructs.Construct scope, @NotNull String id, @Nullable ResourceProps props)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props -

    • AgentBase

      @Stability(Stable) protected AgentBase(@NotNull software.constructs.Construct scope, @NotNull String id)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.

  • Method Details

    • grantInvoke

      @Stability(Experimental) @NotNull public Grant grantInvoke(@NotNull IGrantable grantee)
      (experimental) Grant invoke permissions on this agent to an IAM principal.

      Default: - Default grant configuration: - actions: ['bedrock:InvokeAgent'] - resourceArns: [this.agentArn]

      Specified by:
      grantInvoke in interface IAgent
      Parameters:
      grantee -
      • The IAM principal to grant invoke permissions to.
      This parameter is required.
      Returns:
      An IAM Grant object representing the granted permissions

    • metricCount

      @Stability(Experimental) @NotNull public Metric metricCount(@Nullable MetricOptions props)
      (experimental) Creates a CloudWatch metric for tracking agent invocations.

      Default: - Default metric configuration: - namespace: 'AWS/Bedrock' - metricName: 'Invocations' - dimensionsMap: { AgentId: this.agentId }

      Specified by:
      metricCount in interface IAgent
      Parameters:
      props -
      • Configuration options for the metric.
      Returns:
      A CloudWatch Metric configured for agent invocation counts

    • metricCount

      @Stability(Experimental) @NotNull public Metric metricCount()
      (experimental) Creates a CloudWatch metric for tracking agent invocations.

      Default: - Default metric configuration: - namespace: 'AWS/Bedrock' - metricName: 'Invocations' - dimensionsMap: { AgentId: this.agentId }

      Specified by:
      metricCount in interface IAgent
      Returns:
      A CloudWatch Metric configured for agent invocation counts

    • onEvent

      @Stability(Experimental) @NotNull public Rule onEvent(@NotNull String id, @Nullable OnEventOptions options)
      (experimental) Creates an EventBridge rule for agent events.

      Default: - Default event pattern: - source: ['aws.bedrock'] - detail: { 'agent-id': [this.agentId] }

      Specified by:
      onEvent in interface IAgent
      Parameters:
      id -
      • Unique identifier for the rule.
      This parameter is required.
      options -
      • Configuration options for the event rule.
      Returns:
      An EventBridge Rule configured for agent events

    • onEvent

      @Stability(Experimental) @NotNull public Rule onEvent(@NotNull String id)
      (experimental) Creates an EventBridge rule for agent events.

      Default: - Default event pattern: - source: ['aws.bedrock'] - detail: { 'agent-id': [this.agentId] }

      Specified by:
      onEvent in interface IAgent
      Parameters:
      id -
      • Unique identifier for the rule.
      This parameter is required.
      Returns:
      An EventBridge Rule configured for agent events

    • getAgentArn

      @Stability(Experimental) @NotNull public abstract String getAgentArn()
      (experimental) The ARN of the agent.
      Specified by:
      getAgentArn in interface IAgent

    • getAgentId

      @Stability(Experimental) @NotNull public abstract String getAgentId()
      (experimental) The ID of the Agent.
      Specified by:
      getAgentId in interface IAgent

    • getAgentVersion

      @Stability(Experimental) @NotNull public abstract String getAgentVersion()
      (experimental) The version of the agent.

    • getGrantPrincipal

      @Stability(Experimental) @NotNull public abstract IPrincipal getGrantPrincipal()
      (experimental) The principal to grant permissions to.
      Specified by:
      getGrantPrincipal in interface IGrantable

    • getRole

      @Stability(Experimental) @NotNull public abstract IRole getRole()
      (experimental) The IAM role associated to the agent.
      Specified by:
      getRole in interface IAgent

    • getKmsKey

      @Stability(Experimental) @Nullable public abstract IKey getKmsKey()
      (experimental) Optional KMS encryption key associated with this agent.
      Specified by:
      getKmsKey in interface IAgent

    • getLastUpdated

      @Stability(Experimental) @Nullable public abstract String getLastUpdated()
      (experimental) When this agent was last updated.
      Specified by:
      getLastUpdated in interface IAgent