feat(bedrock): New embedding model config (#665)

Author: aws-rafams

apidocs/namespaces/bedrock/README.md

@@ -61,6 +61,7 @@
 - [ContextualGroundingPolicyConfigProps](interfaces/ContextualGroundingPolicyConfigProps.md)
 - [GuardrailConfiguration](interfaces/GuardrailConfiguration.md)
 - [GuardrailProps](interfaces/GuardrailProps.md)
+- [IAgentAlias](interfaces/IAgentAlias.md)
 - [IPrompt](interfaces/IPrompt.md)
 - [InferenceConfiguration](interfaces/InferenceConfiguration.md)
 - [KnowledgeBaseProps](interfaces/KnowledgeBaseProps.md)

apidocs/namespaces/bedrock/classes/AgentAlias.md

@@ -6,10 +6,16 @@
 
 # Class: AgentAlias
 
+Interface for both Imported and CDK-created Agent Aliases.
+
 ## Extends
 
 - `Construct`
 
+## Implements
+
+- [`IAgentAlias`](../interfaces/IAgentAlias.md)
+
 ## Constructors
 
 ### new AgentAlias()
@@ -34,12 +40,34 @@
 
 ## Properties
 
+### agentId
+
+> `readonly` **agentId**: `string`
+
+The unique identifier of the agent.
+
+#### Implementation of
+
+[`IAgentAlias`](../interfaces/IAgentAlias.md).[`agentId`](../interfaces/IAgentAlias.md#agentid)
+
+***
+
 ### aliasArn
 
 > `readonly` **aliasArn**: `string`
 
 The ARN of the agent alias.
 
+#### Example
+
+```ts
+`arn:aws:bedrock:us-east-1:123456789012:agent-alias/DNCJJYQKSU/TCLCITFZTN`
+```
+
+#### Implementation of
+
+[`IAgentAlias`](../interfaces/IAgentAlias.md).[`aliasArn`](../interfaces/IAgentAlias.md#aliasarn)
+
 ***
 
 ### aliasId
@@ -48,6 +76,16 @@ The ARN of the agent alias.
 
 The unique identifier of the agent alias.
 
+#### Example
+
+```ts
+`TCLCITFZTN`
+```
+
+#### Implementation of
+
+[`IAgentAlias`](../interfaces/IAgentAlias.md).[`aliasId`](../interfaces/IAgentAlias.md#aliasid)
+
 ***
 
 ### aliasName
@@ -86,6 +124,26 @@ Returns a string representation of this construct.
 
 ***
 
+### fromAliasArn()
+
+> `static` **fromAliasArn**(`scope`, `id`, `aliasArn`): [`IAgentAlias`](../interfaces/IAgentAlias.md)
+
+Brings an Agent Alias from an existing one created outside of CDK.
+
+#### Parameters
+
+• **scope**: `Construct`
+
+• **id**: `string`
+
+• **aliasArn**: `string`
+
+#### Returns
+
+[`IAgentAlias`](../interfaces/IAgentAlias.md)
+
+***
+
 ### isConstruct()
 
 > `static` **isConstruct**(`x`): `x is Construct`

apidocs/namespaces/bedrock/classes/BedrockFoundationModel.md

@@ -117,12 +117,27 @@ can instantiate a `BedrockFoundationModel` object, e.g: `new BedrockFoundationMo
 
 > `readonly` `static` **TITAN\_EMBED\_TEXT\_V2\_1024**: [`BedrockFoundationModel`](BedrockFoundationModel.md)
 
+***
+
+### TITAN\_EMBED\_TEXT\_V2\_256
+
+> `readonly` `static` **TITAN\_EMBED\_TEXT\_V2\_256**: [`BedrockFoundationModel`](BedrockFoundationModel.md)
+
+***
+
+### TITAN\_EMBED\_TEXT\_V2\_512
+
+> `readonly` `static` **TITAN\_EMBED\_TEXT\_V2\_512**: [`BedrockFoundationModel`](BedrockFoundationModel.md)
+
 ## Methods
 
 ### asArn()
 
 > **asArn**(`construct`): `string`
 
+Returns the ARN of the foundation model in the following format:
+`arn:${Partition}:bedrock:${Region}::foundation-model/${ResourceId}`
+
 #### Parameters
 
 • **construct**: `IConstruct`
@@ -133,6 +148,20 @@ can instantiate a `BedrockFoundationModel` object, e.g: `new BedrockFoundationMo
 
 ***
 
+### asIModel()
+
+> **asIModel**(`construct`): `IModel`
+
+#### Parameters
+
+• **construct**: `IConstruct`
+
+#### Returns
+
+`IModel`
+
+***
+
 ### toString()
 
 > **toString**(): `string`

apidocs/namespaces/bedrock/interfaces/AgentAliasProps.md

@@ -6,6 +6,8 @@
 
 # Interface: AgentAliasProps
 
+Interface to create a new Agent Alias.
+
 ## Properties
 
 ### agentId

apidocs/namespaces/bedrock/interfaces/IAgentAlias.md

@@ -0,0 +1,51 @@
+[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md) • **Docs**
+
+***
+
+[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / [bedrock](../README.md) / IAgentAlias
+
+# Interface: IAgentAlias
+
+Interface for both Imported and CDK-created Agent Aliases.
+
+## Properties
+
+### agentId
+
+> `readonly` **agentId**: `string`
+
+The unique identifier of the agent.
+
+#### Example
+
+```ts
+`DNCJJYQKSU`
+```
+
+***
+
+### aliasArn
+
+> `readonly` **aliasArn**: `string`
+
+The ARN of the agent alias.
+
+#### Example
+
+```ts
+`arn:aws:bedrock:us-east-1:123456789012:agent-alias/DNCJJYQKSU/TCLCITFZTN`
+```
+
+***
+
+### aliasId
+
+> `readonly` **aliasId**: `string`
+
+The unique identifier of the agent alias.
+
+#### Example
+
+```ts
+`TCLCITFZTN`
+```

src/cdk-lib/bedrock/agent-alias.ts

@@ -12,10 +12,34 @@
  */
 
 
-import { aws_bedrock as bedrock } from 'aws-cdk-lib';
+import { Arn, ArnFormat, aws_bedrock as bedrock, Resource } from 'aws-cdk-lib';
 import { Construct } from 'constructs';
 
 
+/**
+ * Interface for both Imported and CDK-created Agent Aliases.
+ */
+export interface IAgentAlias {
+  /**
+   * The unique identifier of the agent alias.
+   * @example `TCLCITFZTN`
+   */
+  readonly aliasId: string;
+  /**
+   * The unique identifier of the agent.
+   * @example `DNCJJYQKSU`
+   */
+  readonly agentId: string;
+  /**
+   * The ARN of the agent alias.
+   * @example `arn:aws:bedrock:us-east-1:123456789012:agent-alias/DNCJJYQKSU/TCLCITFZTN`
+   */
+  readonly aliasArn: string;
+}
+
+/**
+ * Interface to create a new Agent Alias.
+ */
 export interface AgentAliasProps {
   /**
    * The unique identifier of the agent.
@@ -27,7 +51,6 @@ export interface AgentAliasProps {
    * @default - 'latest'
    */
   readonly aliasName?: string;
-
   /**
    * Description for the agent alias.
    *
@@ -52,13 +75,48 @@ export interface AgentAliasProps {
   readonly tags?: Record<string, string>;
 }
 
-export class AgentAlias extends Construct {
+export class AgentAlias extends Construct implements IAgentAlias {
+  // ------------------------------------------------------
+  // Imports
+  // ------------------------------------------------------
+  /**
+   * Brings an Agent Alias from an existing one created outside of CDK.
+   */
+  public static fromAliasArn(scope: Construct, id: string, aliasArn: string): IAgentAlias {
+    class Import extends Resource implements IAgentAlias {
+      public readonly aliasArn = aliasArn;
+      public readonly aliasId: string;
+      public readonly agentId: string;
+
+      constructor() {
+        super(scope, id);
+        [this.agentId, this.aliasId] = this.parseArnComponents(aliasArn);
+      }
+
+      private parseArnComponents(arn: string): [string, string] {
+        const resourceName = Arn.split(arn, ArnFormat.SLASH_RESOURCE_SLASH_RESOURCE_NAME).resourceName!;
+        const [agentId, aliasId] = resourceName.split('/');
+        return [agentId, aliasId];
+      }
+    }
+    return new Import();
+  }
+
+  // ------------------------------------------------------
+  // CDK-created Agent Alias
+  // ------------------------------------------------------
+  /**
+   * The unique identifier of the agent.
+   */
+  public readonly agentId: string;
   /**
    * The unique identifier of the agent alias.
+   * @example `TCLCITFZTN`
    */
   public readonly aliasId: string;
   /**
    * The ARN of the agent alias.
+   * @example `arn:aws:bedrock:us-east-1:123456789012:agent-alias/DNCJJYQKSU/TCLCITFZTN`
    */
   public readonly aliasArn: string;
   /**
@@ -84,6 +142,7 @@ export class AgentAlias extends Construct {
       }];
     }
 
+    this.agentId = props.agentId;
     this.aliasId = alias.attrAgentAliasId;
     this.aliasArn = alias.attrAgentAliasArn;
     this.aliasName = props.aliasName ?? 'latest';