# 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](https://docs.aws.amazon.com/nova/latest/nova2-userguide/web-grounding.html). 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. 1. **Avaliação da pesquisa** — O modelo analisa o prompt e determina se a pesquisa é necessária para melhorar a resposta. 1. **Execução da pesquisa** — Quando necessário, o modelo executa automaticamente uma ou mais pesquisas para informações relevantes. 1. **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. 1. **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](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_SystemTool.html) 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. 1. **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/](https://aws.amazon.com//bedrock/pricing/)