Step Functions を使用して Amazon Bedrock を呼び出す - AWS Step Functions

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Step Functions を使用して Amazon Bedrock を呼び出す

Step Functions AWS は特定のサービスを Amazon ステートメント言語 (ASL) から直接制御できます。詳細については、「他の サービスでの使用」および「サービス API にパラメータを渡す」を参照してください。

Amazon Bedrock サービス統合 API

AWS Step Functions を Amazon Bedrock と統合するために、以下の API を使用できます。これらの API は、対応する Amazon Bedrock API に似ていますが、渡されるリクエストにいくつかの違いがあります。

各サービス統合 API と対応する Amazon Bedrock API の違いを次の表に示します。

Amazon Bedrock サービス統合 API と、対応する Amazon Bedrock API
Amazon Bedrock サービス統合 API 対応する Amazon Bedrock API 差異

InvokeModel

リクエスト本文に指定された入力を使って推論を実行するために、指定された Amazon Bedrock モデルを呼び出します。テキストモデル、画像モデル、埋め込みモデルの推論を実行するために、InvokeModel を使用します。

InvokeModel

Amazon Bedrock サービス統合 API のリクエスト本文には、以下の追加パラメータが含まれます。

  • Body — コンテンツタイプのリクエストヘッダーで指定された形式で入力データを指定します。Body には、ターゲットモデル固有のパラメータが含まれます。

    InvokeModel API を使用する場合は、Body パラメータを指定する必要があります。Step Functions では、Body で入力した内容は検証されません。

    最適化された Amazon Bedrock 統合を使用して Body を指定する場合、最大 256 KB のペイロードを指定できます。ペイロードが 256 KB を超える場合は、Input を使用することをお勧めします。

  • Input — 入力データを取得するソースを指定します。このオプションフィールドは、Step Functions に最適化された Amazon Bedrock 統合に固有のものです。このフィールドでは、S3Uri を指定できます。

    パラメータ または InputBody を指定できますが、両方に指定することはできません。

    ContentType を指定せずに Input を指定すると、入力データソースのコンテンツタイプが ContentType の値になります。

  • Output — API レスポンスの記述先を指定します。このオプションフィールドは、Step Functions に最適化された Amazon Bedrock 統合に固有のものです。このフィールドでは、S3Uri を指定できます。

    このフィールドを指定すると、API レスポンス本文は元の出力の Amazon S3 ロケーションへの参照に置き換えられます。

次の例は、Amazon Bedrock統合用 InvokeModel API の構文を示しています。

{ "ModelId": String, // required "Accept": String, // default: application/json "ContentType": String, // default: application/json "Input": { // not from Bedrock API "S3Uri": String }, "Output": { // not from Bedrock API "S3Uri": String } }

CreateModelCustomizationJob

ベースモデルをカスタマイズするためのファインチューニングジョブを作成します。

CreateModelCustomizationJob なし

CreateModelCustomizationJob.sync

ベースモデルをカスタマイズするためのファインチューニングジョブを作成します。

CreateModelCustomizationJob なし

IAMStep Functions AWS 他のサービスと併用する場合の権限の設定方法については、を参照してください統合サービスの IAM ポリシー

Amazon Bedrock 統合のタスクステート定義

以下のタスクステート定義は、ステートマシンで Amazon Bedrock とどのように統合できるかを示しています。この例は、パス (result_one) で指定されたモデル呼び出しの結果をすべて抽出するタスクステートを示しています。これは基盤モデルの推論パラメータに基づいています。この例では、Cohere Command 大規模言語モデル (LLM) を使用しています。

{ "Type": "Task", "Resource": "arn:aws:states:::bedrock:invokeModel", "Parameters": { "ModelId": "cohere.command-text-v14", "Body": { "prompt.$": "$.prompt_one", "max_tokens": 250 }, "ContentType": "application/json", "Accept": "*/*" }, "ResultPath": "$.result_one", "ResultSelector": { "result_one.$": "$.Body.generations[0].text" }, "End": true }
ヒント

Amazon Bedrockと統合するステートマシンの例をにデプロイするには AWS アカウント、を参照してくださいAmazon Bedrock で AI プロンプトチェーンを実行する