在 Amazon Bedrock 中建立流程 - Amazon Bedrock

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 Amazon Bedrock 中建立流程

若要建立流程，您至少要提供流程的名稱和描述，並指定具有適當許可的服務角色 （或讓 Amazon Bedrock 主控台自動為您建立）。然後，您將透過設定節點來定義流程，這些節點會做為流程中的步驟，以及節點之間的連線。在建立流程之前，建議您先閱讀 Amazon Bedrock 流程的運作方式 ，以熟悉 Amazon Bedrock Flows 中的概念和術語，並了解可用的節點類型。

Amazon Bedrock 會加密靜態資料。根據預設，Amazon Bedrock 會使用 AWS 受管金鑰加密此資料。或者，您可以使用客戶受管金鑰加密流程執行資料。如需詳細資訊，請參閱Amazon Bedrock Flows 資源的加密。

若要了解如何建立流程，請選擇您偏好方法的索引標籤，然後遵循下列步驟：

Console
建立流程

  1. AWS Management Console 使用具有 Amazon Bedrock 許可的 IAM 角色登入 ，並在 入門 AWS Management Console中開啟 Amazon Bedrock 主控台。

  2. 從左側導覽窗格中選取 Amazon Bedrock Flows。

  3. 在 Amazon Bedrock 流程區段中，選擇建立流程。

  4. 輸入流程的名稱和選用的描述。

  5. 針對服務角色名稱，選擇下列其中一個選項：

  6. （選用） 若要使用 KMS 金鑰加密流程，請選取自訂加密設定 （進階），然後選擇金鑰。如需詳細資訊，請參閱Amazon Bedrock Flows 資源的加密。

  7. 選擇 Create (建立)。您的流程已建立，並將帶您前往流程建置器，您可以在其中建置流程。

  8. 您可以繼續下列程序來建置流程，或稍後再返回流程建置器。

建置您的流程

  1. 如果您尚未在流程建置器中，請執行下列動作：

    1. AWS Management Console 使用具有 Amazon Bedrock 許可的 IAM 角色登入 ，並在 入門 AWS Management Console中開啟 Amazon Bedrock 主控台。

    2. 從左側導覽窗格中選取 Amazon Bedrock Flows。然後，在 Amazon Bedrock 流程區段中選擇流程。

    3. 選擇流程建置器中的編輯。

  2. 在流程建置器區段中，中央窗格會顯示流程輸入節點和流程輸出節點。這些是您流程的輸入和輸出節點。

  3. 新增和設定節點

    1. 在流程建置器窗格中，選取節點。

    2. 拖曳您要用於流程第一個步驟的節點，並將其放入中央窗格中。

    3. 節點上的圓圈是連線點。若要將流程輸入節點連接到第二個節點，請將流程輸入節點上的圓圈一行拖曳到您剛新增之節點的輸入區段中的圓圈。

    4. 選取您剛新增的節點。

    5. 在流程建置器窗格的設定區段中，提供所選節點的組態，並定義節點輸入和輸出的名稱、資料類型和表達式。

    6. 在流程建置器窗格中，選取節點。

    7. 重複步驟來新增和設定節點，流程中剩餘的節點。

      注意

      如果您使用 Amazon Bedrock 自動為您建立的服務角色，該角色會在您新增節點時以適當的許可進行更新。不過，如果您使用自訂服務角色，則必須參閱 ，將適當的許可新增至附加至服務角色的政策在 Amazon Bedrock 中為 Amazon Bedrock 流程建立服務角色。

  4. 將流程中最後一個節點的輸出與流程輸出節點的輸入連接。您可以擁有多個流程輸出節點。若要新增其他流程輸出節點，請將流程輸出節點拖放到您希望流程停止的節點旁。請務必在兩個節點之間繪製連線。

  5. 您可以繼續進行下一個程序，在 Amazon Bedrock 中測試流程或稍後再進行。若要繼續下一個步驟，請選擇儲存。若要稍後再回來，請選擇儲存並結束。

刪除節點或連線

在建置流程的過程中，您可能需要刪除節點或移除節點連線。

刪除節點

  1. 選取您要刪除的節點。

  2. 在流程建置器窗格中，選擇刪除圖示 ( Trapezoid-shaped diagram showing data flow from source to destination through AWS Transfer Family. )。

    注意

    如果您使用 Amazon Bedrock 自動為您建立的服務角色，該角色會在您新增節點時以適當的許可進行更新。不過，如果您刪除節點，則不會刪除相關許可。建議您依照修改角色的步驟刪除不再需要的許可。

移除連線

  • 在流程建置器頁面中，將滑鼠暫留在您想要移除的連線上，直到您看到展開圖示，然後將連線從節點拖曳出。

API

若要建立流程，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateFlow 請求。

下列是必要欄位：

欄位 基本描述
name 流程的名稱。
executionRoleArn 具有建立和管理流程許可的服務角色 ARN。

下列欄位為選用：

欄位 使用案例
定義 包含connections構成流程的 nodes和 。
description 描述流程。
標籤 將標籤與流程建立關聯。如需詳細資訊，請參閱標記 Amazon Bedrock 資源。
customerEncryptionKeyArn 使用 KMS 金鑰加密資源。如需詳細資訊，請參閱Amazon Bedrock Flows 資源的加密。
clientToken 為確保 API 請求僅完成一次。如需詳細資訊，請參閱確保等冪。

雖然 definition 欄位是選用的，但流程需要正常運作。您可以選擇先建立沒有定義的流程，稍後再更新流程。

對於nodes清單中的每個節點，您可以在 type 欄位中指定節點的類型，並在 config 欄位中提供節點的對應組態。如需不同節點類型 API 結構的詳細資訊，請參閱流程中的節點類型。

下列需求適用於建置流程：

  • 您的流程必須只有一個流程輸入節點和至少一個流程輸出節點。

  • 您無法包含流程輸入節點的輸入。

  • 您無法包含流程輸出節點的輸出。

  • 節點中的每個輸出都必須連接到下游節點中的輸入 （在 API 中，這是透過使用 FlowConnection FlowDataConnectionConfiguration完成）。

  • 條件節點中的每個條件 （包括預設條件） 都必須連接到下游節點 （在 API 中，透過 FlowConnection 與 FlowConditionalConnectionConfiguration 來完成此操作）。

下列指標適用於建置流程：

  • 首先設定流量輸入節點輸出的資料類型。此資料類型應符合您預期在叫用流程時作為輸入傳送的內容。

  • 當您使用表達式定義流程的輸入時，請檢查結果是否符合您為輸入選擇的資料類型。

  • 如果您包含迭代器節點，請在透過您需要的節點傳送輸出之後，在下游包含收集器節點。收集器節點將傳回陣列中的輸出。