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
<a name="web-grounding"></a>

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
<a name="how-web-grounding-works"></a>

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

1. **Richiedi configurazione**: l'applicazione invia un prompt utente all'API Amazon Bedrock con nova\$1grounding abilitato come. `systemTool`

1. **Ricerca e analisi**: il modello determina se è necessaria la ricerca, esegue una o più ricerche per trovare informazioni pertinenti e valuta se sono necessarie ricerche aggiuntive per ampliarne la comprensione o approfondire argomenti secondari specifici.

1. **Generazione di risposte**: Amazon Nova sintetizza automaticamente le informazioni dai risultati di ricerca per generare una risposta API finale basata su informazioni in tempo reale, completa di citazioni alle sue fonti.

## Come usare il web grounding
<a name="enable-web-grounding"></a>

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
<a name="web-grounding-availability"></a>

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

## Struttura della risposta
<a name="web-grounding-response-structure"></a>

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:
+ `text`: Un segmento della risposta generata dal modello.
+ `citationsContent`: Il contenitore principale per i dati di citazione relativi a un segmento di testo.
+ `citations`: Un contenitore all'interno `citationsContent` che contiene la posizione di una citazione.
+ `location`: Un contenitore all'interno `citations` che contiene la fonte di una citazione.
+ `web`: Un contenitore all'interno `location` che contiene i dettagli della fonte web.
+ `url`: L'indirizzo web completo (URL) della fonte della citazione.
+ `domain`: Il dominio principale dell'URL di origine.

## Sicurezza di messa a terra
<a name="web-grounding-safety"></a>

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
<a name="web-grounding-error-handling"></a>

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:
+ `malformed_tool_use`
+ `max_tokens`
+ `malformed_model_output`

## Autorizzazioni necessarie per gli strumenti integrati
<a name="permissions"></a>

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

1. **Attiva BedrockFullAccess il tuo ruolo IAM**: in caso affermativo BedrockFullAccess, avrà accesso automatico a Web Grounding.

1. **Aggiungi autorizzazioni specifiche (se necessario): se hai bisogno** di un controllo degli accessi più granulare, aggiungi questa politica alla politica IAM del tuo ruolo, sostituendo l'ID dell'account con il tuo ID: Account AWS 

```
{
    "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.

**Nota**  
Se abiliti lo strumento di web grounding, sei responsabile dell’uso che ne fai e di qualsiasi uso da parte dei tuoi utenti finali dei risultati che incorporano informazioni basate sul web grounding. Saprai quando il tuo output include informazioni basate sul web grounding da citazioni o collegamenti al materiale originale. Devi conservare e visualizzare queste citazioni e questi collegamenti nell’output fornito agli utenti finali.

**Nota**  
Il web grounding è un costo aggiuntivo. Per ulteriori informazioni, consulta la pagina dei prezzi di [AWS Bedrock](https://aws.amazon.com/bedrock/pricing/).