사전 조건

참고

인라인 에이전트 기능 구성 및 간접 호출은 Amazon Bedrock의 미리 보기 릴리스에 있으며 변경될 수 있습니다.

인라인 에이전트를 간접적으로 호출하기 전에 다음 사전 조건을 완료합니다.

1. 인라인 에이전트를 구성하는 데 사용할 파운데이션 모델, 에이전트를 호출할 리전, 인라인 에이전트에게 수행해야 할 작업을 알려주는 지침을 결정합니다.

2. 인라인 에이전트에 사용할 다음 Amazon Bedrock 에이전트 속성을 하나 이상 생성하거나 준비합니다.

   필드	사용 사례
   actionGroups	인라인 에이전트가 수행할 수 있는 작업을 정의하는 각 작업 그룹이 있는 작업 그룹 목록을 제공합니다. 예를 들어 사용자가 CreateAppointment, GetAppointment, CancelAppointment 등과 같은 작업을 수행하는 데 도움이 되는 작업 그룹 예약을 정의할 수 있습니다
   guardrailConfiguration	주제를 차단하고, 할루시네이션을 방지하고, 애플리케이션에 대한 보호 기능을 구현하도록 가드레일을 구성합니다.
   knowledgeBases	knowledgeBases를 인라인 에이전트와 연결하여 모델에서 생성된 응답을 강화합니다. 지식 기반은 사용자 쿼리에 응답하고 문서를 분석하는 데 사용할 수 있을 뿐만 아니라 프롬프트에 컨텍스트를 제공하여 파운데이션 모델에 제공되는 프롬프트를 강화하는 데에도 사용할 수 있습니다.
   promptOverridenConfiguration	인라인 에이전트의 정확도를 높이려면 에이전트 시퀀스의 여러 부분에서 재정의 프롬프트를 구성합니다.
   customerEncryptionArn	인라인 에이전트를 암호화하는 데 사용할 AWS KMS 키의 Amazon 리소스 이름(ARN)을 지정합니다.

3. AWS Identity and Access Management(IAM) 역할을 생성하고 이 단계에서 언급한 정책을 역할에 연결합니다.

   인라인 에이전트를 호출하려면 먼저 InvokeInlineAgent API를 사용하고 Lambda 함수, 지식 기반 및 파운데이션 모델과 같은 리소스에 액세스하는 데 필요한 권한을 제공하는 IAM 역할을 생성해야 합니다.

   인라인 에이전트용 사용자 지정 서비스 역할을 생성하려면 IAM 사용자에게 권한을 위임할 역할 생성의 절차를 따릅니다. IAM 정책을 생성한 후 역할에 다음 정책을 연결할 수 있습니다.

   참고

   보안 목적을 위한 모범 사례로, ${region}, ${account-id} 및 *.ids를 생성한 후 리전, 계정 ID 및 특정 리소스 ID로 바꾸는 것이 가장 좋습니다.