本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 BedrockAgentIntent 在 Amazon Lex V2 中使用 Amazon Bedrock 代理程式 V2
**注意**
您必須先滿足下列先決條件，才能利用生成式 AI 功能
如需使用 Amazon Bedrock 定價的相關資訊，請參閱 [Amazon Bedrock 定價](https://aws.amazon.com/bedrock/pricing/)。
開啟機器人地區設定的生成式 AI 功能。若要這樣做，請遵循 中的步驟[使用生成式 AI 最佳化 Lex V2 機器人的建立和效能](generative-features.md)。
您可以利用 Amazon Bedrock Agents 來處理客戶請求的複雜工作負載，而不必進行全面的任務定義程序。Amazon Lex V2 提供可`AMAZON.BedrockAgentIntent`新增至機器人的內建 。此意圖透過識別客戶請求、分析請求、推斷請求和最終回應，利用來自 Amazon Bedrock 的生成式 AI 功能。它還能夠詢問任何後續問題，以實現所需的任務 （例如，您定義的零售代理程式可以檢查客戶訂單狀態的映像。 當客戶要求訂單狀態時，客服人員會先請求`customerId`或關聯`emailId`以擷取詳細資訊，最後以正確的訂單狀態回應）。您也可以決定將您的 AMAZON.BedrockAgentIntent 與 Bedrock 知識庫整合，以直接回答任何客戶查詢。
遵循 AMAZON.BedrockAgentIntent 許可中的步驟，確保您的 IAM 角色具有存取 AMAZON.BedrockAgentIntent 的適當許可
若要利用 AMAZON.BedrockAgentIntent，您必須設定下列其中一個知識存放區。
+ Amazon Bedrock 代理程式 – 如需詳細資訊，請參閱[建立 Bedrock 代理程式](https://docs.aws.amazon.com/bedrock/latest/userguide/agents.html)。
+ Amazon Bedrock 知識庫 – 如需詳細資訊，請參閱[建置知識庫](https://docs.aws.amazon.com/bedrock/latest/userguide/knowledge-base-create.html)。
若要使用 AMAZON.BedrockAgentIntent，請依照 [Lex V2 for Bedrock 代理程式意圖中所需的許可](https://docs.aws.amazon.com/lexv2/latest/dg/bedrock-agent-intent-permissions.html)步驟，確保您的 IAM 角色具有適當的許可。
**Topics**
+ [在生成式 AI 組態畫面中啟用 Bedrock 代理程式意圖](bedrock-agent-intent-genai.md)
+ [將內建意圖新增至您的機器人，以啟用 Bedrock 代理程式意圖](bedrock-agent-intent-level.md)
+ [Lex V2 for Bedrock 代理程式意圖所需的許可](bedrock-agent-intent-permissions.md)
+ [具有工作階段屬性的範例請求](bedrock-agent-intent-sample.md)
# 在生成式 AI 組態畫面中啟用 Bedrock 代理程式意圖
您可以透過導覽至生成式 AI 畫面來啟用 Bedrock 代理程式意圖。
1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/lexv2/home](https://console.aws.amazon.com/lexv2/home)：// 開啟 Amazon Lex V2 主控台。
1. 在**機器人**下的導覽窗格中，選取要用於 Bedrock Agent Intent 的機器人。
1. 選取您要啟用之機器人的語言。
1. 前往畫面上**的生成式 AI 組態**區段，然後選取**設定**。
1. 在 BedrockAgentIntent 組態區段中，選取**建立 BedrockAgent 意圖**。
# 將內建意圖新增至您的機器人，以啟用 Bedrock 代理程式意圖
您可以將內建意圖新增至 Amazon Lex V2 機器人，以啟用 Bedrock 代理程式意圖。
**注意**
您必須先在生成式 AI 面板上啟用 Bedrock 代理程式意圖功能，才能啟用個別機器人的功能。
1. 登入 AWS 管理主控台，並在 https://console.aws.amazon.com/lexv2/home：// 開啟 Amazon Lex V2 主控台。
1. 在**機器人**下的導覽窗格中，選取要用於 Bedrock 代理程式意圖的機器人。
1. 在所有語言下，選取**英文 （美國**) 以展開清單。
1. 選取**新增意圖**，然後從下拉式選單中選擇**使用內建意圖**。
1. 如需 AMAZON.BedrockAgentIntent 組態的詳細資訊，請參閱 [AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md)。
# Lex V2 for Bedrock 代理程式意圖所需的許可
+ 若要在 Amazon Lex V2 主控台上存取此功能，請確定您的主控台角色具有 `bedrock:ListFoundationModels`和 `bedrock:ListInferenceProfiles`許可。
+ 與機器人相關聯的 IAM 角色應具有 所需的許可`AMAZON.BedrockAgentIntent`。
`bedrock:InvokeAgent` 如果使用 Amazon Bedrock 代理程式，`bedrock:InvokeModel`以及`bedrock:RetrieveAndGenerate`如果在意圖中使用 Amazon Bedrock 知識庫，機器人角色應具有呼叫 的許可。您也應該為機器人中指定的每個代理程式附加陳述式 `AMAZON.BedrockAgentIntent`（請參閱以下政策中的存取 Amazon Bedrock 代理程式的許可或存取 Amazon Bedrock 知識庫的許可）。
當您使用 Amazon Lex 主控台啟用此功能時，如果您的機器人使用 Amazon Lex 產生的服務連結角色，政策將自動新增至機器人角色。
# 具有工作階段屬性的範例請求
下列範例示範如何叫用 AMAZON.BedrockAgentIntent，並示範在回應中填入的工作階段和請求屬性。這些屬性包含 Bedrock 代理程式的回應資料，可用於存取代理程式的輸出、Amazon Bedrock 知識庫來源和動作群組調用詳細資訊。
```
{
"sessionId": "user-session-123",
"messages": [{
"content": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"contentType": "PlainText"
}],
"sessionState": {
"sessionAttributes": {
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
},
"intent": {
"name": "BedrockAgentIntent",
"slots": {},
"state": "Fulfilled",
"confirmationState": "None"
},
"dialogAction": {
"type": "ElicitIntent"
}
},
"interpretations": [{
"intent": {
"name": "FallbackIntent",
"slots": {}
},
"interpretationSource": "Lex"
}],
"requestAttributes": {
"x-amz-lex:channels:platform": "Web",
"x-amz-lex:accept-content-types": "PlainText",
"x-amz-lex:bedrock-agent-search-response": "Your order #12345 is currently being processed and will ship within 2-3 business days. You will receive a tracking number via email once it ships.",
"x-amz-lex:bedrock-knowledge-base-search-response-source": "[{\"title\": \"Order Processing Guide\", \"uri\": \"s3://knowledge-base/orders/processing.pdf\", \"excerpt\": \"Standard orders typically ship within 2-3 business days...\"}]",
"x-amz-lex:bedrock-agent-action-group-invocation-input": "{\"actionGroupName\": \"OrderLookup\", \"function\": \"getOrderStatus\", \"parameters\": {\"orderId\": \"12345\", \"customerId\": \"67890\"}}",
"x-amz-lex:bedrock-agent-knowledge-base-lookup-input": "{\"knowledgeBaseId\": \"KB123456\", \"query\": \"order status processing time\", \"numberOfResults\": 3}"
}
}
```
在此範例中，工作階段屬性會顯示 BedrockAgentIntent 如何填入回應資料，包括客服人員的答案、使用的 Amazon Bedrock 知識庫來源、動作群組調用，以及用於產生回應的 Amazon Bedrock 知識庫查詢詳細資訊。
如需詳細資訊，請參閱 [AMAZON.BedrockAgentIntent](https://docs.aws.amazon.com/lexv2/latest/dg/built-in-intent-bedrockagent.html)。