Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Web grounding

Web Grounding consente ad Amazon Nova di cercare sul Web informazioni aggiornate e fornire risposte con citazioni. Questa funzionalità è utile per le query che richiedono up-to-date informazioni oltre ai dati di addestramento del modello.

Come funziona il web grounding

Quando il web grounding è abilitato per un prompt, vengono portati a termine i seguenti passaggi:

Come usare il web grounding

Per esempi completi di codice che utilizza Web Grounding, consulta la sezione Esempi di codice.

Per includere Web Grounding nei risultati, specificate il seguente systemTool parametro nel blocco 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)

Disponibilità regionale

Web Grounding è attualmente disponibile solo nelle regioni degli Stati Uniti e supportato solo dai profili CRIS statunitensi.

Struttura della risposta

Di seguito è riportata una risposta di esempio. La risposta è stata abbreviata per motivi di brevità:

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

Ogni citazione include:

Sicurezza di messa a terra

I tuoi dati non lasciano mai l' AWS infrastruttura. Le query generate dai modelli rimangono all'interno AWS dei servizi e non vengono mai inviate a Internet in senso lato. Il nostro ampio indice di ricerca web interno e i nostri grafici di conoscenza danno priorità a fonti affidabili e di alta qualità e filtrano i contenuti dannosi in caso di ingresso. Infine, proteggiamo la tua applicazione dall’iniezione indiretta di prompt e dalla diffusione di informazioni errate tramite il filtraggio runtime (si noti che questa mitigazione è limitata per le lingue diverse dall’inglese).

Gestione degli errori

Non includere una voce toolSpec con il nome nova_grounding. L’inclusione di uno strumento con questo nome causerà un errore.

Di seguito è riportato un elenco di potenziali errori che possono verificarsi durante l’utilizzo del web grounding:

Autorizzazioni necessarie per gli strumenti integrati

Per garantire che il tuo ruolo possa accedere a Web Grounding su Amazon Bedrock, hai due opzioni:

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

Web Grounding ha la chiave di aws:requestedRegion condizione impostata su «non specificato». Se le politiche esistenti o le politiche di controllo del servizio (SCPs) applicano questa condizione, è possibile che si verifichino problemi di accesso. L’aggiornamento della condizione per consentire una requestedRegion “non specificata” può risolvere questo problema.