翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # コード解釈を有効にして、アプリケーションのコードを生成、実行、テストする コード解釈により、エージェントは安全なテスト環境でアプリケーションコードを生成、実行、トラブルシューティングできます。コード解釈を使用すると、生成 AI アプリケーションの構築に集中しながら、エージェントの基盤モデルを使って基本的な機能を実装するためのコードを生成できます。 Amazon Bedrock でコード解釈を使用すると、次のタスクを実行できます。 + 特定のタスクに対するユーザーリクエストを理解し、ユーザーによってリクエストされたタスクを実行できるコードを生成、実行して、コード実行の結果を提供する。 + ユーザーの一般的な問い合せを理解し、コードを生成、実行して、ユーザーにレスポンスを提供する。 + データの分析、視覚化、評価を実行するためのコードを生成する。 + ユーザーによってアップロードされたファイルから情報を抽出し、情報を処理して、ユーザーの問い合せに応答する。 + 迅速なプロトタイプ作成のために、ユーザーとのインタラクティブな会話に基づいてコードを生成する。 デフォルトでは、AWS アカウント 1 つにつき 1 セッションで同時にアクティブなコード解釈の最大数は 25 です。つまり、各 AWS アカウントは、コードインタープリタを使用してエージェントとの会話を一度に 25 件まで継続することができます。 以下は、Amazon Bedrock 内でコードを生成して実行することでコード解釈が役立つユースケースの一部です。 1. .csv などのデータファイルから財務トランザクションを分析し、利益または損失の発生を判断する。 1. *2020 年 3 月 14 日*のような日付形式を .txt や .csv などのファイル形式の標準 API 形式 (`YYYY-MM-DD`) に変換する。 1. スプレッドシート (XLS) でデータ分析を実行して、四半期/年間の企業収益や人口増加率などのメトリクスを計算する。 Amazon Bedrock でコード解釈を使用するには、次の手順を実行します。 + エージェントを構築するときにコード解釈を有効にします。コード解釈を有効にしたら、使用を開始できます。 + プロンプトを指定して Amazon Bedrock でコード解釈の使用を開始します。例えば、「円周率の平方根を 127 桁まで計算して」という質問をします。レスポンスを提供するためにコード解釈機能が Python コードを生成して実行します。 + ファイルを添付することもできます。ファイル内の情報を使用して、質問をしたり、データを要約または分析したりできます。ファイルは、コンピュータまたは Amazon S3 バケットから添付できます。 **サポート対象のリージョン** Amazon Bedrock エージェントのコード解釈は、次のリージョンでサポートされています。 **** | リージョン | | --- | | 米国東部 (バージニア北部) | | 米国西部 (オレゴン） | | 欧州 (フランクフルト) | **ファイルのサポート** コード解釈では、ファイルを添付してそのファイルを使って質問したり、添付されたファイルの内容に基づいてデータを要約または分析したりできます。 最大 5 つのファイルを添付できます。すべてのファイルの合計サイズは最大 10 MB です。 + **サポートされている入力ファイルタイプ**: CSV、XLS、XLSX、YAML、JSON、DOC、DOCX、HTML、MD、TXT、PDF + **サポートされている出力ファイルタイプ**: CSV、XLS、XLSX、YAML、JSON、DOC、DOCX、HTML、MD、TXT、PDF、PNG # Amazon Bedrock でコード解釈を有効にする エージェントを[作成](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html)または[更新](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit)するときに、Amazon Bedrock コンソールでコード解釈を有効にできます。API または SDK を使用する場合は、アクショングループを[作成](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)または[更新](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)するときにコード解釈を有効にできます。 Amazon Bedrock でコード解釈を有効にする方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **エージェントのコード解釈を有効にするには** 1. エージェントビルダーを開いていない場合は、次を実行します。 1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS マネジメントコンソールを使用して にサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[その他の設定]** セクションを展開します。 1. **[コードインタープリタ]** で、**[有効にする]** を選択します。 1. テストする前に、必ず **[保存]**、**[準備]** の順に選択して、エージェントに加えた変更を適用します。 ------ #### [ API ] エージェントのコード解釈を有効にするには、[Amazon Bedrock エージェントのビルドタイムのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) リクエストを送信し (リクエストとレスポンスの形式およびフィールドの詳細についてはリンクを参照)、次のフィールドを指定します。 **** | フィールド | 簡単な説明 | | --- | --- | | actionGroupName | アクショングループの名前 | | parentActionGroupSignature | AMAZON.CodeInterpreter を指定して、エージェントがコードを生成してテストできるようにします。 | | actionGroupState | ENABLED を指定して、エージェントがコード解釈を呼び出せるようにします。 | 以下は、[CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) リクエストでコード解釈を有効にするときに必要なフィールドの一般的な形式を示しています。 ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Amazon Bedrock でのコード解釈のテスト Amazon Bedrock でコードの解釈をテストする前に、エージェントが行った変更を適用する準備をしてください。 コード解釈を有効にすると、エージェントのテストを開始する際に、オプションでファイルを添付し、添付したファイルをコード解釈で使用する方法を選択できます。ユースケースに応じて、添付ファイルの情報を使用してファイルの内容の概要をまとめ、インタラクティブなチャット会話中にファイルの内容に関するクエリに回答するように、コードの解釈を求めることができます。または、添付されたファイル内のコンテンツを分析し、メトリクスとデータ視覚化レポートを提供するようにコードの解釈をリクエストすることもできます。 **ファイルを添付する** コード解釈のためにファイルを添付する方法については、希望する方法のタブを選択し、手順に従ってください。 ------ #### [ Console ] **コード解釈用のファイルをアタッチするには、** 1. エージェントビルダーを開いていない場合は、次を実行します。 1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS マネジメントコンソール を使用して にサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[追加設定]** を展開し、**[コードインタープリタ]** が有効になっていることを確認します。 1. エージェントの準備が整っていることを確認します。 1. テストウィンドウが開いていない場合は、**[テスト]** を選択します。 1. テストウィンドウの下部で、ファイルを添付するペーパークリップアイコンを選択します。 1. **[ファイルを添付]** ページで、 1. ****[関数の選択]** で、以下を指定します。** + エージェントがクエリに回答し、コンテンツを要約するために使用するファイルを添付する場合は、**[チャットにファイルを添付する (高速)]** を選択します。 + コンテンツを分析してメトリクスを提供するためのコード解釈用のファイルを添付する場合は、**[コードインタープリタにファイルを添付する]** を選択します。 1. ****[アップロード方法の選択]** で、ファイルをアップロードする場所を選択します。** + コンピュータからアップロードする場合は、**[ファイルの選択]**を選択し、添付するファイルを選択します。 + Amazon S3 からアップロードする場合は、**[S3 の参照]** を選択し、ファイルを選択して、**[選択]**、**[追加]** と選択します。 1. [**アタッチ**] を選択してください。 ------ #### [ API ] コードの解釈をテストするには、[Amazon Bedrock エージェントのビルドタイムのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html) リクエストを送信します (リクエストとレスポンスの形式およびフィールドの詳細についてはリンクを参照)。 **エージェントがクエリに回答し、コンテンツを要約するために使用するファイルを添付するには、次のフィールドを指定します。** **** | フィールド | 簡単な説明 | | --- | --- | | 名前 | 添付ファイルの名前。 | | sourceType | 添付ファイルの場所。ファイルが Amazon S3 バケットにある場合、s3 を指定します。ファイルがコンピュータにある場合、byte\$1content を指定します。 | | S3Location | ファイルが置かれている S3 パス。sourceType が S3 の場合に必要です。 | | mediaType | 添付ファイルのファイルタイプ。 **サポートされている入力ファイルタイプ**: CSV、XLS、XLSX、YAML、JSON、DOC、DOCX、HTML、MD、TXT、PDF | | data | Base64 でエンコードされた文字列。最大ファイルサイズは 10MB です。SDK を使用している場合は、ファイルバイトコンテンツを提供するだけで済みます。 AWS SDK は文字列を base64 に自動的にエンコードします。 | | useCase | 添付ファイルの使用方法。有効な値: CHAT \$1 CODE\$1INTERPRETER | 次の例は、チャット用にファイルを添付するために必要なフィールドを指定するための一般的な形式を示しています。 ``` "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" } ] } ``` ------ # Amazon Bedrock でコード解釈を無効にする Amazon Bedrock では、コード解釈をいつでも無効にできます。 コード解釈を無効にする方法については、使用する方法に対応するタブを選択して、手順に従ってください。 ------ #### [ Console ] **コード解釈を無効にするには** 1. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS マネジメントコンソール を使用して にサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。 1. 左側のナビゲーションペインで **[エージェント]** を選択します。次に、**[エージェント]** セクションでエージェントを選択します。 1. **[エージェントビルダーで編集]** を選択します。 1. **[その他の設定]** セクションを展開し、**[コードインタープリタ]** で **[無効にする]** を選択します。 1. ページの上部で、**[準備]** を選択します。次に、**[保存]** を選択して変更をエージェントに保存します。 ------ #### [ API ] コード解釈を無効にするには、[Amazon Bedrock エージェントのビルドタイムのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) リクエストを送信し (リクエストとレスポンスの形式およびフィールドの詳細についてはリンクを参照)、次のフィールドを指定します。 **** | フィールド | 簡単な説明 | | --- | --- | | actionGroupName | アクショングループの名前 | | parentActionGroupSignature | コードインタープリタを無効にするには、AMAZON.CodeInterpreter を指定します。 | | actionGroupState | コードインタープリタを無効にするには、DISABLED を指定します。 | 次の例は、コード解釈を無効にするときに必要なフィールドを指定するための一般的な形式を示しています。 ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ エージェントのコード解釈を無効にしたら、必ず [Amazon Bedrock エージェントのビルドタイムのエンドポイント](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)を使用して [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html) リクエストを送信します (リクエストとレスポンスの形式およびフィールドの詳細についてはリンクを参照)。