在 Amazon Bedrock 中创建流程 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

在 Amazon Bedrock 中创建流程

要创建流程,您只需提供流程的名称和描述并指定具有适当权限的服务角色(或者让 Amazon Bedrock 控制台自动为您创建一个服务角色)。然后,您将通过配置节点(充当流程中的步骤)和节点之间的连接来定义流程。在创建流程之前,我们建议您阅读亚马逊 Bedrock Flows 的工作原理以熟悉 Amazon Bedrock Flows 中的概念和术语,并了解可供您使用的节点类型。

Amazon Bedrock 会对您的静态数据进行加密。默认情况下,Amazon Bedrock 使用 AWS 托管式密钥对这些数据进行加密。或者,您可以使用客户托管密钥对流程执行数据进行加密。有关更多信息,请参阅 Amazon Bedrock Flows 资源的加密

要了解如何创建流程,请选择首选方法的选项卡,然后按照以下步骤操作:

Console
创建流程
  1. AWS Management Console 使用具有 Amazon Bedrock 权限的 IAM 角色登录,然后在 “入门” 中打开 Amazon Bedrock 控制台。 AWS Management Console

  2. 从左侧导航窗格中选择 Amazon Bedrock Flow s。

  3. Amazon Bedrock Flows 部分中,选择创建流程

  4. 输入工作流的名称和(可选)描述

  5. 对于服务角色名称,选择以下选项之一:

  6. (可选)要使用 KMS 密钥加密您的流程,请选择自定义加密设置(高级),然后选择密钥。有关更多信息,请参阅 Amazon Bedrock Flows 资源的加密

  7. 选择创建。您的流程已创建,您将被带到流程生成器,您可以在其中构建流程。

  8. 您可以继续执行以下步骤来构建流程,也可以稍后返回流程生成器

构建工作流
  1. 如果您尚未使用流程生成器,请执行以下操作:

    1. AWS Management Console 使用具有 Amazon Bedrock 权限的 IAM 角色登录,然后在 “入门” 中打开 Amazon Bedrock 控制台。 AWS Management Console

    2. 从左侧导航窗格中选择 Amazon Bedrock Flow s。然后,在 Amazon Bedrock Flows 部分中选择一个流程

    3. 在流程生成器中选择 “编辑”

  2. Flow Builder 部分,中间窗格显示一个 Flow 输入节点和一个 Flow 输出节点。这些是工作流的输入和输出节点。

  3. 添加和配置节点

    1. Flow Builder 窗格中,选择节点

    2. 将要用于工作流第一步的节点拖放到中央窗格中。

    3. 节点上的圆圈是连接点。要将工作流输入节点连接到第二个节点,请从工作流输入节点上的圆圈拖出一条线,拖动到刚刚添加的节点输入部分的圆圈。

    4. 选择刚刚添加的节点。

    5. Flow Builder 窗格的 “配置” 部分,提供所选节点的配置,并定义节点的输入和输出的名称、数据类型和表达式。

    6. Flow Builder 窗格中,选择节点

    7. 重复步骤,为工作流中的其余节点添加和配置节点。

      注意

      如果您使用 Amazon Bedrock 自动为您创建的服务角色,则在您添加节点时,该角色将更新为具备相应的权限。但如果您使用自定义服务角色,则必须参照在 Amazon Bedrock 中为亚马逊 Bedrock Flows 创建服务角色,将相应权限添加到附加至服务角色的策略。

  4. 将工作流中最后一个节点的输出工作流输出节点的输入连接起来。您可以有多个工作流输出节点。要添加其他工作流输出节点,请将工作流输出节点拖放到您想让工作流停止的节点旁边。确保在两个节点之间绘制连接。

  5. 您可以继续执行下一个程序 在 Amazon Bedrock 中测试流程,也可以稍后再返回。要继续执行下一步,请选择下一步。要稍后再返回,请选择保存并退出

删除节点或连接

在构建工作流的过程中,您可能需要删除节点或移除节点连接。

删除节点
  1. 选择要删除的节点。

  2. Flow Builder 窗格中,选择删除图标 ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. )。

    注意

    如果您使用 Amazon Bedrock 自动为您创建的服务角色,则在您添加节点时,该角色将更新为具备相应的权限。但是,如果您删除节点,相关权限不会被删除。我们建议您按照修改角色中的步骤删除不再需要的权限。

删除连接
  • 工作流生成器页面中,将鼠标悬停在要移除的连接上,直到看到展开图标,然后将连接从节点上拖开。

API

要创建流程,请使用适用于 Amazon Bedrock 的代理构建时终端节点发送CreateFlow请求。

以下字段是必填字段:

字段 Basic description
名称 工作流的名称。
executionRoleArn 具有创建和管理工作流权限的服务角色的 ARN。

以下字段是可选字段:

字段 应用场景
definition 包括构成工作流的 nodesconnections
description 用于描述工作流。
tags 将标签与流相关联。有关更多信息,请参阅 标记 Amazon Bedrock 资源
customerEncryptionKeyArn 使用 KMS 密钥加密资源。有关更多信息,请参阅 Amazon Bedrock Flows 资源的加密
clientToken 用于确保 API 请求仅完成一次。有关更多信息,请参阅确保幂等性

虽然 definition 字段是可选字段,但必须填写该字段才能使工作流正常运行。您可以选择先创建没有定义的工作流,然后再更新工作流。

对于 nodes 列表中的每个节点,您可以在 config 字段中指定节点的类型,并在 type 字段中提供该节点的相应配置。有关不同类型节点的 API 结构的详细信息,请参阅流程中的节点类型

以下要求适用于构建工作流:

  • 您的工作流必须只有一个工作流输入节点和至少一个工作流输出节点。

  • 工作流输入节点不能包含输入。

  • 工作流输出节点不能包含输出。

  • 节点中的每个输出都必须连接到下游节点中的输入(在 API 中,这是通过 a 和 a FlowConnection完成的 FlowDataConnectionConfiguration)。

  • 条件节点中的每个条件(包括默认条件)都必须连接到下游节点(在 API 中,这是通过 a 和 a FlowConnection完成的 FlowConditionalConnectionConfiguration)。

以下提示要求适用于构建工作流:

  • 首先为工作流输入节点的输出设置数据类型。此数据类型应与您在调用工作流时要作为输入发送的数据类型相匹配。

  • 使用表达式定义工作流的输入时,请检查结果是否与您为输入选择的数据类型相匹配。

  • 如果您添加了迭代器节点,则在通过所需节点发送输出后,应在下游添加一个收集器节点。收集器节点将以数组形式返回输出。