기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Lex V2에서 BedrockAgentIntent를 사용하여 Amazon Bedrock 에이전트 사용
**참고**
생성형 AI 기능을 활용하려면 먼저 다음 사전 조건을 충족해야 합니다.
Amazon Bedrock 사용 요금에 대한 자세한 내용은 [Amazon Bedrock 요금](https://aws.amazon.com/bedrock/pricing/)을 참조하세요.
봇 로캘에 맞는 생성형 AI 기능을 켭니다. 이렇게 하려면 [생성형 AI를 사용하여 Lex V2 봇 생성 및 성능 최적화](generative-features.md) 단원의 절차를 따르세요.
Amazon Bedrock 에이전트를 활용하여 포괄적인 작업 정의 프로세스를 거치지 않고도 고객이 요청한 복잡한 워크로드를 처리할 수 있습니다. Amazon Lex V2는 봇에 추가할 수 있는 `AMAZON.BedrockAgentIntent`를 기본 제공합니다. 이 의도는 고객 요청을 인식하고, 분석하고, 추론하고, 마지막으로 대응하여 Amazon Bedrock의 생성형 AI 기능을 활용합니다. 또한 필요한 작업을 달성하기 위해 후속 질문을 할 수 있는 기능도 있습니다(예: 고객의 주문 상태를 확인할 수 있는 소매 에이전트가 정의된 상황을 가정해 보겠습니다. 고객이 주문 상태를 요청하면 에이전트는 먼저 `customerId` 또는 `emailId`를 연결하여 세부 정보를 검색하고 마지막으로 올바른 주문 상태로 응답합니다). AMAZON.BedrockAgentIntent를 Bedrock 지식 기반과 통합하여 고객 쿼리에 직접 답변하도록 결정할 수도 있습니다.
AMAZON.BedrockAgentIntent에 대한 권한의 단계에 따라 IAM 역할에 AMAZON.BedrockAgentIntent에 액세스할 수 있는 적절한 권한이 있는지 확인합니다.
AMAZON.BedrockAgentIntent를 활용하려면 다음 지식 스토어 중 하나를 설정해야 합니다.
+ Amazon Bedrock 에이전트 – 자세한 내용은 [Amazon 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를 사용하려면 [Bedrock 에이전트 의도에 대해 Lex V2에 필요한 권한](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)
+ [Bedrock 에이전트 의도에 대해 Lex V2에 필요한 권한](bedrock-agent-intent-permissions.md)
+ [세션 속성이 있는 샘플 요청](bedrock-agent-intent-sample.md)
# 생성형 AI 구성 화면에서 Bedrock 에이전트 의도 활성화
생성형 AI 화면으로 이동하여 Bedrock 에이전트 의도를 활성화할 수 있습니다.
1. AWS Management Console에 로그인하고 [https://console.aws.amazon.com/lexv2/home](https://console.aws.amazon.com/lexv2/home) Amazon Lex V2 콘솔을 엽니다.
1. 탐색 창의 **봇**에서 Bedrock 에이전트 의도에 사용할 봇을 선택합니다.
1. 활성화하려는 봇의 언어를 선택합니다.
1. 화면의 **생성형 AI 구성** 섹션으로 이동한 뒤 **구성**을 선택합니다.
1. BedrockAgentIntent 구성 섹션에서 **BedrockAgent 의도 생성**을 선택합니다.
# 봇에 기본 제공 의도를 추가하여 Bedrock 에이전트 의도 활성화
Amazon Lex V2 봇에 기본 제공 의도를 추가하여 Bedrock 에이전트 의도를 활성화할 수 있습니다.
**참고**
봇별로 이 기능을 활성화하려면 먼저 생성형 AI 패널에서 Bedrock 에이전트 의도 기능을 활성화해야 합니다.
1. AWS Management Console에 로그인하여 https://console.aws.amazon.com/lexv2/home에서 Amazon Lex V2 콘솔을 엽니다.
1. 탐색 창의 **봇**에서 Bedrock 에이전트 의도에 사용할 봇을 선택합니다.
1. 모든 언어에서 **영어(미국)**를 선택하여 목록을 확장합니다.
1. **의도 추가**를 선택하고 드롭다운 메뉴에서 **기본 제공 의도 사용**을 선택합니다.
1. AMAZON.BedrockAgentIntent의 구성에 대한 자세한 내용은 [AMAZON.BedrockAgentIntent](built-in-intent-bedrockagent.md) 섹션을 참조하세요.
# Bedrock 에이전트 의도에 대해 Lex V2에 필요한 권한
+ Amazon Lex V2 콘솔에서 이 기능에 액세스하려면 콘솔 역할에 `bedrock:ListFoundationModels` 및 `bedrock:ListInferenceProfiles` 권한이 있는지 확인하세요.
+ 봇과 연결된 IAM 역할에는 `AMAZON.BedrockAgentIntent`에 다음 권한이 있어야 합니다.
봇 역할에는 Amazon Bedrock 에이전트를 사용하는 경우 `bedrock:InvokeAgent`를 직접 호출하고 의도에서 Amazon Bedrock 지식 기반을 사용하는 경우 `bedrock:InvokeModel` 및 `bedrock:RetrieveAndGenerate`를 직접 호출할 수 있는 권한이 있어야 합니다. 또한 봇의 `AMAZON.BedrockAgentIntent`에 지정하는 각 에이전트에 대한 문을 연결해야 합니다(아래 정책의 Amazon Bedrock 에이전트에 액세스할 수 있는 권한 또는 Amazon Bedrock 지식 기반에 액세스할 수 있는 권한 문 참조).
Amazon Lex 콘솔에서 이 기능을 활성화하면 봇이 Amazon Lex에서 생성한 서비스 연결 역할을 사용하는 경우 정책이 봇 역할에 자동으로 추가됩니다.
# 세션 속성이 있는 샘플 요청
다음 예제에서는 AMAZON.BedrockAgentIntent를 간접 호출하는 방법과 응답에 채워진 세션 및 요청 속성을 보여줍니다. 이러한 속성에는 Bedrock Agent의 응답 데이터가 포함되며 에이전트의 출력, 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) 섹션을 참조하세요.