Class Guardrail.Builder

java.lang.Object
software.amazon.awscdk.services.bedrock.alpha.Guardrail.Builder
All Implemented Interfaces:
software.amazon.jsii.Builder<Guardrail>
Enclosing class:
Guardrail

@Stability(Experimental) public static final class Guardrail.Builder extends Object implements software.amazon.jsii.Builder<Guardrail>
(experimental) A fluent builder for Guardrail.
  • Method Details

    • create

      @Stability(Experimental) public static Guardrail.Builder create(software.constructs.Construct scope, String id)
      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      Returns:
      a new instance of Guardrail.Builder.
    • guardrailName

      @Stability(Experimental) public Guardrail.Builder guardrailName(String guardrailName)
      (experimental) The name of the guardrail.

      This will be used as the physical name of the guardrail.

      Parameters:
      guardrailName - The name of the guardrail. This parameter is required.
      Returns:
      this
    • blockedInputMessaging

      @Stability(Experimental) public Guardrail.Builder blockedInputMessaging(String blockedInputMessaging)
      (experimental) The message to return when the guardrail blocks a prompt.

      Must be between 1 and 500 characters.

      Default: "Sorry, your query violates our usage policy."

      Parameters:
      blockedInputMessaging - The message to return when the guardrail blocks a prompt. This parameter is required.
      Returns:
      this
    • blockedOutputsMessaging

      @Stability(Experimental) public Guardrail.Builder blockedOutputsMessaging(String blockedOutputsMessaging)
      (experimental) The message to return when the guardrail blocks a model response.

      Must be between 1 and 500 characters.

      Default: "Sorry, I am unable to answer your question because of our usage policy."

      Parameters:
      blockedOutputsMessaging - The message to return when the guardrail blocks a model response. This parameter is required.
      Returns:
      this
    • contentFilters

      @Stability(Experimental) public Guardrail.Builder contentFilters(List<? extends ContentFilter> contentFilters)
      (experimental) The content filters to apply to the guardrail.

      Default: []

      Parameters:
      contentFilters - The content filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • contentFiltersTierConfig

      @Stability(Experimental) public Guardrail.Builder contentFiltersTierConfig(TierConfig contentFiltersTierConfig)
      (experimental) The tier configuration to apply to the guardrail.

      Default: filters.TierConfig.CLASSIC

      Parameters:
      contentFiltersTierConfig - The tier configuration to apply to the guardrail. This parameter is required.
      Returns:
      this
    • contextualGroundingFilters

      @Stability(Experimental) public Guardrail.Builder contextualGroundingFilters(List<? extends ContextualGroundingFilter> contextualGroundingFilters)
      (experimental) The contextual grounding filters to apply to the guardrail.

      Default: []

      Parameters:
      contextualGroundingFilters - The contextual grounding filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • crossRegionConfig

      @Stability(Experimental) public Guardrail.Builder crossRegionConfig(GuardrailCrossRegionConfigProperty crossRegionConfig)
      (experimental) The cross-region configuration for the guardrail.

      This is optional and when provided, it should be of type GuardrailCrossRegionConfigProperty.

      Default: - No cross-region configuration

      Parameters:
      crossRegionConfig - The cross-region configuration for the guardrail. This parameter is required.
      Returns:
      this
    • deniedTopics

      @Stability(Experimental) public Guardrail.Builder deniedTopics(List<? extends Topic> deniedTopics)
      (experimental) A list of policies related to topics that the guardrail should deny.

      Default: []

      Parameters:
      deniedTopics - A list of policies related to topics that the guardrail should deny. This parameter is required.
      Returns:
      this
    • description

      @Stability(Experimental) public Guardrail.Builder description(String description)
      (experimental) The description of the guardrail.

      Default: - No description

      Parameters:
      description - The description of the guardrail. This parameter is required.
      Returns:
      this
    • kmsKey

      @Stability(Experimental) public Guardrail.Builder kmsKey(IKey kmsKey)
      (experimental) A custom KMS key to use for encrypting data.

      Default: - Data is encrypted by default with a key that AWS owns and manages for you

      Parameters:
      kmsKey - A custom KMS key to use for encrypting data. This parameter is required.
      Returns:
      this
    • managedWordListFilters

      @Stability(Experimental) public Guardrail.Builder managedWordListFilters(List<? extends ManagedWordFilter> managedWordListFilters)
      (experimental) The managed word filters to apply to the guardrail.

      Default: []

      Parameters:
      managedWordListFilters - The managed word filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • piiFilters

      @Stability(Experimental) public Guardrail.Builder piiFilters(List<? extends PIIFilter> piiFilters)
      (experimental) The PII filters to apply to the guardrail.

      Default: []

      Parameters:
      piiFilters - The PII filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • regexFilters

      @Stability(Experimental) public Guardrail.Builder regexFilters(List<? extends RegexFilter> regexFilters)
      (experimental) The regular expression (regex) filters to apply to the guardrail.

      Default: []

      Parameters:
      regexFilters - The regular expression (regex) filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • topicsTierConfig

      @Stability(Experimental) public Guardrail.Builder topicsTierConfig(TierConfig topicsTierConfig)
      (experimental) The tier configuration to apply to the guardrail.

      Default: filters.TierConfig.CLASSIC

      Parameters:
      topicsTierConfig - The tier configuration to apply to the guardrail. This parameter is required.
      Returns:
      this
    • wordFilters

      @Stability(Experimental) public Guardrail.Builder wordFilters(List<? extends WordFilter> wordFilters)
      (experimental) The word filters to apply to the guardrail.

      Default: []

      Parameters:
      wordFilters - The word filters to apply to the guardrail. This parameter is required.
      Returns:
      this
    • build

      @Stability(Experimental) public Guardrail build()
      Specified by:
      build in interface software.amazon.jsii.Builder<Guardrail>
      Returns:
      a newly built instance of Guardrail.