Réponses fondées sur des résultats de recherche en temps réel

Note

Cette documentation concerne la version 1 d'Amazon Nova. Pour plus d'informations sur l'utilisation de Web Grounding avec Amazon Nova 2, consultez Web Grounding.

L’ancrage Web améliore les modèles Nova en les connectant à des informations en temps réel au-delà de leurs connaissances, ce qui se traduit par des réponses plus précises et plus fiables.

Fonctionnement de l’ancrage Web

Lorsque l’ancrage Web est activé pour une invite, les étapes suivantes sont effectuées :

1. Configuration de la demande : votre application envoie une invite utilisateur à l’API Amazon Bedrock avec nova_grounding activé en tant que systemTool.

2. Évaluation de la recherche : le modèle analyse l’invite et détermine si une recherche est nécessaire pour améliorer la réponse.

3. Exécution de la recherche : si nécessaire, le modèle effectue automatiquement une ou plusieurs recherches d’informations pertinentes.

4. Analyse des résultats : le modèle détermine si des recherches supplémentaires sont nécessaires pour approfondir sa compréhension ou approfondir des sous-thèmes spécifiques.

5. Génération de la réponse : Nova synthétise automatiquement les informations issues des résultats de recherche afin de générer une réponse API finale fondée sur des informations en temps réel, accompagnée de citations de ses sources.

Comment utiliser l’ancrage Web

Pour inclure l’ancrage Web dans vos résultats, spécifiez le paramètre systemTool suivant dans votre bloc toolConfig :

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

Dans votre toolConfig, ajoutez un outil avec le paramètre systemTool comme dans l’exemple ci-dessus. Ce paramètre vous permet de spécifier des outils définis par le système. Les outils définis par le système sont des outils fournis et invoqués par le fournisseur du modèle. Pour en savoir plus sur l'utilisation du systemTool paramètre, consultez SystemToolla référence de l'API Amazon Bedrock.

Note

L’ancrage Web n’est disponible que dans les régions des États-Unis. Vous pouvez utiliser l’ancrage Web en appelant Amazon Nova Premier avec le profil d’inférence interrégional us.amazon.nova-premier-v1:0.

L'exemple suivant est une commande AWS CLI utilisant 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?"}]}]'

Voici un exemple de réponse. La réponse a été raccourcie par souci de concision :

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

Cette réponse contient deux éléments : le texte généré par le modèle et les informations de citation pour ce texte. Les éléments inclus sont les suivants :

• text : segment de la réponse générée par le modèle.

• citationsContent : conteneur principal pour les données de citation liées à un segment text.

• citations : conteneur dans citationsContent qui contient l’emplacement d’une citation.

• location : conteneur au sein de citations qui contient la source d’une citation.

• web : conteneur au sein de location qui contient les détails de la source Web.

• url : adresse Web complète (URL) de la source de la citation.

• domain : domaine racine de la source url.

Sécurité de l’ancrage

Vos données ne quittent jamais AWS l'infrastructure. Les requêtes générées par le modèle restent dans le cadre AWS des services et ne sont jamais envoyées sur Internet au sens large. Notre vaste index de recherche Web interne et nos graphes de connaissances donnent la priorité aux sources fiables et de haute qualité et filtrent les contenus malveillants à leur entrée. L’ancrage Web affine encore les informations au moment de l’exécution en recoupant les données provenant de plusieurs sources. Enfin, nous protégeons votre application contre l’injection d’invites indirectes et les informations erronées grâce à un filtrage à l’exécution (veuillez noter que cette mesure d’atténuation est limitée pour les langues autres que l’anglais).

Gestion des erreurs

Veuillez ne pas inclure d’entrée toolSpec avec le nom nova_grounding. L’inclusion d’un outil portant ce nom entraînera une erreur.

Voici une liste des erreurs potentielles qui peuvent survenir lors de l’utilisation de l’ancrage Web :

• malformed_tool_use

• max_tokens

• malformed_model_output

Accès à l’outil de débogage

Pour que votre rôle puisse accéder à Web Grounding on AWS Bedrock, deux options s'offrent à vous :

1. Activez BedrockFullAccess sur votre rôle IAM : si votre rôle l'a fait BedrockFullAccess, il aura automatiquement accès à Web Grounding.

2. Ajoutez des autorisations spécifiques (si nécessaire) : si vous avez besoin d'un contrôle d'accès plus précis, ajoutez cette politique à la politique IAM de votre rôle, en remplaçant le texte rouge par votre identifiant de AWS compte :

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

L’ancrage Web a la clé de condition aws:requestedRegion définie sur « unspecified ». Si vos politiques existantes ou vos politiques de contrôle des services (SCPs) appliquent cette condition, vous pouvez rencontrer des problèmes d'accès. La mise à jour de la condition pour autoriser une requestedRegion « unspecified » peut résoudre ce problème.

Important

Si vous activez l’outil d’ancrage Web, vous êtes responsable de votre utilisation et de toute utilisation par vos utilisateurs finaux des résultats qui intègrent des informations ancrées. Vous saurez quand vos résultats incluent des informations ancrées grâce aux citations ou aux liens vers les sources. Vous devez conserver et afficher ces citations et ces liens dans les résultats que vous fournissez à vos utilisateurs finaux.

Note

L’ancrage Web entraîne des frais supplémentaires. Pour plus d'informations, consultez https://aws.amazon.com//bedrock/pricing/.