02 · 지식 기반(Knowledge Bases) 쿼리·응답 생성 — RetrieveAndGenerate
한 문장 요약: 지식 기반을 만든 뒤에는 콘솔 테스트 창 또는 RetrieveAndGenerate API로 쿼리하고, 소스 청크를 근거로 생성된 응답을 인용(citations)과 함께 돌려받는 것이 이 문서의 전부다.
- 태스크: T-DOC-02 · 연계 주차: 2주차(RAG)
- 원본: docs.aws.amazon.com/ko_kr/bedrock/latest/userguide/kb-test-retrieve-generate.html (2026-11-18 수집·본문 5,837자)
- 원문 사본:
downloads/04-kb-검색응답/kb-test-retrieve-generate.html
개요
지식 기반 설정이 끝나면 RetrieveAndGenerate API로 쿼리→검색→생성을 한 번에 수행한다. 응답은 원본 소스 데이터에 대한 인용과 함께 반환된다. 순위 변경(reranking) 모델로 검색 중 소스 청크의 관련성 순위를 다시 매길 수도 있다.
핵심 메시지 3
1. 응답은 반드시 인용과 함께 온다 — 각주를 선택하면 인용된 소스의 발췌가 나오고, 링크는 S3 객체로 이동한다. "출처가 포함된 답변"(시트5 RAG ⑤단계)의 구현체다.
2. 가드레일은 검색 결과에 적용되지 않는다(공식 경고) — "가드레일은 입력 및 LLM에서 생성된 응답에만 적용됩니다. 런타임 시 지식 기반에서 검색된 참조에는 적용되지 않습니다." (도메인 3 함정 문제의 소재)
3. 프롬프트 길이 초과 시 줄이는 4가지 공식 처방이 있다 — 검색 결과 최대 수 축소 · 더 작은 청크로 재색인 · 프롬프트 템플릿 축소 · 사용자 쿼리 축소 (모두 $search_results$/$query$ 자리표시자에 채워지는 내용을 줄인다).
주제별 심화
콘솔 테스트 절차 (원문 순서)
1. 콘솔 진입 → 좌측 지식 기반 선택 → 대상 라디오 버튼 → 지식 기반 테스트
2. 쿼리에 대한 응답 생성 토글 ON → 응답 생성 모델 선택 → 적용
3. 쿼리 입력 → 실행 → 응답의 각주로 인용 발췌 확인, 링크로 S3 객체 이동
4. 소스 세부 정보 표시 → 청크 원시 텍스트·메타데이터(.metadata.json의 속성/필드) 확인
5. 주의: 모델 변경·설정 변경 시 채팅 창 텍스트가 완전히 지워진다
API 요청 구조 (RetrieveAndGenerate)
| 필드 | 필수/선택 | 내용 |
|---|---|---|
input.text | 필수 | 쿼리 |
retrieveAndGenerateConfiguration | 필수 | 검색·생성 구성 |
sessionId | 선택 | 이전 세션 ID 재사용 — 대화 컨텍스트 유지 |
sessionConfiguration | 선택 | 세션 암호화용 사용자 지정 KMS 키 |
retrieveAndGenerateConfiguration.knowledgeBaseConfiguration:
- 필수:
knowledgeBaseId·modelArn(FM 또는 추론 프로파일 ARN) - 선택:
retrievalConfiguration(벡터 검색 사용자 지정) ·orchestrationConfiguration(프롬프트 처리) ·generationConfiguration(생성 설정)
순위 변경(reranking): KnowledgeBaseVectorSearchConfiguration.rerankingConfiguration에 모델·추가 요청 필드·메타데이터 필터·numberOfRerankedResults 지정.
- 규칙:
numberOfRerankedResults>numberOfResults면 반환 최대 수는numberOfResults— 단, 쿼리 분해 사용 시 최대 5배까지 가능.
응답 구조
output에 생성 응답 +citations배열- 인용 객체:
generatedResponsePart(textResponsePart + 출력 내 span 인덱스) ·retrievedReferences(청크 content·metadata·location URI/URL) - 이미지 소스:
data:image/jpeg;base64,...형식 + 응답 헤더x-amz-bedrock-kb-byte-content-source(S3 URI)·x-amz-bedrock-kb-description(base64) — 메타데이터 필터로는 이 헤더를 필터링할 수 없음 sessionId반환(대화 유지용) ·guardrailConfiguration포함 시guardrailAction으로 차단 여부 확인- 폐기 예고: citation 이벤트의
citation멤버는 사용 중단 →generatedResponsePart/retrievedReferences사용 권장
멀티모달 제한 (공식)
- Nova 멀티모달 임베딩 사용 시 RAG는 텍스트 콘텐츠로만 제한
- 오디오·비디오 처리 등 전체 멀티모달 지원이 필요하면 텍스트 임베딩 모델 + BDA 조합 사용
RetrieveAndGenerate흐름에서 Retrieve 응답의 이미지는 생성 프롬프트에 포함되나, 응답에는 이미지를 포함할 수 없고 이미지가 있는 소스를 인용만 가능
적용 체크리스트 (시험·실습 관점)
- ☐ RetrieveAndGenerate의 필수 필드 3종(input·configuration 내 knowledgeBaseId·modelArn)을 쓸 수 있는가
- ☐ "가드레일은 검색 참조에 적용 안 됨"을 시나리오 문제에 적용할 수 있는가 (도메인 3)
- ☐ reranking 결과 수 규칙(numberOfResults 상한·쿼리 분해 시 5배)을 기억하는가
- ☐ 프롬프트 길이 초과 4대 처방을 청킹 전략과 연결해 설명할 수 있는가 (도메인 1·5)
- ☐ sessionId 재사용이 대화 유지 수단임을 아는가
- ☐ 2주차 평가셋(질의 10개)을 콘솔 테스트 창에서 각주·소스 청크까지 확인하는 루프를 돌렸는가
최종 정리
이 문서는 RAG의 마지막 두 단계(④검색 → ⑤출처 포함 답변)를 관리형 서비스로 채우는 법을 다룬다. 시험 관점에서는 인용 구조(span·retrievedReferences)보다 경고성 서술(가드레일 미적용 범위·멀티모달 제한·프롬프트 초과 처방)이 출제 소재로 자주 쓰인다. 실습은 콘솔 테스트 창의 각주 확인 루프로 시작하는 것이 API보다 빠르다.
Provenance: 원문 인용·수치는 2026-11-18 수집 본문 기준. 기계 번역 한국어 문서로, 원문 영어와 상충 시 영어가 우선(원문 고지). 해석·체크리스트는 학습용 편집임.