Articleaws.amazon.com·2026년 11월 16일·0

Customize answers per tenant in Amazon Bedrock Managed Knowledge Base

Quick Summary

Amazon Bedrock Managed Knowledge Base의 retrieval instructions는 테넌트별 응답 방식과 정책을 버전으로 관리하며, 데이터 접근 범위는 메타데이터 필터나 별도 지식 기반으로 통제해야 한다.

Customize answers per tenant in Amazon Bedrock Managed Knowledge Base 관련 대표 이미지

🖼️ 인포그래픽

Customize answers per tenant in Amazon Bedrock Managed Knowledge Base 내용을 설명하는 본문 이미지

🖼️ 4컷 인포그래픽

Customize answers per tenant in Amazon Bedrock Managed Knowledge Base의 핵심 내용을 4단계로 요약한 인포그래픽
Customize answers per tenant in Amazon Bedrock Managed Knowledge Base 핵심 내용을 4단계로 압축한 4컷 인포그래픽

💡 한 줄 요약

Amazon Bedrock Managed Knowledge Base의 retrieval instructions는 테넌트별 응답 방식과 정책을 버전으로 관리하며, 데이터 접근 범위는 메타데이터 필터나 별도 지식 기반으로 통제해야 한다.

📌 핵심 요약

  • retrieval instructions는 말투, 출력 형식, 검색 지침, 응답 정책을 관리형 Amazon Bedrock 리소스로 정의한다. 기존에는 일정한 응답 스타일이나 구조화된 출력을 위해 응답 생성을 끄고 애플리케이션마다 별도의 모델 호출과 프롬프트를 관리해야 했다.
  • 가상의 AnyCompany Smart Home 사례는 판매 지역 3곳과 내부 팀 3개를 총 6개 테넌트로 구분한다. Sales Region Central에는 스페인어와 일/월/년 날짜 형식을 적용하며, 지역이 명시된 반품 질문에는 배송일로부터 45일이라는 답과 출처를 제시한다. 단일 요청에서 최대 5개 지식 기반을 검색할 수 있다.
  • 지침은 persona, answerFormat, retrievalGuidance, answerPolicy의 네 필드로 구성된다. persona, answerFormat, answerPolicy는 기본값이 true인 generateResponse가 true일 때만 적용되고, retrievalGuidance는 응답 생성 여부와 관계없이 적용된다.
  • 지침은 AWS 계정과 AWS 리전에 속하며 비동기 검토를 통과하면 ACTIVE가 된다. 번호가 붙은 버전은 불변이고, 요청에서 버전을 생략하면 DRAFT가 적용된다. 첫 Planning 추적 이벤트의 appliedInstruction에서 적용된 지침을 확인할 수 있다.
  • retrieval instructions는 권한이나 데이터 격리 경계가 아니다. 백엔드는 인증된 테넌트에 따라 지침 버전과 메타데이터 필터를 선택하고 요청에 테넌트 정보를 추가한다. 예제는 32개 문서, region·audience_team·sensitivity 메타데이터, 테넌트별 버전 1을 사용하며, 제한된 엔지니어링 문서 2개는 어떤 테넌트의 필터로도 반환되면 안 된다.

🧩 주요 포인트

  1. 응답 제어와 접근 제어의 역할 분리: retrieval instructions는 표현과 정책 적용을 담당하고, 메타데이터 필터나 별도 지식 기반은 검색 가능한 문서 범위를 제한하므로 두 구성을 함께 선택해야 한다.
  2. 버전 고정과 추적의 결합: 불변 번호 버전으로 애플리케이션별 전환 시점을 조정하고 appliedInstruction으로 실제 적용 지침을 확인할 수 있어, DRAFT 기본 적용과 명시적 버전 선택의 차이가 운영에 중요하다.
  3. 검색 단계와 생성 단계의 적용 범위 구분: retrievalGuidance는 항상 작동하지만 나머지 세 필드는 generateResponse가 true일 때만 적용되므로, 응답 생성을 끈 구성에서는 출력 형식이나 말투 제어를 동일하게 기대할 수 없다.

🧠 상세 정리

1. 공유 문서에 서로 다른 답변이 필요한 배경

동일한 제품·정책 문서를 여러 지역의 고객과 내부 팀이 함께 사용하더라도, 각 대상이 요구하는 언어와 표현 방식, 답변 구조는 다를 수 있다. 기존 agentic retrieval에서는 응답 스타일을 직접 설정할 수 없어 요청마다 스타일이 달라질 수 있었고, 고정된 말투나 구조화된 출력이 필요하면 응답 생성을 끈 뒤 모델을 직접 호출해야 했다. 이 방식에서는 각 애플리케이션이 자체 프롬프트를 유지해야 했지만, retrieval instructions를 사용하면 해당 지침을 관리형 Amazon Bedrock 리소스로 한 번 작성하고 각 요청에서 참조할 수 있다. 지침은 버전으로 관리되므로 내용을 바꾼 뒤에도 특정 버전을 고정해 두고, 애플리케이션이 준비되는 시점에 새 버전으로 전환할 수 있다.

2. 테넌트별 요구와 활용 사례

가상의 AnyCompany Smart Home은 홈 컨트롤러와 실내 센서를 판매하는 지역 3곳 및 지원·현장 영업·법무 팀을 각각 테넌트로 정의하며, 이들은 같은 문서를 바탕으로 서로 다른 답변을 요구한다. Sales Region Central 고객에게는 스페인어와 일/월/년 날짜 형식이 필요하고, 지원 담당자에게는 짧은 티켓 메모가 필요하다는 식이다. 원문의 비교에서는 지침이 없으면 모든 지역의 반품 기간을 나열한 뒤 구매 지역을 묻지만, Central 지침과 고객 지역을 함께 제공하면 배송일로부터 45일이라는 답을 스페인어로 제시하고 central-returns-addendum.md를 출처로 표시한다. 이러한 방식은 고객별 말투와 규칙, 고정 면책 문구와 인용 형식, 후속 코드가 소비할 엄격한 JSON 출력에도 활용할 수 있다.

3. 지침을 구성하는 네 필드와 적용 조건

retrieval instruction의 persona는 도우미의 정체성·말투·언어를 정하고, answerFormat은 답변 구조와 출처 인용 방식을 정한다. retrievalGuidance는 질문 해석과 검색 우선순위를 안내하며, answerPolicy는 답변 여부와 방식 및 범위를 벗어난 질문의 처리를 규정한다. 이 네 필드는 적용 조건이 같지 않아서, persona·answerFormat·answerPolicy는 기본값이 true인 generateResponse가 true일 때만 적용되지만 retrievalGuidance는 응답 생성 여부와 관계없이 적용된다. 따라서 검색만 수행하는 구성에서도 검색 지침은 유효하지만, 생성 단계에 속하는 말투·형식·응답 정책까지 동일하게 적용되는 것으로 이해해서는 안 된다.

4. 생성부터 버전 적용과 추적까지의 수명주기

지침은 특정 지식 기반에 속하는 객체가 아니라 AWS 계정과 AWS 리전에 속하는 리소스이며, 생성·검토·활성화·버전 생성·요청 적용·추적의 순서로 사용된다. CreateRetrievalInstruction은 HTTP 202를 반환하고 Amazon Bedrock이 필드를 비동기로 검토하므로, 호출자는 결과를 폴링하며 실패 시 lastTransitionStatusReasons에서 사유를 확인해야 한다. 검토를 통과하면 지침은 ACTIVE가 되고 DRAFT는 현재 내용을 가리키며, CreateRetrievalInstructionVersion을 호출하면 변경할 수 없는 번호 버전이 저장된다. 요청에는 지침과 선택적인 버전을 지정하고 버전을 생략하면 DRAFT가 사용되며, 첫 Planning 추적 이벤트에는 appliedInstruction이 포함되어 적용된 지침을 확인할 수 있다.

5. 응답 개인화와 데이터 격리를 결합하는 구조

원문은 retrieval instructions가 말투·형식·관례·정책 문구를 설정할 뿐, 검색 가능한 문서를 제한하거나 테넌트의 정책값을 스스로 선택하지는 않는다고 강조한다. 제안 구조에서는 백엔드가 인증된 테넌트를 지침 버전과 메타데이터 필터에 연결하고 메시지에 짧은 테넌트 설명을 추가한 다음, 공유 관리형 지식 기반에 AgenticRetrieveStream을 호출한다. 테넌트마다 별도 지식 기반을 두는 방식도 가능하며, 요청 하나에서 공유 전역 지식 기반과 테넌트 전용 지식 기반을 각각의 필터와 함께 검색할 수 있다. 단일 요청은 최대 5개 지식 기반을 검색할 수 있고 지침은 모두에 적용되며, 예제의 32개 문서 중 제한된 엔지니어링 문서 2개는 어느 테넌트의 필터로도 반환되면 안 된다.

6. 예제 데이터와 실행을 위한 준비 조건

예제는 AnySmartProduct-5 홈 컨트롤러와 AnySmartProduct-6 실내 센서에 관한 가상의 정책·제품 문서를 Amazon S3에 저장하고, 각 문서에 region·audience_team·sensitivity 메타데이터를 부여한다. 실행에는 지침·IAM 역할·S3 버킷을 생성할 권한이 있는 AWS 계정, 관리형 지식 기반, 필터링할 문서별 메타데이터 파일, Python 3.10 이상과 최신 Boto3 및 AWS CLI가 필요하다. 오래된 Boto3에는 retrieval instruction 작업이 없고 AgenticRetrieveStream에는 CLI 명령이 없으므로 SDK로 호출해야 하며, 제시된 코드는 Boto3 1.43.118에서 확인한 예시다. 저장소에는 Python과 TypeScript 코드가 있고 기본 리전은 us-east-1이며 AWS_REGION으로 변경할 수 있지만, 실제 지원 리전은 별도로 확인하도록 안내한다.

7. Sales Region Central 지침의 구체적인 구성

Sales Region Central의 persona는 해당 지역에서 AnySmartProduct-5 또는 AnySmartProduct-6를 구매한 고객을 돕고, 친근하고 쉬운 스페인어로 고객을 usted라고 부르도록 지정한다. answerFormat은 한 문장의 직접적인 답변 뒤에 짧은 설명을 붙이고, 날짜는 31/12/2026처럼, 금액은 5,00 USD처럼 쓰며, 마지막 줄에 영어 표기 Source:와 주요 출처 파일명을 넣도록 한다. retrievalGuidance는 영어 문서를 검색하기 위해 영어 검색어를 사용하고 Central 지역명을 포함하며, 해당 지역 부속 정책을 전역 기본 정책과 다른 지역 부속 정책보다 우선하도록 안내한다. answerPolicy는 검색된 내용과 정확한 수치에 근거한 답변, 다른 지역 구매 건의 처리, 내부 할인율과 제한된 엔지니어링 정보의 비공개, 근거가 없을 때의 안내를 규정하며 검색된 텍스트는 지시가 아닌 참고 자료로 취급하도록 명시한다.

8. 지침 생성·갱신과 필터 적용 시의 주의점

테넌트별 지침은 sales-region-central 같은 키를 이름과 tenant 태그에 사용해 생성하고, GetRetrievalInstruction으로 lastTransitionStatus가 CREATING이나 UPDATING을 벗어날 때까지 확인한 뒤 ACTIVE 여부를 검증한다. 활성 상태가 아니면 사유를 읽어 수정해야 하며, 통과한 지침의 버전을 생성해 릴리스 구성에 기록하고 예제에서는 6개 테넌트 모두 버전 1을 고정한다. 갱신은 설명을 포함한 지침 전체를 대체하므로 유지할 필드를 모두 다시 보내야 하고, 자체 AWS KMS 키를 사용할 경우 생성 시 customerEncryptionKeyArn을 지정해야 하며 나중에 키를 추가하거나 변경할 수 없다. 마지막 부분은 지침만으로는 다른 지역 부속 정책이나 어떤 테넌트도 보아서는 안 되는 문서의 검색을 막을 수 없다고 재차 설명하지만, 제공된 본문이 메타데이터 필터 구성 설명 도중에 끝나므로 이후 구현 세부는 확인할 수 없다.

🧾 핵심 주장 / 시사점

  • 공유 지식 기반에서 테넌트별 응답을 구현하려면 언어와 형식의 차이뿐 아니라 인증된 테넌트, 지침 버전, 검색 필터의 연결이 함께 맞아야 한다.
  • 번호 버전의 불변성과 appliedInstruction 추적은 지침 변경을 배포하는 시점과 실제 요청에 적용된 내용을 연결하는 근거가 된다.
  • 검색된 문서를 지시가 아닌 참고 자료로 취급하도록 응답 정책에 명시하더라도, 검색 가능한 데이터의 경계는 메타데이터 필터나 별도 지식 기반으로 설정해야 한다.

✅ 액션 아이템

  • 인증된 테넌트별 지침 버전과 메타데이터 필터의 연결을 확인하고, 제한된 엔지니어링 문서 2개의 검색 제외 여부를 검증.
  • 불변 번호 버전의 고정 여부와 DRAFT 기본 적용 조건을 확인하고, appliedInstruction으로 실제 적용 지침을 검증.
  • generateResponse 설정에 따라 persona·answerFormat·answerPolicy와 retrievalGuidance의 적용 범위를 구분.

❓ 열린 질문

  • 인증된 테넌트별 메타데이터 필터는 다른 테넌트의 문서와 제한된 엔지니어링 문서 2개를 모두 제외하는가?
  • 각 애플리케이션은 불변 번호 버전을 명시하는가, 아니면 버전 생략으로 DRAFT를 적용받는가?
  • generateResponse가 true가 아닌 구성에서도 persona·answerFormat·answerPolicy의 적용을 기대하고 있는가?

관련 문서

공통 태그와 주제 흐름을 기준으로 같이 보면 좋은 문서를 이어서 제안합니다.