Guardrails를 애플리케이션 안전 경계에 배치하기
콘텐츠 검사, 문서 권한, 업무 동작 제어를 분리해 설계하고 검수합니다.
네 가지 제어 지점 구분하기
입력 검사는 부적절한 요청과 민감 입력을 처리합니다. 검색 권한은 호출자가 사용할 문서를 통제합니다. 출력 검사는 생성 내용을 평가하고 도구 권한은 업무 동작을 통제합니다. 콘텐츠 필터가 기록 접근이나 결제를 승인하지는 않습니다.
허용 사용 정책, 금지 콘텐츠 사례, 민감 데이터 규칙, 애플리케이션 데이터 흐름을 준비합니다. 각 규칙을 강제할 구성요소에 연결합니다. 차단, 부분 마스킹, 사람 검토 시 사용자에게 무엇을 보여줄지 정합니다.
지원되는 검사만 구성하기
Bedrock Guardrails는 콘텐츠, 금지 주제, 단어, 민감 정보 필터와 지원되는 근거 확인 등을 제공합니다. 독립 ApplyGuardrail API는 모델 호출과 별도로 지원 텍스트를 평가할 수 있습니다. 직접 연동은 모델, API, 리전, 엔드포인트에 따라 달라집니다.
예를 들어 현재 GPT-6.1 Sol 모델 카드는 일반 API 문서보다 엄격하게 Responses의 통합 Guardrails를 제외합니다. 헤더만 추가하면 모든 경로가 보호된다고 가정하지 않습니다. 문서화된 지원 경로나 명시적인 애플리케이션 검사를 선택하고 테스트합니다.
오탐과 누락 평가하기
허용, 금지, 모호한 사례와 다국어 샘플을 사용합니다. 검색 콘텐츠의 프롬프트 주입, 메시지에 나뉜 민감 정보, 금지 주제와 비슷한 정상 업무 요청을 포함합니다. 정책 버전, 기대 판단, 실제 판단을 기록합니다.
스트리밍 출력에서는 평가 완료 전에 일부 내용이 사용자에게 도달해도 되는지 결정합니다. token 스트리밍이 이미 안전하다고 가정하지 말고 실제 버퍼링과 오류 동작을 검증합니다.
정책과 제어의 대응도, 설정 참조, 샘플 결과, 상위 지원 경로를 전달합니다. 필터 테스트와 함께 권한 및 동작 테스트도 유지합니다. 어떤 설정도 절대적 안전이나 법적 준수를 확립하지는 않습니다.
공식 참고 자료
문서 확인일: 2026년 10월 17일. 이 글은 참고 지침이며 작성 과정에서 클라우드 API를 호출하지 않았습니다.