Web grounding

A Ancoragem na Web permite que o Amazon Nova pesquise na web informações atuais e forneça respostas com citações. Esse recurso é útil para consultas que exigem informações atualizadas além dos dados de treinamento do modelo.

Como funciona o Web Grounding

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

Como usar o Web Grounding

Para obter exemplos completos de código que utiliza a Ancoragem na Web, consulte a seção Exemplos de código.

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

import boto3
from botocore.config import Config

# Create the Bedrock Runtime client with extended timeout
bedrock = boto3.client(
    "bedrock-runtime",
    region_name="us-east-1",
    config=Config(read_timeout=3600)
)

# Define the tool configuration
tool_config = {
    "tools": [{
        "systemTool": {
            "name": "nova_grounding"
        }
    }]
}

# Send the request
response = bedrock.converse(
    modelId="us.amazon.nova-2-lite-v1:0",
    messages=[{
        "role": "user",
        "content": [{"text": "What are the latest developments in quantum computing?"}]
    }],
    toolConfig=tool_config
)

# Extract text with interleaved citations
output_with_citations = ""
content_list = response["output"]["message"]["content"]
for content in content_list:
    if "text" in content:
        output_with_citations += content["text"]
    elif "citationsContent" in content:
        citations = content["citationsContent"]["citations"]
        for citation in citations:
            url = citation["location"]["web"]["url"]
            output_with_citations += f" [{url}]"

print(output_with_citations)

Disponibilidade regional

Atualmente, a Ancoragem na Web está disponível apenas nas regiões dos EUA e é compatível somente com os perfis CRIS dos EUA.

Estrutura de respostas

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

{
  "output": {
    "message": {
      "content": [
        {
          "text": "Recent quantum computing developments include...",
          "citationsContent": [
            {
              "location": {
                "web": {
                  "url": "https://example.com/quantum-news",
                  "domain": "example.com"
                }
              }
            }
          ]
        }
      ]
    }
  }
}

Cada citação inclui:

Segurança da ancoragem

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 abrangente í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. 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).

Tratamento de 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:

Permissões necessárias para ferramentas integradas

Para garantir que seu perfil tenha acesso à Ancoragem na Web no Amazon Bedrock, você tem duas opções:

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

A Ancoragem na Web tem a chave de condição aws:requestedRegion definida como “unspecified”. 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.