Risposte fondate con risultati di ricerca in tempo reale

Nota

Questa documentazione è per Amazon Nova versione 1. Per informazioni sull'utilizzo di Web Grounding con Amazon Nova 2, visita Web Grounding.

Il web Grounding migliora i modelli Nova collegandoli a informazioni in tempo reale che vanno oltre i loro limiti di conoscenza, garantendo risposte più accurate e affidabili.

Come funziona il web grounding

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_grounding abilitato come SystemTool.

2. Valutazione della ricerca: il modello analizza il prompt e determina se è necessaria una ricerca per migliorare la risposta.

3. Esecuzione della ricerca: quando necessario, il modello esegue automaticamente una o più ricerche di informazioni pertinenti.

4. Analisi dei risultati: il modello decide se sono necessarie ulteriori ricerche per ampliare la propria comprensione o approfondire specifici argomenti secondari.

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

Come usare il web grounding

Per includere il web grounding nei risultati, specifica il seguente parametro systemTool nel blocco toolConfig:

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

Nel tuo toolConfig, aggiungi uno strumento con il parametro systemTool come nell’esempio precedente. Questo parametro consente di specificare strumenti definiti dal sistema. Gli strumenti definiti dal sistema sono strumenti forniti e invocati dal provider del modello. Per i dettagli sull'utilizzo del systemTool parametro, consulta il riferimento SystemToolall'API Amazon Bedrock.

Nota

Il web grounding è disponibile solo nelle regioni degli Stati Uniti. Puoi usare il web grounding chiamando Amazon Nova Premier con il profilo di inferenza interregionale us.amazon.nova-premier-v1:0.

L'esempio seguente è un comando AWS CLI che utilizza 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?"}]}]'

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

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

Questa risposta contiene due componenti: il testo generato dal modello e le informazioni di citazione relative a tale testo. Gli elementi compresi sono:

• text: un segmento della risposta generata dal modello.

• citationsContent: il container principale per i dati di citazione relativi a un segmento text.

• citations: un container all’interno di citationsContent che contiene la posizione di una citazione.

• location: un container all’interno di citations che contiene la fonte di una citazione.

• web: un container all’interno di location che contiene i dettagli della fonte web.

• url: l’indirizzo web completo (URL) della fonte della citazione.

• domain: il dominio principale della fonte url.

Sicurezza del grounding

I tuoi dati non escono AWS mai dall'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 grafici di conoscenza danno priorità alle fonti affidabili e di alta qualità e filtrano i contenuti dannosi in ingresso. Il web grounding perfeziona ulteriormente le informazioni durante il runtime attraverso riferimenti incrociati da più fonti. 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 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:

• malformed_tool_use

• max_tokens

• malformed_model_output

Accesso allo strumento di Debugging

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

1. Attiva BedrockFullAccess il tuo ruolo IAM: se il tuo ruolo lo ha fatto BedrockFullAccess, avrà accesso automaticamente a Web Grounding.

2. 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 il testo rosso con l'ID del tuo AWS account:

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

Il web grounding ha la chiave di condizione aws:requestedRegion impostata su “unspecified”. Se le politiche esistenti o le politiche di controllo dei servizi (SCPs) applicano questa condizione, potresti riscontrare problemi di accesso. L’aggiornamento della condizione per consentire una requestedRegion “non specificata” può risolvere questo problema.

Importante

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 https://aws.amazon.com//bedrock/pricing/.