Amazon Bedrock でのコード解釈のテスト

Amazon Bedrock でコードの解釈をテストする前に、エージェントが行った変更を適用する準備をしてください。

コード解釈を有効にすると、エージェントのテストを開始する際に、オプションでファイルを添付し、添付したファイルをコード解釈で使用する方法を選択できます。ユースケースに応じて、添付ファイルの情報を使用してファイルの内容の概要をまとめ、インタラクティブなチャット会話中にファイルの内容に関するクエリに回答するように、コードの解釈を求めることができます。または、添付されたファイル内のコンテンツを分析し、メトリクスとデータ視覚化レポートを提供するようにコードの解釈をリクエストすることもできます。

ファイルを添付する

コード解釈のためにファイルをアタッチする方法については、任意の方法のタブを選択し、ステップに従います。

Console

コード解釈用のファイルをアタッチするには、

1. エージェントビルダーを開いていない場合は、次の操作を行います。

   1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM プリンシパル AWS Management Console を使用して にサインインします。次に、https://console.aws.amazon.com/bedrock/ で Amazon Bedrock コンソールを開きます。

   2. 左側のナビゲーションペインで [エージェント] を選択します。次に、[エージェント] セクションでエージェントを選択します。

   3. [エージェントビルダーで編集] を選択します。

   4. [追加設定] を展開し、[コードインタープリタ] が有効になっていることを確認します。

   5. エージェントの準備が整っていることを確認します。

2. テストウィンドウが開いていない場合は、[テスト] を選択します。

3. テストウィンドウの下部で、ファイルを添付するペーパークリップアイコンを選択します。

4. [ファイルを添付] ページで、

   1. [関数の選択] で、以下を指定します。

      • エージェントがクエリに回答し、コンテンツを要約するために使用するファイルを添付する場合は、[チャットにファイルを添付する (高速)] を選択します。

      • コンテンツを分析してメトリクスを提供するためのコード解釈用のファイルを添付する場合は、[コードインタープリタにファイルを添付する] を選択します。

   2. [アップロード方法の選択] で、ファイルをアップロードする場所を選択します。

      • コンピュータからアップロードする場合は、[ファイルの選択]を選択し、添付するファイルを選択します。

      • Amazon S3 からアップロードする場合は、[S3 の参照] を選択し、ファイルを選択して、[選択]、[追加] と選択します。

5. [アタッチ] を選択してください。

API

コードの解釈をテストするには、Amazon Bedrock エージェントのビルドタイムのエンドポイントを使用して InvokeAgent リクエストを送信します (リクエストとレスポンスの形式およびフィールドの詳細についてはリンクを参照)。

エージェントがクエリに回答し、コンテンツを要約するために使用するファイルを添付するには、次のフィールドを指定します。

フィールド	簡単な説明
名前	添付ファイルの名前。
sourceType	添付ファイルの場所。ファイルが Amazon S3 バケットにある場合、s3 を指定します。ファイルがコンピュータにある場合、byte_content を指定します。
S3Location	ファイルが置かれている S3 パス。sourceType が S3 の場合に必要です。
mediaType	添付ファイルのファイルタイプ。 サポートされている入力ファイルタイプ: CSV、XLS、XLSX、YAML、JSON、DOC、DOCX、HTML、MD、TXT、PDF
データ	Base64 でエンコードされた文字列。最大ファイルサイズは 10MB です。 注記 SDK を使用している場合は、ファイルバイトコンテンツを提供するだけで済みます。 AWS SDK は文字列を base64 に自動的にエンコードします。
useCase	添付ファイルの使用方法。有効な値: CHAT | CODE_INTERPRETER

次の例は、チャット用にファイルを添付するために必要なフィールドを指定するための一般的な形式を示しています。

                  
"sessionState": {
        "promptSessionAttributes": {
            "string": "string"
        },
        "sessionAttributes": {
            "string": "string"
        },
        "files": [ 
            {
                "name": "banking_data", 
                "source": { 
                    "sourceType": "S3", 
                    "s3Location": 
                        "uri": "s3Uri" 
                    }
                },
                "useCase": "CHAT" 
            },
            {
                "name": "housing_stats.csv", 
                "source": { 
                    "sourceType": "BYTE_CONTENT", 
                    "byteContent": {
                        "mediaType": "text/csv", 
                        "data": "file byte content"
                    }
                },
                "useCase": "CHAT"
            }
        ]
    }                 
              

次の例は、コードの解釈用にファイルを添付するために必要なフィールドを指定するための一般的な形式を示しています。

"sessionState": {
        "promptSessionAttributes": {
            "string": "string"
        },
        "sessionAttributes": {
            "string": "string"
        },
        "files": [ 
            {
                "name": "banking_data", 
                "source": { 
                    "sourceType": "S3",
                    "s3Location": {
                        "uri": "s3Uri" 
                    }
                },
                "useCase": "CODE_INTERPRETER" 
            },
            {
                "name": "housing_stats.csv", 
                "source": { 
                    "sourceType": "BYTE_CONTENT", 
                    "byteContent": {
             "mediaType": "text/csv", 
             "data": "file byte content" 
                    }
                },
                "useCase": "CODE_INTERPRETER"
            }
        ]
    }