n8n 中文文档

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 文档。

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。