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

# 使用對話式建置器設定您的代理程式
<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.  AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon Bedrock 主控台。

1. 從左側導覽窗格選取**代理程式**。

1. 在**代理程式**區段中選擇**建立代理程式**。

1. (選用) 變更自動產生的代理程式**名稱**，並提供選用的**描述**。

1. 選擇**建立**。您的代理程式已建立，系統會將您導向至新建立代理程式的**代理程式建置器**，您可以在其中設定代理程式。

1. 您可以繼續執行下列程序來設定您的代理程式，或稍後再返回代理程式建置器。

**設定您的代理程式**

1. 如果您尚未進入代理程式建置器，請執行下列動作：

   1.  AWS 管理主控台 使用具有使用 Amazon Bedrock 主控台之許可的 IAM 身分登入 。接著，開啟位於 [https://console.aws.amazon.com/bedrock](https://console.aws.amazon.com/bedrock) 的 Amazon 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"
    }
  ]
}
```

------