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

# 対話型ビルダーを使用してエージェントを設定する
<a name="agents-create-cb"></a>

対話型ビルダーは、エージェントの設定に役立つインタラクティブアシスタントです。対話型ビルダーでは、自然言語を使用してエージェントの目的を説明します。これにより、目的を満たす完全にテスト可能なエージェントを構築できます。対話型ビルダーは、お客様とやり取りして、エージェントを構築または更新するために必要なすべての情報を取得します。

**重要**  
対話型ビルダーは、米国東部 (バージニア北部)、米国西部 (オレゴン)、欧州 (フランクフルト)、アジアパシフィック (シドニー)、欧州 (パリ) リージョンの Amazon Bedrock コンソールで使用できます。

対話型ビルダーは、インタラクションに基づいて以下のアクション*のみ*を実行します。
+ エージェントの名前と説明を更新する
+ 自然言語で指定した指示に基づいて、エージェントの指示の概要を生成する
+ 新しいアクショングループを作成する 
+ アクショングループの名前と説明を更新する
+ アクショングループの概要に基づいてアクショングループの関数を定義する
+ ナレッジベースの関連付け、一覧表示、関連付け解除を行う
+ アクショングループを一覧表示または削除する

以下は、対話型ビルダーとのやり取りの例です。

```
Conversational builder: Hello, I can help you update your Agent's configurations.

What configurations would you like to update?
You can say something like "Associate a knowledge base"

User: Create a travel agent
Conversational builder:  What is the purpose of this travel agent? What kind of tasks or capabilities should it have?
User: Travel agent books flights and hotels for vacation
Conversational builder: The travel agent with the purpose of booking flights and hotels for vacations has been successfully created.
```

## Amazon Bedrock コンソールで対話型ビルダーを使用してエージェントを作成および設定する
<a name="create-configure-cb"></a>

**エージェントを作成するには**

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. Amazon Bedrock コンソールを使用するアクセス許可を持つ IAM ID AWS マネジメントコンソール を使用して にサインインします。Amazon Bedrock コンソール ([https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock)) を開きます。

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

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

1. エージェントビルダーで、**[アシスタント]** を選択します。

1. エージェントビルダーペインに、エージェントの目的を入力します。インタラクションの例を参照して、対話型ビルダーアシスタントとのやり取りを開始します。

1. 対話型ビルダーでエージェントの設定が完了したら、次のいずれかのオプションを選択します。
   + **[エージェントビルダー]** から移動しない場合は、**[保存]** を選択します。そのまま、エージェントを**準備**して、更新された設定をテストウィンドウでテストできます。エージェントをテストする方法については、「[エージェントの動作テストとトラブルシューティング](agents-test.md)」を参照してください。
   + **[エージェントの詳細]** ページに戻る場合は、**[保存して終了]** を選択します。

## Amazon Bedrock コンソールで対話型ビルダーを使用するために次のアクセス許可を追加する
<a name="permissions-cb"></a>

[対話型ビルダーを使用してエージェントを設定する](#agents-create-cb)ことを予定している場合は、必ず次のアクセス許可をアタッチしてください。

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Sid": "InvokeInlineAgent",
      "Effect": "Allow",
      "Action": "bedrock:InvokeInlineAgent",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "bedrock:InlineAgentName": "AgentName-123"
        }
      }
    },
    {
      "Sid": "InvokeFoundationModel",
      "Effect": "Allow",
      "Action": "bedrock:InvokeModel",
      "Resource": "arn:aws:bedrock:us-east-1::foundation-model/{modelId}"
    },
    {
      "Sid": "S3AccessForKBAndActions",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject"
      ],
      "Resource": "arn:aws:s3:::bucket-name/*"
    },
    {
      "Sid": "S3AccessForCodeInterpreter",
      "Effect": "Allow",
      "Action": [
        "s3:GetObjectVersion",
        "s3:GetObjectVersionAttributes",
        "s3:GetObjectAttributes"
      ],
      "Resource": "arn:aws:s3:::bucket/path/to/file"
    },
    {
      "Sid": "KnowledgeBaseAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:Retrieve",
        "bedrock:RetrieveAndGenerate"
      ],
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:knowledge-base/knowledge-base-id"
    },
    {
      "Sid": "GuardrailAccess",
      "Effect": "Allow",
      "Action": "bedrock:ApplyGuardrail",
      "Resource": "arn:aws:bedrock:us-east-1:123456789012:guardrail/guardrail-id"
    },
    {
      "Sid": "LambdaInvoke",
      "Effect": "Allow",
      "Action": "lambda:InvokeFunction",
      "Resource": "arn:aws:lambda:us-east-1:123456789012:function:function-name"
    },
    {
      "Sid": "KMSAccess",
      "Effect": "Allow",
      "Action": [
        "kms:GenerateDataKey*",
        "kms:Decrypt"
      ],
      "Resource": "arn:aws:kms:us-east-1:123456789012:key/key-id"
    }
  ]
}
```

------