From f3aac15ae8ff0e586893011af5e2aa866221b898 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Wed, 15 Oct 2025 11:47:38 -0400 Subject: [PATCH 1/3] use-bedrock-converse --- docs/docs/Components/bundles-amazon.mdx | 64 ++++++++++++++++++++----- 1 file changed, 52 insertions(+), 12 deletions(-) diff --git a/docs/docs/Components/bundles-amazon.mdx b/docs/docs/Components/bundles-amazon.mdx index 532067ef4a78..63dd4ef7d286 100644 --- a/docs/docs/Components/bundles-amazon.mdx +++ b/docs/docs/Components/bundles-amazon.mdx @@ -10,34 +10,39 @@ import PartialParams from '@site/docs/_partial-hidden-params.mdx'; This page describes the components that are available in the **Amazon** bundle. -## Amazon Bedrock +## Amazon Bedrock Converse -This component generates text using [Amazon Bedrock LLMs](https://docs.aws.amazon.com/bedrock). +This component generates text using [Amazon Bedrock LLMs](https://docs.aws.amazon.com/bedrock) with the Bedrock Converse API. It can output either a **Model Response** ([`Message`](/data-types#message)) or a **Language Model** ([`LanguageModel`](/data-types#languagemodel)). -Specifically, the **Language Model** output is an instance of [`ChatBedrock`](https://docs.langchain.com/oss/python/integrations/chat/bedrock) configured according to the component's parameters. +Specifically, the **Language Model** output is an instance of [`ChatBedrockConverse`](https://docs.langchain.com/oss/python/integrations/chat/bedrock) configured according to the component's parameters. Use the **Language Model** output when you want to use an Amazon Bedrock model as the LLM for another LLM-driven component, such as an **Agent** or **Smart Transform** component. For more information, see [Language model components](/components-models). -### Amazon Bedrock parameters +### Amazon Bedrock Converse parameters | Name | Type | Description | |------|------|-------------| -| input | String | Input parameter. The input string for text generation. | +| input_value | String | Input parameter. The input string for text generation. | | system_message | String | Input parameter. A system message to pass to the model. | | stream | Boolean | Input parameter. Whether to stream the response. Only works in chat. Default: `false`. | -| model_id | String | Input parameter. The Amazon Bedrock model to use. | -| aws_access_key_id | SecretString | Input parameter. AWS Access Key for authentication. | -| aws_secret_access_key | SecretString | Input parameter. AWS Secret Key for authentication. | -| aws_session_token | SecretString | Input parameter. The session key for your AWS account. | -| credentials_profile_name | String | Input parameter. Name of the AWS credentials profile to use. | +| model_id | String | Input parameter. The Amazon Bedrock model to use. Default: `anthropic.claude-3-5-sonnet-20241022-v2:0`. | +| aws_access_key_id | SecretString | Input parameter. AWS Access Key for authentication. Required. | +| aws_secret_access_key | SecretString | Input parameter. AWS Secret Key for authentication. Required. | +| aws_session_token | SecretString | Input parameter. The session key for your AWS account. Only needed for temporary credentials. | +| credentials_profile_name | String | Input parameter. Name of the AWS credentials profile to use. If not provided, the default profile will be used. | | region_name | String | Input parameter. AWS region where your Bedrock resources are located. Default: `us-east-1`. | -| model_kwargs | Dictionary | Input parameter. Additional keyword arguments to pass to the model. | | endpoint_url | String | Input parameter. Custom endpoint URL for a Bedrock service. | +| temperature | Float | Input parameter. Controls randomness in output. Higher values make output more random. Default: `0.7`. | +| max_tokens | Integer | Input parameter. Maximum number of tokens to generate. Default: `4096`. | +| top_p | Float | Input parameter. Nucleus sampling parameter. Controls diversity of output. Default: `0.9`. | +| top_k | Integer | Input parameter. Limits the number of highest probability vocabulary tokens to consider. Note: Not all models support top_k. Default: `250`. | +| disable_streaming | Boolean | Input parameter. If True, disables streaming responses. Useful for batch processing. Default: `false`. | +| additional_model_fields | Dictionary | Input parameter. Additional model-specific parameters for fine-tuning behavior. | ## Amazon Bedrock Embeddings @@ -81,4 +86,39 @@ The component produces logs but it doesn't emit output to the flow. | **Strategy for file upload** | String | Input parameter. The file upload strategy. **Store Data** (default) iterates over `Data` inputs, logs the file path and text content, and uploads each file to the specified S3 bucket if both file path and text content are available. **Store Original File** iterates through the list of data inputs, retrieves the file path from each data item, uploads the file to the specified S3 bucket if the file path is available, and logs the file path being uploaded. | | **Data Inputs** | Data | Input parameter. The `Data` input to iterate over and upload as files in the specified S3 bucket. | | **S3 Prefix** | String | Input parameter. Optional prefix (folder path) within the S3 bucket where files will be uploaded. | -| **Strip Path** | Boolean | Input parameter. Whether to strip the file path when uploading. Default: `false`. | \ No newline at end of file +| **Strip Path** | Boolean | Input parameter. Whether to strip the file path when uploading. Default: `false`. | + +## Legacy Amazon components + +import PartialLegacy from '@site/docs/_partial-legacy.mdx'; + + + +The following Amazon components are in legacy status: + +
+Amazon Bedrock + +The **Amazon Bedrock** component was deprecated in favor of the **Amazon Bedrock Converse** component, which uses the Bedrock Converse API for conversation handling. + +To use Amazon Bedrock models in your flows, use the [**Amazon Bedrock Converse**](#amazon-bedrock-converse) component instead. + +### Amazon Bedrock parameters + + + +| Name | Type | Description | +|------|------|-------------| +| input | String | Input parameter. The input string for text generation. | +| system_message | String | Input parameter. A system message to pass to the model. | +| stream | Boolean | Input parameter. Whether to stream the response. Only works in chat. Default: `false`. | +| model_id | String | Input parameter. The Amazon Bedrock model to use. | +| aws_access_key_id | SecretString | Input parameter. AWS Access Key for authentication. | +| aws_secret_access_key | SecretString | Input parameter. AWS Secret Key for authentication. | +| aws_session_token | SecretString | Input parameter. The session key for your AWS account. | +| credentials_profile_name | String | Input parameter. Name of the AWS credentials profile to use. | +| region_name | String | Input parameter. AWS region where your Bedrock resources are located. Default: `us-east-1`. | +| model_kwargs | Dictionary | Input parameter. Additional keyword arguments to pass to the model. | +| endpoint_url | String | Input parameter. Custom endpoint URL for a Bedrock service. | + +
\ No newline at end of file From 4f7b1ee8be5424d7e03841a23508b2a2d3293acf Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Wed, 15 Oct 2025 12:22:19 -0400 Subject: [PATCH 2/3] Apply suggestion from @aimurphy Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com> --- docs/docs/Components/bundles-amazon.mdx | 17 ----------------- 1 file changed, 17 deletions(-) diff --git a/docs/docs/Components/bundles-amazon.mdx b/docs/docs/Components/bundles-amazon.mdx index 63dd4ef7d286..64fe12faada2 100644 --- a/docs/docs/Components/bundles-amazon.mdx +++ b/docs/docs/Components/bundles-amazon.mdx @@ -103,22 +103,5 @@ The **Amazon Bedrock** component was deprecated in favor of the **Amazon Bedrock To use Amazon Bedrock models in your flows, use the [**Amazon Bedrock Converse**](#amazon-bedrock-converse) component instead. -### Amazon Bedrock parameters - - - -| Name | Type | Description | -|------|------|-------------| -| input | String | Input parameter. The input string for text generation. | -| system_message | String | Input parameter. A system message to pass to the model. | -| stream | Boolean | Input parameter. Whether to stream the response. Only works in chat. Default: `false`. | -| model_id | String | Input parameter. The Amazon Bedrock model to use. | -| aws_access_key_id | SecretString | Input parameter. AWS Access Key for authentication. | -| aws_secret_access_key | SecretString | Input parameter. AWS Secret Key for authentication. | -| aws_session_token | SecretString | Input parameter. The session key for your AWS account. | -| credentials_profile_name | String | Input parameter. Name of the AWS credentials profile to use. | -| region_name | String | Input parameter. AWS region where your Bedrock resources are located. Default: `us-east-1`. | -| model_kwargs | Dictionary | Input parameter. Additional keyword arguments to pass to the model. | -| endpoint_url | String | Input parameter. Custom endpoint URL for a Bedrock service. | \ No newline at end of file From a16f8826775b02a9c039338a87cc90ed815ea966 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Wed, 15 Oct 2025 13:40:19 -0400 Subject: [PATCH 3/3] Update docs/docs/Components/bundles-amazon.mdx --- docs/docs/Components/bundles-amazon.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/Components/bundles-amazon.mdx b/docs/docs/Components/bundles-amazon.mdx index 64fe12faada2..a41ad01d5ad6 100644 --- a/docs/docs/Components/bundles-amazon.mdx +++ b/docs/docs/Components/bundles-amazon.mdx @@ -30,7 +30,7 @@ For more information, see [Language model components](/components-models). | input_value | String | Input parameter. The input string for text generation. | | system_message | String | Input parameter. A system message to pass to the model. | | stream | Boolean | Input parameter. Whether to stream the response. Only works in chat. Default: `false`. | -| model_id | String | Input parameter. The Amazon Bedrock model to use. Default: `anthropic.claude-3-5-sonnet-20241022-v2:0`. | +| model_id | String | Input parameter. The Amazon Bedrock model to use.| | aws_access_key_id | SecretString | Input parameter. AWS Access Key for authentication. Required. | | aws_secret_access_key | SecretString | Input parameter. AWS Secret Key for authentication. Required. | | aws_session_token | SecretString | Input parameter. The session key for your AWS account. Only needed for temporary credentials. |