awslabs.cdk-mcp-server 0.1.1__py3-none-any.whl → 0.1.3__py3-none-any.whl

{awslabs_cdk_mcp_server-0.1.1.dist-info → awslabs_cdk_mcp_server-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: awslabs.cdk-mcp-server
-Version: 0.1.1
+Version: 0.1.3
 Summary: An AWS CDK MCP server that provides guidance on AWS Cloud Development Kit best practices, infrastructure as code patterns, and security compliance with CDK Nag. This server offers tools to validate infrastructure designs, explain CDK Nag rules, analyze suppressions, generate Bedrock Agent schemas, and discover Solutions Constructs patterns.
 Project-URL: Homepage, https://awslabs.github.io/mcp/
 Project-URL: Documentation, https://awslabs.github.io/mcp/servers/cdk-mcp-server/
@@ -186,6 +186,29 @@ Here are some ways you can work with MCP across AWS, and we'll be adding support
 }
 ```
 
+or docker after a succesful `docker build -t awslabs/cdk-mcp-server .`:
+
+```json
+  {
+    "mcpServers": {
+      "awslabs.cdk-mcp-server": {
+        "command": "docker",
+        "args": [
+          "run",
+          "--rm",
+          "--interactive",
+          "--env",
+          "FASTMCP_LOG_LEVEL=ERROR",
+          "awslabs/cdk-mcp-server:latest"
+        ],
+        "env": {},
+        "disabled": false,
+        "autoApprove": []
+      }
+    }
+  }
+```
+
 ## Security Considerations
 
 When using this MCP server, you should consider:

awslabs_cdk_mcp_server-0.1.3.dist-info/RECORD

@@ -0,0 +1,33 @@
+awslabs/__init__.py,sha256=CyFUCiG6C9srM7h_p6i9w72Y_G53m4QN-jK0duBu948,558
+awslabs/cdk_mcp_server/__init__.py,sha256=tE_wgU3b_iQUzMy9HlAJUehazMBzM9hGM94kDKPEDq4,748
+awslabs/cdk_mcp_server/server.py,sha256=Mom-3sv93jLG-KdESEfbrIEo3isXdAMhHcyTxANFtBw,693
+awslabs/cdk_mcp_server/core/__init__.py,sha256=P5jMlOb_nAqCEM22QnIe9RZMUCLVHwmAnwqJInvcQfc,605
+awslabs/cdk_mcp_server/core/resources.py,sha256=-JQijnp64JYmd7Nt4SAZ4f9gsS93R3pSNqM8ZsZTuf0,13662
+awslabs/cdk_mcp_server/core/search_utils.py,sha256=GLaNJBFzmDgwM8OY98R4VHfgj2Cw7GEBk-Y2lLZcPjM,6144
+awslabs/cdk_mcp_server/core/server.py,sha256=k0f7wvOuBebMZVeZA1bLDohCsjNH2IwZqZPPg3QBpSo,3288
+awslabs/cdk_mcp_server/core/tools.py,sha256=WZdR7K5Ilv9xlcwhQf4ZCdeIgUcA-Gb-NubEhTSc8IU,22007
+awslabs/cdk_mcp_server/data/__init__.py,sha256=8o7-TnXbiVvfwc_xc6LGnDfERnD9GMPRFfnWcgf--0Y,605
+awslabs/cdk_mcp_server/data/cdk_nag_parser.py,sha256=AKJU0O9lkzeVLAElzgBkV7rpKNUktywIXwmA52m3Vec,11477
+awslabs/cdk_mcp_server/data/construct_descriptions.py,sha256=CBfKFM_pJo6Sn_NA7hr-0oVB8piXdncQ_A5ewnTCx30,3164
+awslabs/cdk_mcp_server/data/genai_cdk_loader.py,sha256=xBEdhT5GVNom7lN0Vshm2y-P3yZJGNU7S_qL0UUHWxY,21516
+awslabs/cdk_mcp_server/data/lambda_layer_parser.py,sha256=TWInqjN56Vkhs-sXqLnIvhAPCBbq3Zlm1bAerUGb1cQ,8611
+awslabs/cdk_mcp_server/data/lambda_powertools_loader.py,sha256=XtJb8tTYhmAQ6Ulor6nhKWLQ56aIh2eElpBuw2D9sco,2411
+awslabs/cdk_mcp_server/data/schema_generator.py,sha256=eAjLnok3dqxnf3PtnwRno_Ps24ZZTo2iJcBv1H23sE0,29269
+awslabs/cdk_mcp_server/data/solutions_constructs_parser.py,sha256=NVOKV0cZl-9PdyoRtPo2JspSAEbCdebE8XR10dpCxyE,28243
+awslabs/cdk_mcp_server/static/CDK_GENERAL_GUIDANCE.md,sha256=-O0LIpmeDXr1JoVxxbQnVp0oNqvSbX20xOgcZqknr_c,8532
+awslabs/cdk_mcp_server/static/CDK_NAG_GUIDANCE.md,sha256=zJtHJp9ruaaJ-xa68k9kDrPmEaXpiWCZZf7JIy8NK0w,5839
+awslabs/cdk_mcp_server/static/__init__.py,sha256=NqWI8Mnqoc_sEr70ZtQ_oI6W_mdhuRCmgIbgmIWljzU,858
+awslabs/cdk_mcp_server/static/lambda_powertools/bedrock.md,sha256=vxYfQvp2UcXSszAB4oQQ7xPY808WjKSPRgOnIA31nLk,4114
+awslabs/cdk_mcp_server/static/lambda_powertools/cdk.md,sha256=rcYvoKOEj9R2Ptd5H61spys8j09nLgmpkD_o2niynvs,1900
+awslabs/cdk_mcp_server/static/lambda_powertools/dependencies.md,sha256=nZ2Fv54rG1rUmD_YHkM9h5VNvB81-Hk8Qx3ZNQSFZLY,1520
+awslabs/cdk_mcp_server/static/lambda_powertools/index.md,sha256=yivjInZAZ3tENKGrrAv7geICzUvKUTskWuaNj9nuPbI,1819
+awslabs/cdk_mcp_server/static/lambda_powertools/insights.md,sha256=jcyOHZvKHk2CgJwIu0B5SkP1SRMAhIOQ4FtWHlUs_IE,3212
+awslabs/cdk_mcp_server/static/lambda_powertools/logging.md,sha256=6CSgD8QB3Bs4s_x4RnbKwZoWvG6aG4etCnmDH6HU9XY,1797
+awslabs/cdk_mcp_server/static/lambda_powertools/metrics.md,sha256=DQlznxRizJep8jphzFgbk7crH5LwWjSjdygP-1K6mxk,2559
+awslabs/cdk_mcp_server/static/lambda_powertools/tracing.md,sha256=Q3dSCvgktb9sUsuuQ5ONU2Qdb1OTwbNOYpK--MDzBNw,2539
+awslabs_cdk_mcp_server-0.1.3.dist-info/METADATA,sha256=y17PsKmht9QeE03mOHreaqnlTrG4uJnX-cuWxeT8y6I,9134
+awslabs_cdk_mcp_server-0.1.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+awslabs_cdk_mcp_server-0.1.3.dist-info/entry_points.txt,sha256=LertzmID_mUU1YYZPySAF1IY1zE7ySTvzFxiGyo3VjY,78
+awslabs_cdk_mcp_server-0.1.3.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
+awslabs_cdk_mcp_server-0.1.3.dist-info/licenses/NOTICE,sha256=MNXNmhkltaxAzlo-r5BhjfS30nUE7I_w7cyDY8cxDL0,90
+awslabs_cdk_mcp_server-0.1.3.dist-info/RECORD,,

awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/actiongroups.md

@@ -1,137 +0,0 @@
-# Action Groups
-
-## Overview
-
-Action groups define functions your agent can call, connecting Bedrock Agents to your business logic via Lambda functions. The agent uses an OpenAPI schema to understand what your functions do and how to call them.
-
-```mermaid
-graph LR
-    A[Agent] --> B[Action Group]
-    B --> C[Lambda Function]
-    B --> D[OpenAPI Schema]
-```
-
-## Action Group Properties
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | Yes | The name of the action group |
-| description | string | No | A description of the action group |
-| apiSchema | ApiSchema | No | The API Schema |
-| executor | ActionGroupExecutor | No | The action group executor |
-| enabled | boolean | No | Specifies whether the action group is available for the agent to invoke or not when sending an InvokeAgent request. Defaults to true |
-| forceDelete | boolean | No | Specifies whether to delete the resource even if it's in use. Defaults to false |
-| functionSchema | CfnAgent.FunctionSchemaProperty | No | Defines functions that each define parameters that the agent needs to invoke from the user |
-| parentActionGroupSignature | ParentActionGroupSignature | No | The AWS Defined signature for enabling certain capabilities in your agent. When specified, description, apiSchema, and actionGroupExecutor must be blank |
-
-## OpenAPI Schema Generation & Best Practices
-
-For Action Groups, use the built-in OpenAPI schema generation tool provided by the AWS CDK MCP server:
-
-```typescript
-// Using MCP client
-const result = await use_mcp_tool({
-  server_name: "awslabs.cdk-mcp-server",
-  tool_name: "GenerateBedrockAgentSchema",
-  arguments: {
-    lambda_code_path: "path/to/your/lambda.py",
-    output_path: "path/to/output/openapi.json"
-  }
-});
-```
-
-The tool will:
-
-1. Parse your Lambda function code
-2. Extract function signatures and docstrings
-3. Generate a Bedrock-compatible OpenAPI schema
-4. Save it to the specified output path
-
-### Key Requirements
-- Ensure each operation has a unique operationId
-- Define complete response schemas
-- Use `fromLocalAsset` (not `fromAsset`) for API schemas
-- Include detailed descriptions for all endpoints, parameters, and return values
-- Use proper type annotations with Python type hints
-
-### Lambda Function Example
-
-```python
-from aws_lambda_powertools.event_handler import BedrockAgentResolver
-from typing import Annotated, List
-from aws_lambda_powertools.event_handler.openapi.params import Query, Path
-from pydantic import BaseModel, Field
-
-app = BedrockAgentResolver()
-
-class Product(BaseModel):
-    product_id: str = Field(description="Unique product identifier")
-    name: str = Field(description="Product name")
-    price: float = Field(description="Product price in USD")
-
-@app.get("/products", description="List available products")
-def list_products(
-    category: Annotated[str, Query(description="Product category")] = None
-) -> List[Product]:
-    # Your business logic here
-    return [Product(product_id="1", name="Product A", price=19.99)]
-
-def lambda_handler(event, context):
-    return app.resolve(event, context)
-```
-
-## Examples
-
-### TypeScript
-
-```ts
-const actionGroupFunction = new lambda_python.PythonFunction(this, 'ActionGroupFunction', {
-  runtime: lambda.Runtime.PYTHON_3_12,
-  entry: path.join(__dirname, '../lambda/action-group'),
-});
-
-// Example of proper Action Group setup with fromLocalAsset
-const actionGroup = new AgentActionGroup({
-  name: 'query-library',
-  description: 'Use these functions to get information about the books in the library.',
-  executor: bedrock.ActionGroupExecutor.fromlambdaFunction(actionGroupFunction),
-  enabled: true,
-  apiSchema: bedrock.ApiSchema.fromLocalAsset(path.join(__dirname, 'action-group.yaml')),
-});
-
-agent.addActionGroup(actionGroup);
-
-// Real-world example with account actions
-const agentAccountActions = new AgentActionGroup({
-  name: "agent-account-actions",
-  description: "Use these functions to take actions on authenticated user's accounts",
-  executor: bedrock.ActionGroupExecutor.fromlambdaFunction(accountActionsLambda),
-  apiSchema: bedrock.ApiSchema.fromLocalAsset(
-    path.join(agentsLambdaDir, "account_actions", "openapi.json"),
-  ),
-});
-
-agent.addActionGroup(agentAccountActions);
-```
-
-### Python
-
-```python
-action_group_function = PythonFunction(
-            self,
-            "LambdaFunction",
-            runtime=Runtime.PYTHON_3_12,
-            entry="./lambda",
-            index="app.py",
-            handler="lambda_handler",
-)
-
-actionGroup = bedrock.AgentActionGroup(
-    name="query-library",
-    description="Use these functions to get information about the books in the library.",
-    executor= bedrock.ActionGroupExecutor.fromlambda_function(action_group_function),
-    enabled=True,
-    api_schema=bedrock.ApiSchema.from_local_asset("action-group.yaml"))
-
-agent.add_action_group(actionGroup)
-```

awslabs/cdk_mcp_server/static/genai_cdk/bedrock/agent/alias.md

@@ -1,39 +0,0 @@
-# Agent Alias
-
-## Overview
-
-After you have sufficiently iterated on your working draft and are satisfied with the behavior of your agent, you can set it up for deployment and integration into your application by creating aliases of your agent.
-
-To deploy your agent, you need to create an alias. During alias creation, Amazon Bedrock automatically creates a version of your agent. The alias points to this newly created version. You can point the alias to a previously created version if necessary. You then configure your application to make API calls to that alias.
-
-By default, the `Agent` resource does not create any aliases, and you can use the 'DRAFT' version.
-
-## Specific Version
-
-You can use the `AgentAlias` resource if you want to create an Alias for an existing Agent.
-
-## Example
-
-### TypeScript
-
-```ts
-const agentAlias2 = new bedrock.AgentAlias(this, 'myalias2', {
-  aliasName: 'myalias',
-  agent: agent,
-  agentVersion: '1', // optional
-  description: 'mytest'
-});
-```
-
-### Python
-
-```python
-agent_alias_2 = bedrock.AgentAlias(self, 'myalias2',
-    alias_name='myalias',
-    agent=agent,
-    agent_version='1', # optional
-    description='mytest'
-)
-```
-
-[View full documentation](https://github.com/awslabs/generative-ai-cdk-constructs/blob/main/src/cdk-lib/bedrock/README.md)

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

@@ -1,91 +0,0 @@
-# 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/genai_cdk/bedrock/agent/creation.md

@@ -1,149 +0,0 @@
-# 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/genai_cdk/bedrock/agent/custom_orchestration.md

@@ -1,74 +0,0 @@
-# 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/genai_cdk/bedrock/agent/overview.md

@@ -1,78 +0,0 @@
-# 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,
-});