실시간 검색 결과로 답변의 근거 마련 - Amazon Nova
Web Grounding 작동 방식Web Grounding 사용 방법 그라운딩 안전 오류 처리

실시간 검색 결과로 답변의 근거 마련

참고

이 설명서는 Amazon Nova 버전 1용입니다. Amazon Nova 2에서 Web Grounding을 사용하는 방법에 대한 자세한 내용은 Web Grounding을 참조하세요.

Web Grounding은 모델 성능을 높이기 위해 Nova 모델을 지식 한계를 넘어 실시간 정보에 연결하여 더욱 정확하고 신뢰할 수 있는 답변을 제공합니다.

Web Grounding 작동 방식

프롬프트에 대해 Web Grounding이 활성화되면 다음 단계가 수행됩니다.

  1. 요청 구성 - 애플리케이션에서 nova_grounding을 systemTool로 활성화한 상태로 Amazon Bedrock API에 사용자 프롬프트를 전송합니다.

  2. 검색 평가 - 모델이 프롬프트를 분석하고 응답을 개선하기 위해 검색이 필요한지 결정합니다.

  3. 검색 실행 - 필요한 경우 모델이 관련 정보에 대해 하나 이상의 검색을 자동으로 수행합니다.

  4. 결과 분석 - 모델이 특정 하위 주제에 대한 이해를 넓히거나 더 깊이 탐구하기 위해 추가 검색이 필요한지 여부를 결정합니다.

  5. 응답 생성 - Nova가 검색 결과의 정보를 자동으로 합성하여 실시간 정보에 근거한 최종 API 응답을 생성하며, 여기에는 출처에 대한 인용도 포함됩니다.

Web Grounding 사용 방법

결과에 Web Grounding을 포함하려면 toolConfig 블록에 다음 systemTool 파라미터를 지정합니다.

"toolConfig": {
    "tools": [
        {"systemTool": {"name": "nova_grounding"}}
    ]
}

위의 예와 같이 toolConfig에서 systemTool 파라미터를 사용하여 도구를 추가합니다. 이 파라미터를 사용하면 시스템 정의 도구를 지정할 수 있습니다. 시스템 정의 도구는 모델 제공업체에서 제공하고 간접적으로 호출하는 도구입니다. systemTool 파라미터 사용에 대한 자세한 내용은 Amazon Bedrock API 참조의 SystemTool을 참조하세요.

참고

Web Grounding은 미국 리전에서만 사용할 수 있습니다. 교차 리전 추론 프로필 us.amazon.nova-premier-v1:0으로 Amazon Nova Premier를 직접적으로 호출하여 Web Grounding을 사용할 수 있습니다.

다음 예제는 Web Grounding을 사용하는 AWS CLI 명령입니다.

aws --profile 111122223333 --region us-east-1 bedrock-runtime converse --model-id us.amazon.nova-premier-v1:0 --tool-config '{"tools":[{"systemTool":{"name":"nova_grounding"}}]}' --messages '[{"role":"user","content":[{"text":"What is the latest news about renewable energy sources?"}]}]'

다음은 응답의 예입니다. 간결성을 위해 응답을 축약했습니다.

...
{
    "text": ".\n- **Solar energy** is leading growth with a 31% increase in generation in early 2025, outpacing wind's 7.7% growth "
},
{
    "citationsContent": {
        "citations": [
            {
                "location": {
                    "web": {
                        "url": "https://www.rfi.fr/en/environment/20251008-renewables-overtake-coal-but-growth-slows-amid-us-and-china-report-shows",
                        "domain": "rfi.fr"
                    }
            }
         }
        ]
    }
},
...

이 응답에는 모델이 생성한 텍스트와 해당 텍스트에 대한 인용 정보라는 두 가지 구성 요소가 포함되어 있습니다. 포함된 요소는 다음과 같습니다.

  • text - 모델이 생성한 응답의 세그먼트입니다.

  • citationsContent - text 세그먼트와 관련된 인용 데이터의 기본 컨테이너입니다.

  • citations - 인용의 위치가 담긴 citationsContent 내의 컨테이너입니다.

  • location - 인용의 출처가 담긴 citations 내의 컨테이너입니다.

  • web - 웹 소스 세부 정보가 담긴 location 내의 컨테이너입니다.

  • url - 인용 출처의 전체 웹 주소(URL)입니다.

  • domain - 출처 url의 루트 도메인입니다.

그라운딩 안전

데이터는 AWS 인프라를 벗어나지 않습니다. 모델 생성 쿼리는 AWS 서비스 내에 유지되며 더 광범위한 인터넷으로 전송되지 않습니다. 광범위한 내부 웹 검색 인덱스 및 지식 그래프는 신뢰할 수 있는 고품질 소스의 우선 순위를 지정하고 수신 시 악성 콘텐츠를 필터링합니다. Web Grounding은 여러 소스에서 교차 참조하여 런타임 시 정보를 더욱 구체화합니다. 마지막으로 런타임 필터링을 통해 간접 프롬프트 인젝션과 잘못된 정보로부터 애플리케이션을 보호합니다. 영어 이외의 언어의 경우 이 완화 조치가 제한됩니다.

오류 처리

이름이 nova_grounding인 toolSpec 항목을 포함하지 마세요. 이 이름의 도구를 포함하면 오류가 발생합니다.

다음은 Web Grounding을 사용할 때 발생할 수 있는 잠재적 오류 목록입니다.

  • malformed_tool_use

  • max_tokens

  • malformed_model_output

도구 액세스 디버깅

AWS Bedrock에서 Web Grounding에 액세스할 수 있게 하려는 경우 두 가지 옵션이 있습니다:

  1. IAM 역할에서 BedrockFullAccess 활성화: 역할에 BedrockFullAccess가 있는 경우 Web Grounding에 자동으로 액세스할 수 있습니다.

  2. 특정 권한 추가(필요한 경우): 더욱 세부적인 액세스 제어가 필요한 경우 역할의 IAM 정책에 이 정책을 추가하고 빨간색 텍스트를 AWS 계정 ID로 바꾸세요.

    
{ 
    Statement: [ 
      { 
        Effect: "Allow", 
        Action: [ "bedrock:InvokeTool" ], 
        Resource: [ "arn:aws:bedrock::{111122223333}:system-tool/amazon.nova_grounding" ] 
       } 
      ] 
}

Web Grounding에는 aws:requestedRegion 조건 키가 'unspecified'로 설정되어 있습니다. 기존 정책이나 서비스 제어 정책(SCP)에서 이 조건을 적용하는 경우 액세스 문제가 발생할 수 있습니다. 'unspecified' requestedRegion을 허용하도록 조건을 업데이트하여 이 문제를 해결할 수 있습니다.

중요

Web Grounding 도구를 활성화하는 경우 근거 정보를 포함하는 출력의 사용에 대한 책임은 사용자에게 있습니다. 최종 사용자에 의한 사용에 대한 책임도 사용자에게 있습니다. 출력에 인용이나 출처 자료 링크의 근거 정보가 포함되는 경우 이를 알 수 있습니다. 최종 사용자에게 제공하는 출력에 이러한 인용 및 링크를 유지하고 표시해야 합니다.

참고

Web Grounding은 추가 비용이 발생합니다. 자세한 내용은 https://aws.amazon.com//bedrock/pricing/ 섹션을 참조하세요.