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à. # 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](https://docs.aws.amazon.com/nova/latest/nova2-userguide/web-grounding.html). 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. 1. **Valutazione della ricerca**: il modello analizza il prompt e determina se è necessaria una ricerca per migliorare la risposta. 1. **Esecuzione della ricerca**: quando necessario, il modello esegue automaticamente una o più ricerche di informazioni pertinenti. 1. **Analisi dei risultati**: il modello decide se sono necessarie ulteriori ricerche per ampliare la propria comprensione o approfondire specifici argomenti secondari. 1. **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 [SystemTool](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_SystemTool.html)all'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. 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 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/](https://aws.amazon.com//bedrock/pricing/).