AWS Bedrock 聊天模型节点
AWS Bedrock Chat Model 节点允许您使用 AWS Bedrock 平台的 LLM 模型。
在此页面上,您将找到 AWS Bedrock Chat Model 节点的节点参数和更多资源的链接。
提示
Credentials 凭证
您可以在AWS 凭据文档找到该节点的身份验证信息。
如果你通过不带 private DNS 的 VPC interface endpoint (PrivateLink){:target=_blank .external-link} 路由 Bedrock,请在凭据中设置 Bedrock Endpoint 和 Bedrock Runtime Endpoint 自定义端点。
提示
Parameter resolution in sub-nodes 子节点参数解析
使用表达式处理多个项目时,子节点的行为与其他节点不同。
大多数节点,包括根节点,接受任意数量的项目作为输入,处理这些项目,并输出结果。您可以使用表达式引用输入项目,节点会依次为每个项目解析表达式。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 会依次解析为每个名称。
在子节点中,表达式始终解析为第一项。例如,给定五个 name 值的输入,表达式 {{ $json.name }} 始终解析为名字。
节点参数
- Authentication 身份验证:选择身份验证方法:
- AWS (IAM):使用 IAM 访问密钥。选择 AWS 凭据。
- AWS (Assume Role):临时担任 IAM 角色。选择 AWS (Assume Role) 凭据。
- Model 模型:选择生成补全的模型或推理配置文件。下拉列表会同时列出按需基础模型和跨区域推理配置文件。最新模型(例如 Claude Sonnet 4.x)仅作为推理配置文件提供。如果列表缺少部分内容,你的 IAM 角色可能缺少
bedrock:ListFoundationModels或bedrock:ListInferenceProfiles权限。你也可以将字段切换为 Expression 表达式模式,直接输入模型 ID、推理配置文件 ID 或 ARN。
提示
在节点版本 1.1 中,下拉列表一次只显示一类内容:使用 Model Source 模型来源参数在按需基础模型和推理配置文件之间切换。节点版本 1 仅支持按需基础模型。
在 Amazon Bedrock 模型文档{:target=_blank .external-link} 中了解更多可用模型。
节点选项
- Maximum Number of Tokens 最大令牌数:输入使用的最大令牌数,这设置了补全长度。
- Sampling Temperature 采样温度:使用此选项控制采样过程的随机性。较高的温度会创建更多样化的采样,但会增加幻觉的风险。
- Top P:设置 token 选择的概率阈值。较低值会将候选池限制为更可能的 tokens;较高值允许更多样化的选项。
- Max Retries 最大重试次数:输入请求的最大重试次数。
- Timeout 超时:输入等待请求完成的最长时间(毫秒)。长时间生成时可增大此值。设置为
0可禁用超时。 - Additional Model Request Fields 其他模型请求字段:以 JSON 输入特定 model family 的推理参数,例如 Claude 的
top_k或 Nova 的inferenceConfig。每个 model family 支持的参数请参阅 AWS model parameters 文档。 - Latency Optimization 延迟优化:选择请求使用 Standard 标准 还是 Optimized 优化 延迟。Optimized 模式可为支持的模型和区域缩短响应时间。可用性请参阅 AWS latency-optimized inference 文档。
- Guardrail 防护栏:将 Amazon Bedrock guardrail 应用于请求。详细信息请参阅使用 AWS Guardrails。
使用 AWS Guardrails
Guardrails 让你的组织可以对模型调用强制执行内容和安全策略。guardrail 必须与模型位于同一 AWS region。Guardrail 防护栏 选项包含以下字段:
- Guardrail Identifier 防护栏标识符:要应用的 guardrail 的 ID 或完整 ARN。
- Guardrail Version 防护栏版本:要使用的 guardrail 版本:数字版本字符串(例如
1)或工作草稿DRAFT。默认为DRAFT。 - Trace 跟踪:AWS 是否在响应中包含有关 guardrail 评估的诊断 trace 信息:Disabled 禁用(默认)、Enabled 启用 或 Enabled (Full) 完整启用。注意:启用 trace 会让 AWS 在响应中包含 guardrail 评估详情(可能回显匹配的输入内容,例如 PII findings);n8n 目前不会在 AI log 中显示这些内容。
当 guardrail 介入时,节点会返回 guardrail 配置的 blocked message 来代替模型输出,作为普通响应而不是错误。n8n 不会暴露底层 stop reason:如果要在下游检测介入,请匹配你的 guardrail blocked message 文本。无效的 guardrail identifier 或 version 会使节点以 AWS validation error 失败。Guardrails 同时适用于 streaming 和 non-streaming 请求。
提示
IAM 权限
除了 invoke 权限外,凭证还需要对 guardrail resource 拥有 bedrock:ApplyGuardrail 权限。没有此权限时,一旦设置 guardrail,请求会以 AccessDeniedException 失败。如果你的组织要求每次调用都使用 guardrail,请在 IAM 的 invoke 权限中强制执行 bedrock:GuardrailIdentifier condition key,而不是依赖此可选节点字段。
代理限制
此节点不支持 NO_PROXY 环境变量。
模板和示例
浏览 AWS Bedrock Chat 模型节点文档集成模板 或 搜索所有模板
相关资源
请参考 LangChain 的 AWS Bedrock Chat Model 文档{:target=_blank .external-link} 获取有关该服务的更多信息。
查看 n8n 的 Advanced AI 高级 AI 文档。