feat(agent): add support for agent collab, orch and FM in prompt (#1011)

* feat(agent): add support for collab, orch and FM in prompt

Author: krokoko

apidocs/namespaces/bedrock/README.md

@@ -12,6 +12,7 @@
 
 ## Enumerations
 
+- [AgentCollaboratorType](enumerations/AgentCollaboratorType.md)
 - [AgentStepType](enumerations/AgentStepType.md)
 - [ChatMessageRole](enumerations/ChatMessageRole.md)
 - [ConfluenceDataSourceAuthType](enumerations/ConfluenceDataSourceAuthType.md)
@@ -27,9 +28,11 @@
 - [InferenceProfileType](enumerations/InferenceProfileType.md)
 - [KnowledgeBaseType](enumerations/KnowledgeBaseType.md)
 - [ManagedWordFilterType](enumerations/ManagedWordFilterType.md)
+- [OrchestrationType](enumerations/OrchestrationType.md)
 - [ParsingModality](enumerations/ParsingModality.md)
 - [ParsingStategyType](enumerations/ParsingStategyType.md)
 - [PromptTemplateType](enumerations/PromptTemplateType.md)
+- [RelayConversationHistoryType](enumerations/RelayConversationHistoryType.md)
 - [SalesforceDataSourceAuthType](enumerations/SalesforceDataSourceAuthType.md)
 - [SalesforceObjectType](enumerations/SalesforceObjectType.md)
 - [SharePointDataSourceAuthType](enumerations/SharePointDataSourceAuthType.md)
@@ -45,6 +48,7 @@
 - [AgentAlias](classes/AgentAlias.md)
 - [AgentAliasBase](classes/AgentAliasBase.md)
 - [AgentBase](classes/AgentBase.md)
+- [AgentCollaborator](classes/AgentCollaborator.md)
 - [ApiSchema](classes/ApiSchema.md)
 - [ApplicationInferenceProfile](classes/ApplicationInferenceProfile.md)
 - [BedrockFoundationModel](classes/BedrockFoundationModel.md)
@@ -65,6 +69,7 @@
 - [KendraKnowledgeBaseBase](classes/KendraKnowledgeBaseBase.md)
 - [KnowledgeBaseBase](classes/KnowledgeBaseBase.md)
 - [Memory](classes/Memory.md)
+- [OrchestrationExecutor](classes/OrchestrationExecutor.md)
 - [ParentActionGroupSignature](classes/ParentActionGroupSignature.md)
 - [ParsingStategy](classes/ParsingStategy.md)
 - [Prompt](classes/Prompt.md)
@@ -88,6 +93,7 @@
 - [AgentAliasAttributes](interfaces/AgentAliasAttributes.md)
 - [AgentAliasProps](interfaces/AgentAliasProps.md)
 - [AgentAttributes](interfaces/AgentAttributes.md)
+- [AgentCollaboratorProps](interfaces/AgentCollaboratorProps.md)
 - [AgentPromptVariantProps](interfaces/AgentPromptVariantProps.md)
 - [AgentProps](interfaces/AgentProps.md)
 - [ApplicationInferenceProfileAttributes](interfaces/ApplicationInferenceProfileAttributes.md)
@@ -104,6 +110,7 @@
 - [ContextualGroundingFilter](interfaces/ContextualGroundingFilter.md)
 - [CrawlingFilters](interfaces/CrawlingFilters.md)
 - [CrossRegionInferenceProfileProps](interfaces/CrossRegionInferenceProfileProps.md)
+- [CustomOrchestration](interfaces/CustomOrchestration.md)
 - [CustomParserProps](interfaces/CustomParserProps.md)
 - [CustomTopicProps](interfaces/CustomTopicProps.md)
 - [DataSourceAssociationProps](interfaces/DataSourceAssociationProps.md)

apidocs/namespaces/bedrock/classes/Agent.md

@@ -66,6 +66,22 @@ The ARN of the agent.
 
 ***
 
+### agentCollaboration?
+
+> `readonly` `optional` **agentCollaboration**: [`AgentCollaboratorType`](../enumerations/AgentCollaboratorType.md)
+
+Agent collaboration type.
+
+***
+
+### agentCollaborators?
+
+> `readonly` `optional` **agentCollaborators**: [`AgentCollaborator`](AgentCollaborator.md)[]
+
+Agent collaborators.
+
+***
+
 ### agentId
 
 > `readonly` **agentId**: `string`
@@ -98,6 +114,14 @@ Whether the agent can generate, run, and troubleshoot code when trying to comple
 
 ***
 
+### customOrchestration?
+
+> `readonly` `optional` **customOrchestration**: [`CustomOrchestration`](../interfaces/CustomOrchestration.md)
+
+Custom orchestration configuration.
+
+***
+
 ### description?
 
 > `readonly` `optional` **description**: `string`
@@ -224,6 +248,14 @@ The tree node.
 
 ***
 
+### orchestrationType?
+
+> `readonly` `optional` **orchestrationType**: [`OrchestrationType`](../enumerations/OrchestrationType.md)
+
+The type of orchestration for the agent.
+
+***
+
 ### physicalName
 
 > `protected` `readonly` **physicalName**: `string`
@@ -365,6 +397,24 @@ Add multiple action groups to the agent.
 
 ***
 
+### addAgentCollaborator()
+
+> **addAgentCollaborator**(`agentCollaborator`): `void`
+
+Add an agent collaborator to the agent.
+
+#### Parameters
+
+##### agentCollaborator
+
+[`AgentCollaborator`](AgentCollaborator.md)
+
+#### Returns
+
+`void`
+
+***
+
 ### addGuardrail()
 
 > **addGuardrail**(`guardrail`): `void`

apidocs/namespaces/bedrock/classes/AgentAlias.md

@@ -322,6 +322,28 @@ Grant the given principal identity permissions to perform actions on this agent
 
 ***
 
+### grantGet()
+
+> **grantGet**(`grantee`): `Grant`
+
+Grant the given identity permissions to get the agent alias.
+
+#### Parameters
+
+##### grantee
+
+`IGrantable`
+
+#### Returns
+
+`Grant`
+
+#### Inherited from
+
+[`AgentAliasBase`](AgentAliasBase.md).[`grantGet`](AgentAliasBase.md#grantget)
+
+***
+
 ### grantInvoke()
 
 > **grantInvoke**(`grantee`): `Grant`

apidocs/namespaces/bedrock/classes/AgentAliasBase.md

@@ -337,6 +337,28 @@ Grant the given principal identity permissions to perform actions on this agent
 
 ***
 
+### grantGet()
+
+> **grantGet**(`grantee`): `Grant`
+
+Grant the given identity permissions to get the agent alias.
+
+#### Parameters
+
+##### grantee
+
+`IGrantable`
+
+#### Returns
+
+`Grant`
+
+#### Implementation of
+
+[`IAgentAlias`](../interfaces/IAgentAlias.md).[`grantGet`](../interfaces/IAgentAlias.md#grantget)
+
+***
+
 ### grantInvoke()
 
 > **grantInvoke**(`grantee`): `Grant`

apidocs/namespaces/bedrock/classes/AgentCollaborator.md

@@ -0,0 +1,102 @@
+[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md)
+
+***
+
+[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / [bedrock](../README.md) / AgentCollaborator
+
+# Class: AgentCollaborator
+
+***************************************************************************
+                        DEF - Agent Collaborator Class
+***************************************************************************
+
+## Constructors
+
+### new AgentCollaborator()
+
+> **new AgentCollaborator**(`props`): [`AgentCollaborator`](AgentCollaborator.md)
+
+#### Parameters
+
+##### props
+
+[`AgentCollaboratorProps`](../interfaces/AgentCollaboratorProps.md)
+
+#### Returns
+
+[`AgentCollaborator`](AgentCollaborator.md)
+
+## Properties
+
+### agentAlias
+
+> `readonly` **agentAlias**: [`IAgentAlias`](../interfaces/IAgentAlias.md)
+
+***
+
+### collaborationInstruction
+
+> `readonly` **collaborationInstruction**: `string`
+
+Instructions on how this agent should collaborate with the main agent.
+
+***
+
+### collaboratorName
+
+> `readonly` **collaboratorName**: `string`
+
+A friendly name for the collaborator.
+
+***
+
+### relayConversationHistory?
+
+> `readonly` `optional` **relayConversationHistory**: `boolean`
+
+Whether to relay conversation history to this collaborator.
+
+#### Default
+
+```ts
+- undefined (uses service default)
+```
+
+## Methods
+
+### \_render()
+
+> **\_render**(): `AgentCollaboratorProperty`
+
+**`Internal`**
+
+Format as CFN properties
+
+ This is an internal core function and should not be called directly.
+
+#### Returns
+
+`AgentCollaboratorProperty`
+
+***
+
+### grant()
+
+> **grant**(`grantee`): `Grant`
+
+Grants the specified principal permissions to get the agent alias and invoke the agent
+from this collaborator.
+
+#### Parameters
+
+##### grantee
+
+`IGrantable`
+
+The principal to grant permissions to
+
+#### Returns
+
+`Grant`
+
+The Grant object

apidocs/namespaces/bedrock/classes/OrchestrationExecutor.md

@@ -0,0 +1,52 @@
+[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md)
+
+***
+
+[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / [bedrock](../README.md) / OrchestrationExecutor
+
+# Class: OrchestrationExecutor
+
+Contains details about the Lambda function containing the orchestration logic carried
+out upon invoking the custom orchestration.
+
+## Properties
+
+### lambdaFunction
+
+> `readonly` **lambdaFunction**: `IFunction`
+
+## Methods
+
+### \_render()
+
+> **\_render**(): `OrchestrationExecutorProperty`
+
+**`Internal`**
+
+Format as CFN properties
+
+ This is an internal core function and should not be called directly.
+
+#### Returns
+
+`OrchestrationExecutorProperty`
+
+***
+
+### fromlambdaFunction()
+
+> `static` **fromlambdaFunction**(`lambdaFunction`): [`OrchestrationExecutor`](OrchestrationExecutor.md)
+
+Defines an orchestration executor with a Lambda function containing the business logic.
+
+#### Parameters
+
+##### lambdaFunction
+
+`IFunction`
+
+Lambda function to be called by the orchestration.
+
+#### Returns
+
+[`OrchestrationExecutor`](OrchestrationExecutor.md)

apidocs/namespaces/bedrock/enumerations/AgentCollaboratorType.md

@@ -0,0 +1,33 @@
+[**@cdklabs/generative-ai-cdk-constructs**](../../../README.md)
+
+***
+
+[@cdklabs/generative-ai-cdk-constructs](../../../README.md) / [bedrock](../README.md) / AgentCollaboratorType
+
+# Enumeration: AgentCollaboratorType
+
+Enum for collaborator's relay conversation history types.
+
+## Enumeration Members
+
+### DISABLED
+
+> **DISABLED**: `"DISABLED"`
+
+Disabling collaboration.
+
+***
+
+### SUPERVISOR
+
+> **SUPERVISOR**: `"SUPERVISOR"`
+
+Supervisor agent.
+
+***
+
+### SUPERVISOR\_ROUTER
+
+> **SUPERVISOR\_ROUTER**: `"SUPERVISOR_ROUTER"`
+
+Supervisor router.