Respostas de grounding com resultados de pesquisa em tempo real - Amazon Nova
Como funciona o Web GroundingComo usar o Web Grounding Segurança do grounding Como tratar erros

Respostas de grounding com resultados de pesquisa em tempo real

nota

Esta documentação é para o Amazon Nova versão 1. Para obter informações sobre o uso do Web Grounding com o Amazon Nova 2, acesse Web Grounding.

O Web Grounding aprimora os modelos do Nova conectando-os a informações em tempo real além do limite de conhecimento, o que resulta em respostas mais precisas e confiáveis.

Como funciona o Web Grounding

Quando o Web Grounding está habilitado para um prompt, as seguintes etapas são executadas:

  1. Configuração da solicitação — Seu aplicativo envia um prompt de usuário para a API Amazon Bedrock com nova_grounding habilitado como systemTool.

  2. Avaliação da pesquisa — O modelo analisa o prompt e determina se a pesquisa é necessária para melhorar a resposta.

  3. Execução da pesquisa — Quando necessário, o modelo executa automaticamente uma ou mais pesquisas para informações relevantes.

  4. Análise dos resultados — O modelo decide se pesquisas adicionais são necessárias, para expandir sua compreensão ou se aprofundar em subtópicos específicos.

  5. Geração de resposta — O Nova sintetiza automaticamente as informações dos resultados da pesquisa para gerar uma resposta final da API baseada em informações em tempo real, completa com citações de suas fontes.

Como usar o Web Grounding

Para incluir o Web Grounding em seus resultados, especifique o seguinte parâmetro systemTool em seu bloco toolConfig:

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

No seu toolConfig, adicione uma ferramenta com parâmetro systemTool como no exemplo acima. Esse parâmetro permite especificar ferramentas definidas pelo sistema. As ferramentas definidas pelo sistema são ferramentas fornecidas e invocadas pelo provedor do modelo. Para obter detalhes sobre o uso do parâmetro systemTool, consulte SystemTool na referência da API Amazon Bedrock.

nota

O Web Grounding está disponível somente nas regiões dos EUA. Você pode usar o Web Grounding ligando para o Amazon Nova Premier com o perfil de inferência entre regiões us.amazon.nova-premier-v1:0.

O exemplo a seguir é um comando da AWS CLI usando o Web Grounding:

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?"}]}]'

O seguinte é um exemplo de resposta. A resposta foi abreviada para ser breve:

...
{
    "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"
                    }
            }
         }
        ]
    }
},
...

Essa resposta contém dois componentes: o texto gerado pelo modelo e as informações de citação desse texto. Os elementos incluídos são:

  • text — Um segmento da resposta gerada pelo modelo.

  • citationsContent — O contêiner principal para os dados de citação relacionados a um segmento text.

  • citations — Um contêiner interno citationsContent que contém a localização de uma citação.

  • location — Um contêiner interno citations que contém a fonte de uma citação.

  • web — Um contêiner interno location que contém os detalhes da fonte da web.

  • url — O endereço completo da web (URL) da fonte da citação.

  • domain — O domínio raiz da fonte url.

Segurança do grounding

Seus dados nunca saem da infraestrutura AWS. As consultas geradas pelo modelo permanecem nos serviços AWS e nunca são enviadas para a internet geral. Nosso amplo índice interno de pesquisa na web e gráficos de conhecimento priorizam fontes confiáveis e de alta qualidade e filtram conteúdo malicioso na entrada. O Web Grounding refina ainda mais as informações durante o runtime, fazendo referência cruzada a partir de múltiplas fontes. Por fim, protegemos seu aplicativo contra injeção indireta de prompt e desinformação com a filtragem de runtime (observe que essa mitigação é limitada para idiomas que não sejam o inglês).

Como tratar erros

Não inclua uma entrada toolSpec com o nome nova_grounding. Incluir uma ferramenta com esse nome resultará em um erro.

Veja a seguir uma lista de possíveis erros que podem ocorrer ao usar o Web Grounding:

  • malformed_tool_use

  • max_tokens

  • malformed_model_output

Acesso à ferramenta de depuração

Para garantir que sua função tenha acesso ao Web Grounding no AWS Bedrock, você tem duas opções:

  1. Ative o BedrockFullAccess em seu perfil do IAM: se sua função tiver BedrockFullAccess, ela terá acesso automático ao Web Grounding.

  2. Adicione permissões específicas (se necessário): se você precisar de um controle de acesso mais granular, adicione essa política à política do IAM da sua função, substituindo o texto em vermelho pelo ID da sua conta AWS:

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

O Web Grounding tem a chave de condição aws:requestedRegion definida como “não especificada”. Se suas políticas existentes ou Políticas de Controle de Serviços (SCPs) impuserem essa condição, você poderá encontrar problemas de acesso. Atualizar a condição para permitir uma requestedRegion “não especificada” pode resolver esse problema.

Importante

Ao habilitar a ferramenta Web Grounding, você se torna responsável pelo seu uso, e por qualquer uso por parte de seus usuários finais, do conteúdo gerado que incorpore informações fundamentadas. Você saberá quando sua resposta incluir informações fundamentadas em citações ou links para o material de origem. Você deve reter e exibir essas citações e links no resultado que fornecer aos seus usuários finais.

nota

O Web Grounding tem um custo adicional. Para obter mais informações, consulte https://aws.amazon.com//bedrock/pricing/