Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Ancrage Web

Web Grounding permet à Amazon Nova de rechercher sur le Web des informations actuelles et de fournir des réponses avec des citations. Cette fonctionnalité est utile pour les requêtes nécessitant des up-to-date informations autres que les données d'entraînement du modèle.

Fonctionnement de l’ancrage Web

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

Comment utiliser l’ancrage Web

Pour des exemples complets de code utilisant Web Grounding, consultez la section Exemples de code.

Pour inclure Web Grounding dans vos résultats, spécifiez le systemTool paramètre suivant dans votre bloc 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é par région

Web Grounding n'est actuellement disponible que dans les régions des États-Unis et n'est pris en charge que par les profils CRIS américains.

Structure de réponse

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

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

Chaque citation inclut :

Sécurité de mise à la terre

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 interne sur le Web et nos graphiques de connaissances donnent la priorité aux sources fiables et de haute qualité et filtrent les contenus malveillants dès leur entrée. 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 :

Autorisations requises pour les outils intégrés

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

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

La clé de aws:requestedRegion condition de Web Grounding est définie sur « non spécifiée ». 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.