Amazon 组件

业务组件 用于按提供商归类那些将第三方服务接入 SkillFlaw 的组件。

本页介绍 Amazon 业务组件中的可用组件。

Amazon Bedrock Converse

该组件使用 Amazon Bedrock LLMs 和 Bedrock Converse API 生成文本。

它既可以输出 Model Response（Message），也可以输出 Language Model（LanguageModel）。 具体来说，Language Model 输出是一个根据组件参数配置好的 ChatBedrockConverse 实例。

当你希望将 Amazon Bedrock 模型作为另一个 LLM 驱动组件（例如 Agent 或 Smart Transform 组件）的底层模型时，请使用 Language Model 输出。

更多说明请参阅语言模型组件。

Amazon Bedrock Converse 参数

有些参数在可视化编辑器中默认处于隐藏状态。 你可以通过组件标题栏菜单中的 控件 来修改全部参数。

Name	Type	Description
input_value	String	输入参数。用于生成文本的输入字符串。
system_message	String	输入参数。传递给模型的 system message。
stream	Boolean	输入参数。是否以流式方式返回响应。仅在聊天中生效。默认：false。
model_id	String	输入参数。要使用的 Amazon Bedrock 模型。
aws_access_key_id	SecretString	输入参数。用于认证的 AWS Access Key。必填。
aws_secret_access_key	SecretString	输入参数。用于认证的 AWS Secret Key。必填。
aws_session_token	SecretString	输入参数。你的 AWS 账号会话密钥。仅在使用临时凭证时需要。
credentials_profile_name	String	输入参数。要使用的 AWS 凭证配置名称。若未提供，则使用默认配置。
region_name	String	输入参数。Bedrock 资源所在的 AWS 区域。默认：us-east-1。
endpoint_url	String	输入参数。Bedrock 服务的自定义 endpoint URL。
temperature	Float	输入参数。控制输出随机性。值越高，输出越随机。默认：0.7。
max_tokens	Integer	输入参数。可生成的最大 token 数。默认：4096。
top_p	Float	输入参数。Nucleus sampling 参数，用于控制输出多样性。默认：0.9。
top_k	Integer	输入参数。限制参与采样的最高概率词汇数量。注意：并非所有模型都支持 top_k。默认：250。
disable_streaming	Boolean	输入参数。若为 True，则禁用流式响应。适合批处理场景。默认：false。
additional_model_fields	Dictionary	输入参数。用于微调行为的其他模型专用参数。

Amazon Bedrock Embeddings

Amazon Bedrock Embeddings 组件用于从 Amazon Bedrock 加载 embedding 模型。

有关 embedding 模型组件在流程中的使用方式，请参阅Embedding 模型组件。

Amazon Bedrock Embeddings 参数

有些参数在可视化编辑器中默认处于隐藏状态。 你可以通过组件标题栏菜单中的 控件 来修改全部参数。

Name	Type	Description
model_id	String	输入参数。要调用的模型 ID，例如 amazon.titan-embed-text-v1。这与 list-foundation-models API 中的 modelId 属性等价。
aws_access_key_id	SecretString	输入参数。用于认证的 AWS Access Key。
aws_secret_access_key	SecretString	输入参数。用于认证的 AWS Secret Key。
aws_session_token	SecretString	输入参数。你的 AWS 账号会话密钥。
credentials_profile_name	String	输入参数。~/.aws/credentials 或 ~/.aws/config 中 AWS 凭证配置的名称，该配置应包含访问密钥或角色信息。
region_name	String	输入参数。要使用的 AWS 区域，例如 us-west-2。若未提供，则回退到 AWS_DEFAULT_REGION 环境变量或 ~/.aws/config 中指定的区域。
endpoint_url	String	输入参数。用于指定默认 AWS endpoint 之外的服务 endpoint URL。

S3 Bucket Uploader

S3 Bucket Uploader 组件会将文件上传到 Amazon S3 bucket。 它设计用于处理来自 Read File 或 Directory 组件的 Data 输入。 如果你上传的是来自其他组件的 Data，请在生产环境运行流程前先验证结果。

该组件依赖 boto3 包，SkillFlaw 安装中已包含该包。

组件会生成日志，但不会向流程输出结果。

S3 Bucket Uploader 参数

有些参数在可视化编辑器中默认处于隐藏状态。 你可以通过组件标题栏菜单中的 控件 来修改全部参数。

Name	Type	Description
AWS Access Key ID	SecretString	输入参数。用于认证的 AWS Access Key ID。
AWS Secret Key	SecretString	输入参数。用于认证的 AWS Secret Key。
Bucket Name	String	输入参数。要上传文件到的 S3 bucket 名称。
Strategy for file upload	String	输入参数。文件上传策略。Store Data（默认）会遍历 Data 输入，记录文件路径和文本内容，并在两者都可用时将每个文件上传到指定的 S3 bucket。Store Original File 会遍历数据输入列表，从每条数据中读取文件路径，在路径可用时将原始文件上传到指定的 S3 bucket，并记录正在上传的文件路径。
Data Inputs	Data	输入参数。要遍历并作为文件上传到指定 S3 bucket 的 Data 输入。
S3 Prefix	String	输入参数。可选的 S3 bucket 内前缀（文件夹路径），文件将上传到该位置。
Strip Path	Boolean	输入参数。上传时是否去除文件路径。默认：false。

遗留 Amazon 组件

遗留组件已不再作为当前受支持能力的一部分，未来版本中可能会被移除。 你仍然可以在已有流程中继续使用它们，但建议尽快替换为当前受支持的组件。 若存在明确替代项，通常会在流程中组件卡片上的 遗留 标记、发布说明或 SkillFlaw 文档中给出说明。

如果你暂时不确定该如何替换某个遗留组件，可以先通过 Search 按提供商、服务或组件名称查找。 某些组件可能已经被全新的组件、相似组件，或其他分类下的同类新版本替代。

如果没有直接可见的替代项，也可以判断是否能用其他组件适配你的场景。 例如，许多 流程组件 提供的是可复用于多种提供商和业务场景的通用能力，例如 API Request 组件。

如果上述方式都不适用，你也可以参考遗留组件的实现代码自行封装自定义组件，或前往发起讨论反馈该遗留组件的替代需求。

为了避免在新流程中继续使用这些组件，系统默认会隐藏遗留组件。 在可视化编辑器中，你可以点击 组件设置，切换 遗留 过滤项的显示状态。

以下 Amazon 组件目前处于遗留状态：

Amazon Bedrock

Amazon Bedrock 组件已被废弃，建议改用 Amazon Bedrock Converse 组件，后者使用 Bedrock Converse API 处理会话。

如果你要在流程中使用 Amazon Bedrock 模型，请改用 Amazon Bedrock Converse 组件。