awslabs.cdk-mcp-server 0.0.10417__py3-none-any.whl

awslabs/cdk_mcp_server/static/bedrock/agent/collaboration.md

@@ -0,0 +1,91 @@
+# Agent Collaboration
+
+## Overview
+
+Agent Collaboration enables multiple Bedrock Agents to work together on complex tasks. This feature allows agents to specialize in different areas and collaborate to provide more comprehensive responses to user queries.
+
+## Collaboration Types
+
+You can configure collaboration for an agent using the `agentCollaboration` and `agentCollaborators` properties in the `AgentProps` interface.
+
+- **SUPERVISOR**: The agent acts as a supervisor that can delegate tasks to other agents.
+- **SUPERVISOR_ROUTER**: The agent acts as a supervisor that can route requests to specialized agents.
+- **DISABLED**: Collaboration is disabled (default).
+
+## Example
+
+### TypeScript
+
+```typescript
+import { Agent, AgentCollaboratorType, RelayConversationHistoryType } from '@cdklabs/generative-ai-cdk-constructs';
+
+// Create a specialized agent for customer support
+const customerSupportAgent = new Agent(this, 'CustomerSupportAgent', {
+  name: 'CustomerSupportAgent',
+  instruction: 'You specialize in answering customer support questions about our products.',
+  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+});
+
+// Create an agent alias for the specialized agent
+const customerSupportAlias = new AgentAlias(this, 'CustomerSupportAlias', {
+  agent: customerSupportAgent,
+  aliasName: 'production',
+});
+
+// Create a main agent that can collaborate with the specialized agent
+const mainAgent = new Agent(this, 'MainAgent', {
+  name: 'MainAgent',
+  instruction: 'You are a helpful assistant that can answer general questions and route specialized customer support questions to the customer support agent.',
+  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+  agentCollaboration: AgentCollaboratorType.SUPERVISOR,
+  agentCollaborators: [
+    new bedrock.AgentCollaborator({
+      agentAlias: customerSupportAlias,
+      collaborationInstruction: 'Route customer support questions to this agent.',
+      collaboratorName: 'CustomerSupport',
+      relayConversationHistory: true,
+    }),
+  ],
+});
+```
+
+### Python
+
+```python
+from cdklabs.generative_ai_cdk_constructs import (
+    bedrock,
+    AgentCollaboratorType,
+    RelayConversationHistoryType
+)
+
+# Create a specialized agent for customer support
+customer_support_agent = bedrock.Agent(self, 'CustomerSupportAgent',
+    name='CustomerSupportAgent',
+    instruction='You specialize in answering customer support questions about our products.',
+    foundation_model=bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+)
+
+# Create an agent alias for the specialized agent
+customer_support_alias = bedrock.AgentAlias(self, 'CustomerSupportAlias',
+    agent=customer_support_agent,
+    alias_name='production',
+)
+
+# Create a main agent that can collaborate with the specialized agent
+main_agent = bedrock.Agent(self, 'MainAgent',
+    name='MainAgent',
+    instruction='You are a helpful assistant that can answer general questions and route specialized customer support questions to the customer support agent.',
+    foundation_model=bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+    agent_collaboration=AgentCollaboratorType.SUPERVISOR,
+    agent_collaborators=[
+      bedrock.AgentCollaborator(
+        agent_alias= customer_support_alias,
+        collaboration_instruction= 'Route customer support questions to this agent.',
+        collaborator_name= 'CustomerSupport',
+        relay_conversation_history= true,
+      )
+    ],
+)
+```
+
+For more information on agent collaboration, refer to the [AWS Bedrock documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-collaboration.html).

awslabs/cdk_mcp_server/static/bedrock/agent/creation.md

@@ -0,0 +1,149 @@
+# Agent
+
+## Properties
+
+| Name | Type | Required | Description |
+|---|---|---|---|
+| name | string | No | The name of the agent. Defaults to a name generated by CDK |
+| instruction | string | Yes | The instruction used by the agent that determines how it will perform its task. Must have a minimum of 40 characters |
+| foundationModel | IInvokable | Yes | The foundation model used for orchestration by the agent |
+| existingRole | iam.IRole | No | The existing IAM Role for the agent to use. Must have a trust policy allowing Bedrock service to assume the role. Defaults to a new created role |
+| shouldPrepareAgent | boolean | No | Specifies whether to automatically update the `DRAFT` version of the agent after making changes. Defaults to false |
+| idleSessionTTL | Duration | No | How long sessions should be kept open for the agent. Session expires if no conversation occurs during this time. Defaults to 1 hour |
+| kmsKey | kms.IKey | No | The KMS key of the agent if custom encryption is configured. Defaults to AWS managed key |
+| description | string | No | A description of the agent. Defaults to no description |
+| knowledgeBases | IKnowledgeBase[] | No | The KnowledgeBases associated with the agent |
+| actionGroups | AgentActionGroup[] | No | The Action Groups associated with the agent |
+| guardrail | IGuardrail | No | The guardrail that will be associated with the agent |
+| promptOverrideConfiguration | PromptOverrideConfiguration | No | Overrides some prompt templates in different parts of an agent sequence configuration |
+| userInputEnabled | boolean | No | Select whether the agent can prompt additional information from the user when it lacks enough information. Defaults to false |
+| codeInterpreterEnabled | boolean | No | Select whether the agent can generate, run, and troubleshoot code when trying to complete a task. Defaults to false |
+| forceDelete | boolean | No | Whether to delete the resource even if it's in use. Defaults to true |
+
+## Create an Agent
+
+The following example creates an Agent with a simple instruction and default prompts that consults a Knowledge Base.
+
+### Example
+
+#### TypeScript
+
+```ts
+const agent = new bedrock.Agent(this, 'Agent', {
+  foundationModel: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_HAIKU_V1_0,
+  instruction: 'You are a helpful and friendly agent that answers questions about literature.',
+});
+
+agent.addKnowledgeBase(kb);
+```
+
+#### Python
+
+```python
+agent = bedrock.Agent(
+    self,
+    "Agent",
+    foundation_model=bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_HAIKU_V1_0,
+    instruction="You are a helpful and friendly agent that answers questions about insurance claims.",
+)
+  agent.add_knowledge_base(kb)
+```
+
+## Enable Cross Region Inference for Supported Models
+
+You can also use system defined inference profiles to enable cross region inference requests for supported models. For instance:
+
+### Example
+
+#### TypeScript
+
+```ts
+const cris = bedrock.CrossRegionInferenceProfile.fromConfig({
+  geoRegion: bedrock.CrossRegionInferenceProfileRegion.US,
+  model: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_5_SONNET_V1_0,
+});
+
+const agent = new bedrock.Agent(this, 'Agent', {
+  foundationModel: cris,
+  instruction: 'You are a helpful and friendly agent that answers questions about agriculture.',
+});
+```
+
+#### Python
+
+```python
+cris = bedrock.CrossRegionInferenceProfile.from_config(
+  geo_region= bedrock.CrossRegionInferenceProfileRegion.US,
+  model= bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_5_SONNET_V1_0
+)
+
+agent = bedrock.Agent(
+    self,
+    "Agent",
+    foundation_model=cris,
+    instruction="You are a helpful and friendly agent that answers questions about agriculture.",
+)
+```
+
+For more information on cross region inference, please refer to [System defined inference profiles](#system-defined-inference-profiles)
+
+## Prepare the Agent
+
+The `Agent` constructs take an optional parameter `shouldPrepareAgent` to indicate that the Agent should be prepared after any updates to an agent, Knowledge Base association, or action group. This may increase the time to create and update those resources. By default, this value is false .
+
+Creating an agent alias will not prepare the agent, so if you create an alias using the `AgentAlias` resource then you should set `shouldPrepareAgent` to **_true_**.
+
+## Memory Configuration
+
+Agents can maintain context across multiple sessions and recall past interactions using memory. This feature is useful for creating a more coherent conversational experience.
+
+### Memory Options
+
+You can configure memory for an agent using the `memory` property in the `AgentProps` interface. The memory configuration allows you to specify the type of memory and its properties.
+
+### Example
+
+#### TypeScript
+
+```typescript
+import { Agent, Memory, SessionSummaryMemoryProps } from 'src/cdk-lib/bedrock/agents';
+
+const agent = new Agent(this, 'MyAgent', {
+  name: 'MyAgent',
+  instruction: 'Your instruction here',
+  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+  memory: Memory.sessionSummary({
+        maxRecentSessions: 10, // Keep the last 20 session summaries
+        memoryDurationDays: 20, // Retain summaries for 30 days
+      }),
+});
+```
+
+#### Python
+
+```py
+from src.cdk_lib.bedrock.agents import Agent, Memory, BedrockFoundationModel
+
+agent = Agent(self, 'MyAgent',
+    name='MyAgent',
+    instruction='Your instruction here',
+    foundation_model=BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+    memory=Memory.session_summary(
+        max_recent_sessions=10,  # Keep the last 10 session summaries
+        memory_duration_days=20,  # Retain summaries for 20 days
+    ),
+)
+```
+
+### Memory Properties
+
+- **memoryDurationDays**: Duration in days for which session summaries are retained (1-365). Default is 30 days.
+- **maxRecentSessions**: Maximum number of recent session summaries to include (minimum 1). Default is 20.
+
+### Memory Types
+
+Currently, the following memory type is supported:
+
+- **SESSION_SUMMARY**: Uses memory summarization to enhance accuracy by summarizing sessions.
+
+For more information on memory configuration, refer to the [AWS Bedrock documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-memory.html).

awslabs/cdk_mcp_server/static/bedrock/agent/custom_orchestration.md

@@ -0,0 +1,74 @@
+# Custom Orchestration
+
+## Overview
+
+Custom Orchestration allows you to override the default agent orchestration flow with your own Lambda function. This enables more control over how the agent processes user inputs, handles knowledge base queries, and invokes action groups.
+
+## Orchestration Types
+
+You can configure the orchestration type using the `orchestrationType` and `customOrchestration` properties in the `AgentProps` interface.
+
+- **DEFAULT**: The default orchestration provided by Bedrock (default).
+- **CUSTOM_ORCHESTRATION**: Custom orchestration using a Lambda function.
+
+## Example
+
+### TypeScript
+
+```typescript
+import { Agent, OrchestrationType, OrchestrationExecutor } from '@cdklabs/generative-ai-cdk-constructs';
+import * as lambda from 'aws-cdk-lib/aws-lambda';
+import * as path from 'path';
+
+// Create a Lambda function for custom orchestration
+const orchestrationFunction = new lambda.Function(this, 'OrchestrationFunction', {
+  runtime: lambda.Runtime.PYTHON_3_10,
+  handler: 'index.handler',
+  code: lambda.Code.fromAsset(path.join(__dirname, 'lambda/orchestration')),
+});
+
+// Create an agent with custom orchestration
+const agent = new Agent(this, 'CustomOrchestrationAgent', {
+  name: 'CustomOrchestrationAgent',
+  instruction: 'You are a helpful assistant with custom orchestration logic.',
+  foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+  orchestrationType: OrchestrationType.CUSTOM_ORCHESTRATION,
+  customOrchestration: {
+    executor: OrchestrationExecutor.fromlambdaFunction(orchestrationFunction),
+  },
+});
+```
+
+### Python
+
+```python
+from cdklabs.generative_ai_cdk_constructs import (
+    bedrock,
+    OrchestrationType,
+    OrchestrationExecutor
+)
+import aws_cdk.aws_lambda as lambda_
+import os
+
+# Create a Lambda function for custom orchestration
+orchestration_function = lambda_.Function(self, 'OrchestrationFunction',
+    runtime=lambda_.Runtime.PYTHON_3_10,
+    handler='index.handler',
+    code=lambda_.Code.from_asset(os.path.join(os.path.dirname(__file__), 'lambda/orchestration')),
+)
+
+# Create an agent with custom orchestration
+agent = bedrock.Agent(self, 'CustomOrchestrationAgent',
+    name='CustomOrchestrationAgent',
+    instruction='You are a helpful assistant with custom orchestration logic.',
+    foundation_model=bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+    orchestration_type=OrchestrationType.CUSTOM_ORCHESTRATION,
+    custom_orchestration=bedrock.CustomOrchestration(
+      executor= OrchestrationExecutor.fromlambda_function(orchestration_function),
+    )
+)
+```
+
+The custom orchestration Lambda function receives events from Bedrock with the user's input and context, and it can control the flow of the conversation by deciding when to query knowledge bases, invoke action groups, or respond directly to the user.
+
+For more information on custom orchestration, refer to the [AWS Bedrock documentation](https://docs.aws.amazon.com/bedrock/latest/userguide/agents-custom-orchestration.html).

awslabs/cdk_mcp_server/static/bedrock/agent/overview.md

@@ -0,0 +1,78 @@
+# Amazon Bedrock Agents
+
+Amazon Bedrock Agents enable you to build AI assistants that can perform tasks by connecting foundation models to your data sources, APIs, and business systems.
+
+## Table of Contents
+
+- [Amazon Bedrock Agents](#amazon-bedrock-agents)
+  - [Table of Contents](#table-of-contents)
+  - [Key Concepts](#key-concepts)
+  - [Agent Components](#agent-components)
+  - [When to Use Agents](#when-to-use-agents)
+  - [Related Resources](#related-resources)
+  - [Quick Start Example](#quick-start-example)
+
+## Key Concepts
+
+- **Agent**: An AI assistant that uses foundation models to understand user requests and take actions
+- **Action Groups**: Functions your agent can call, defined by OpenAPI schemas and executed by Lambda functions
+- **Knowledge Bases**: Data sources that provide context to your agent
+- **Aliases**: Deployment targets for your agent, pointing to specific versions
+- **Orchestration**: The process of coordinating agent interactions with action groups and knowledge bases
+
+## Agent Components
+
+```mermaid
+graph TD
+    A[Agent] --> B[Foundation Model]
+    A --> C[Action Groups]
+    A --> D[Knowledge Bases]
+    A --> E[Aliases]
+    A --> F[Orchestration]
+    C --> G[Lambda Functions]
+    C --> H[OpenAPI Schema]
+    D --> I[Vector Stores]
+    D --> J[Data Sources]
+    F --> K[Default Orchestration]
+    F --> L[Custom Orchestration]
+```
+
+## When to Use Agents
+
+- **Task Automation**: Create assistants that can perform tasks like booking appointments or processing orders
+- **Data-Driven Conversations**: Build agents that can answer questions using your organization's data
+- **Multi-Step Workflows**: Implement complex workflows that require multiple steps and decisions
+- **System Integration**: Connect foundation models to your existing systems and APIs
+
+## Related Resources
+
+- **Action Groups**: `genai-cdk-constructs://bedrock/agent/actiongroups`
+- **Agent Aliases**: `genai-cdk-constructs://bedrock/agent/alias`
+- **Agent Creation**: `genai-cdk-constructs://bedrock/agent/creation`
+- **Agent Collaboration**: `genai-cdk-constructs://bedrock/agent/collaboration`
+- **Custom Orchestration**: `genai-cdk-constructs://bedrock/agent/custom_orchestration`
+- **Prompt Overrides**: `genai-cdk-constructs://bedrock/agent/prompt_override`
+
+## Quick Start Example
+
+```typescript
+import { bedrock } from '@cdklabs/generative-ai-cdk-constructs';
+
+// Create a basic agent
+const agent = new bedrock.Agent(this, 'Agent', {
+  foundationModel: bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_3_5_HAIKU_V1_0,
+  instruction: 'You are a helpful assistant that answers questions about our company.',
+  shouldPrepareAgent: true,
+});
+
+// Add a knowledge base
+agent.addKnowledgeBase(knowledgeBase);
+
+// Add an action group
+agent.addActionGroup(actionGroup);
+
+// Create an alias for deployment
+const agentAlias = new bedrock.AgentAlias(this, 'AgentAlias', {
+  aliasName: 'latest',
+  agent: agent,
+});

awslabs/cdk_mcp_server/static/bedrock/agent/prompt_override.md

@@ -0,0 +1,70 @@
+# Prompt Overrides
+
+## Overview
+
+Bedrock Agents allows you to customize the prompts and LLM configuration for its different steps. You can disable steps or create a new prompt template. Prompt templates can be inserted from plain text files.
+
+## Example
+
+### TypeScript
+
+```ts
+import { readFileSync } from 'fs';
+
+const file = readFileSync(prompt_path, 'utf-8');
+
+const agent = new bedrock.Agent(this, 'Agent', {
+      foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1,
+      instruction: 'You are a helpful and friendly agent that answers questions about literature.',
+      userInputEnabled: true,
+      codeInterpreterEnabled: false,
+      shouldPrepareAgent:true,
+      promptOverrideConfiguration: bedrock.PromptOverrideConfiguration.fromSteps(
+        [
+          {
+            stepType: bedrock.AgentStepType.PRE_PROCESSING,
+            stepEnabled: true,
+            customPromptTemplate: file,
+            inferenceConfig: {
+              temperature: 0.0,
+              topP: 1,
+              topK: 250,
+              maximumLength: 1,
+              stopSequences: ["\n\nHuman:"],
+            },
+            foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1
+          }
+        ]
+      )
+    });
+```
+
+### Python
+
+```python
+orchestration = open('prompts/orchestration.txt', encoding="utf-8").read()
+agent = bedrock.Agent(self, "Agent",
+            foundation_model=bedrock.BedrockFoundationModel.ANTHROPIC_CLAUDE_V2_1,
+            instruction="You are a helpful and friendly agent that answers questions about insurance claims.",
+            user_input_enabled=True,
+            code_interpreter_enabled=False,
+            should_prepare_agent=True,
+            prompt_override_configuration= bedrock.PromptOverrideConfiguration.from_steps(
+                steps=[
+                    bedrock.PromptStepConfiguration(
+                        step_type=bedrock.AgentStepType.PRE_PROCESSING,
+                        step_enabled= True,
+                        custom_prompt_template= file,
+                        inference_config=bedrock.InferenceConfiguration(
+                            temperature=0.0,
+                            top_k=250,
+                            top_p=1,
+                            maximum_length=1,
+                            stop_sequences=['\n\nHuman:'],
+                        ),
+                        foundationModel: bedrock.BedrockFoundationModel.AMAZON_NOVA_LITE_V1
+                    ),
+                ]
+            ),
+        )
+```

awslabs/cdk_mcp_server/static/bedrock/bedrockguardrails.md

@@ -0,0 +1,188 @@
+# Bedrock Guardrails
+
+Amazon Bedrock's Guardrails feature enables you to implement robust governance and control mechanisms for your generative AI applications, ensuring alignment with your specific use cases and responsible AI policies. Guardrails empowers you to create multiple tailored policy configurations, each designed to address the unique requirements and constraints of different use cases. These policy configurations can then be seamlessly applied across multiple foundation models (FMs) and Agents, ensuring a consistent user experience and standardizing safety, security, and privacy controls throughout your generative AI ecosystem.
+
+With Guardrails, you can define and enforce granular, customizable policies to precisely govern the behavior of your generative AI applications. You can configure the following policies in a guardrail to avoid undesirable and harmful content and remove sensitive information for privacy protection.
+
+- Content filters – Adjust filter strengths to block input prompts or model responses containing harmful content.
+
+- Denied topics – Define a set of topics that are undesirable in the context of your application. These topics will be blocked if detected in user queries or model responses.
+
+- Word filters – Configure filters to block undesirable words, phrases, and profanity. Such words can include offensive terms, competitor names etc.
+
+- Sensitive information filters – Block or mask sensitive information such as personally identifiable information (PII) or custom regex in user inputs and model responses.
+
+You can create a Guardrail with a minimum blockedInputMessaging ,blockedOutputsMessaging and default content filter policy.
+
+## Examples
+
+### TypeScript
+
+```ts
+const guardrails = new bedrock.Guardrail(this, 'bedrockGuardrails', {
+  name: 'my-BedrockGuardrails',
+  description: 'Legal ethical guardrails.',
+});
+
+// Optional - Add Sensitive information filters
+
+guardrails.addPIIFilter({
+  type: PIIType.General.ADDRESS,
+  action: GuardrailAction.ANONYMIZE,
+});
+
+guardrails.addRegexFilter({
+  name: 'TestRegexFilter',
+  description: 'This is a test regex filter',
+  pattern: '/^[A-Z]{2}d{6}$/',
+  action: bedrock.GuardrailAction.ANONYMIZE,
+});
+
+// Optional - Add contextual grounding
+
+guardrails.addContextualGroundingFilter({
+  type: ContextualGroundingFilterType.GROUNDING,
+  threshold: 0.95,
+});
+
+guardrails.addContextualGroundingFilter({
+  type: ContextualGroundingFilterType.RELEVANCE,
+  threshold: 0.95,
+});
+
+// Optional - Add Denied topics . You can use a Topic or create your custom Topic
+
+guardrails.addDeniedTopicFilter(Topic.FINANCIAL_ADVICE);
+guardrails.addDeniedTopicFilter(
+  Topic.custom({
+    name: 'Legal_Advice',
+    definition:
+      'Offering guidance or suggestions on legal matters, legal actions, interpretation of laws, or legal rights and responsibilities.',
+    examples: [
+      'Can I sue someone for this?',
+      'What are my legal rights in this situation?',
+      'Is this action against the law?',
+      'What should I do to file a legal complaint?',
+      'Can you explain this law to me?',
+    ],
+  })
+);
+
+// Optional - Add Word filters. You can upload words from a file with addWordFilterFromFile function.
+guardrails.addWordFilter('drugs');
+guardrails.addManagedWordListFilter(ManagedWordFilterType.PROFANITY);
+guardrails.addWordFilterFromFile('./scripts/wordsPolicy.csv');
+
+// versioning - if you change any guardrail configuration, a new version will be created
+guardrails.createVersion('testversion');
+
+// Importing existing guardrail
+const importedGuardrail = bedrock.Guardrail.fromGuardrailAttributes(stack, 'TestGuardrail', {
+  guardrailArn: 'arn:aws:bedrock:us-east-1:123456789012:guardrail/oygh3o8g7rtl',
+  guardrailVersion: '1', //optional
+  kmsKey: kmsKey, //optional
+});
+
+// Importing Guardrails created through the L1 CDK CfnGuardrail construct
+const cfnGuardrail = new CfnGuardrail(this, 'MyCfnGuardrail', {
+  blockedInputMessaging: 'blockedInputMessaging',
+  blockedOutputsMessaging: 'blockedOutputsMessaging',
+  name: 'namemycfnguardrails',
+  wordPolicyConfig: {
+    wordsConfig: [
+      {
+        text: 'drugs',
+      },
+    ],
+  },
+});
+
+const importedGuardrail = bedrock.Guardrail.fromCfnGuardrail(cfnGuardrail);
+```
+
+### Python
+
+```python
+    guardrail = bedrock.Guardrail(self, 'myGuardrails',
+        name='my-BedrockGuardrails',
+        description= "Legal ethical guardrails.")
+
+    # Optional - Add Sensitive information filters
+
+    guardrail.add_pii_filter(
+        type= bedrock.pii_type.General.ADDRESS,
+        action= bedrock.GuardrailAction.ANONYMIZE,
+    )
+
+    guardrail.add_regex_filter(
+        name= "TestRegexFilter",
+        description= "This is a test regex filter",
+        pattern= "/^[A-Z]{2}d{6}$/",
+        action= bedrock.GuardrailAction.ANONYMIZE,
+    )
+
+    # Optional - Add contextual grounding
+
+    guardrail.add_contextual_grounding_filter(
+        type= bedrock.ContextualGroundingFilterType.GROUNDING,
+        threshold= 0.95,
+    )
+
+    # Optional - Add Denied topics . You can use default Topic or create your custom Topic with createTopic function. The default Topics can also be overwritten.
+
+    guardrail.add_contextual_grounding_filter(
+        type= bedrock.ContextualGroundingFilterType.RELEVANCE,
+        threshold= 0.95,
+    )
+
+    guardrail.add_denied_topic_filter(bedrock.Topic.FINANCIAL_ADVICE)
+
+    guardrail.add_denied_topic_filter(
+      bedrock.Topic.custom(
+        name= "Legal_Advice",
+        definition=
+            "Offering guidance or suggestions on legal matters, legal actions, interpretation of laws, or legal rights and responsibilities.",
+        examples= [
+            "Can I sue someone for this?",
+            "What are my legal rights in this situation?",
+            "Is this action against the law?",
+            "What should I do to file a legal complaint?",
+            "Can you explain this law to me?",
+        ]
+      )
+    )
+
+    # Optional - Add Word filters. You can upload words from a file with addWordFilterFromFile function.
+    guardrail.add_word_filter("drugs")
+    guardrail.add_managed_word_list_filter(bedrock.ManagedWordFilterType.PROFANITY)
+    guardrail.add_word_filter_from_file("./scripts/wordsPolicy.csv")
+
+    # versioning - if you change any guardrail configuration, a new version will be created
+    guardrail.create_version("testversion")
+
+    # Importing existing guardrail
+    imported_guardrail = bedrock.Guardrail.from_guardrail_attributes(self, "TestGuardrail",
+      guardrail_arn="arn:aws:bedrock:us-east-1:123456789012:guardrail/oygh3o8g7rtl",
+      guardrail_version="1",
+      kms_key=kms_key
+    )
+
+    # Importing Guardrails created through the L1 CDK CfnGuardrail construct
+    cfn_guardrail = cfnbedrock.CfnGuardrail(self, "MyCfnGuardrail",
+        blocked_input_messaging="blockedInputMessaging",
+        blocked_outputs_messaging="blockedOutputsMessaging",
+        name="name",
+
+        # the properties below are optional
+        word_policy_config=cfnbedrock.CfnGuardrail.WordPolicyConfigProperty(
+            words_config=[cfnbedrock.CfnGuardrail.WordConfigProperty(
+                text="drugs"
+            )]
+        )
+    )
+
+    imported_guardrail = bedrock.Guardrail.from_cfn_guardrail(cfn_guardrail)
+```
+
+
+[View full documentation](https://github.com/awslabs/generative-ai-cdk-constructs/tree/main/src/cdk-lib/bedrock#bedrock-guardrails)