Antworten mit Echtzeit-Suchergebnissen begründen

Anmerkung

Diese Dokumentation bezieht sich auf Amazon Nova Version 1. Informationen zur Verwendung von Web Grounding mit Amazon Nova 2 finden Sie unter Web Grounding.

Web Grounding verbessert Nova-Modelle, indem es sie mit Echtzeitinformationen verbindet, die über ihren Wissensstand hinausgehen, was zu genaueren und zuverlässigeren Antworten führt.

Wie funktioniert Web Grounding

Wenn Web Grounding für einen Prompt aktiviert ist, werden die folgenden Schritte ausgeführt:

1. Konfiguration anfordern – Ihre Anwendung sendet einen Benutzer-Prompt an die Amazon-Bedrock-API, wobei nova_grounding als systemTool aktiviert ist.

2. Bewertung der Suche – Das Modell analysiert den Prompt und stellt fest, ob eine Suche erforderlich ist, um die Antwort zu verbessern.

3. Suchausführung – Bei Bedarf führt das Modell automatisch eine oder mehrere Suchen nach relevanten Informationen durch.

4. Ergebnisanalyse – Das Modell entscheidet, ob zusätzliche Suchen erforderlich sind, um sein Verständnis zu erweitern oder bestimmte Unterthemen vertieft zu untersuchen.

5. Antwortgenerierung – Nova synthetisiert automatisch Informationen aus Suchergebnissen, um eine endgültige API-Antwort zu generieren, die auf Echtzeitinformationen basiert und mit Quellenangaben versehen ist.

Web Grounding verwenden

Um Web Grounding in Ihre Ergebnisse einzubeziehen, geben Sie den folgenden systemTool-Parameter in Ihrem toolConfig-Block an:

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

Bitte fügen Sie in toolConfig ein Tool mit dem Parameter systemTool wie im obigen Beispiel hinzu. Mit diesem Parameter können Sie systemdefinierte Tools angeben. Systemdefinierte Tools sind Tools, die vom Modellanbieter bereitgestellt und aufgerufen werden. Einzelheiten zur Verwendung des systemTool Parameters finden Sie SystemToolin der Amazon Bedrock API-Referenz.

Anmerkung

Web Grounding ist nur in US-Regionen verfügbar. Sie können Web Grounding verwenden, indem Sie Amazon Nova Premier mit dem regionsübergreifenden Inferenzprofil us.amazon.nova-premier-v1:0 aufrufen.

Das folgende Beispiel ist ein AWS CLI-Befehl, der Web Grounding verwendet:

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?"}]}]'

Nachfolgend finden Sie eine Beispielantwort. Die Antwort wurde gekürzt:

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

Diese Antwort besteht aus zwei Komponenten: dem vom Modell generierten Text und den Quellenangaben für diesen Text. Enthalten sind folgende Elemente:

• text – Ein Segment der vom Modell generierten Antwort.

• citationsContent – Der Hauptcontainer für die Zitate und Quellenangaben, die sich auf ein text-Segment beziehen.

• citations – Ein Container in citationsContent, der den Ort eines Zitats enthält.

• location – Ein Container in citations, der die Quelle eines Zitats enthält.

• web – Ein Container in location, der Onlinequellen-Details enthält.

• url – Die vollständige Webadresse (URL) der Quelle des Zitats.

• domain – Die Root-Domain der Quell-url.

Schutzmaßnahmen beim Grounding

Ihre Daten verlassen niemals die AWS Infrastruktur. Modellgenerierte Abfragen verbleiben innerhalb der AWS Dienste und werden niemals an das breitere Internet gesendet. Unser umfangreicher interner Web-Suchindex und unsere Wissensdiagramme priorisieren vertrauenswürdige und hochwertige Quellen und filtern schädliche Inhalte beim Eingang heraus. Web Grounding verfeinert die Informationen zur Laufzeit durch Querverweise aus mehreren Quellen weiter. Schließlich schützen wir Ihre Anwendung mit Laufzeitfilterung vor indirekter Promptinjektion und Fehlinformationen (bitte beachten Sie, dass diese Schutzmaßnahme für nicht-englische Sprachen eingeschränkt ist).

Fehlerbehandlung

Fügen Sie dem Namen nova_grounding keinen toolSpec-Eintrag hinzu. Wenn Sie ein Tool mit diesem Namen hinzufügen, führt das zu einem Fehler.

Im Folgenden finden Sie eine Liste potenzieller Fehler, die auftreten können, wenn Sie Web Grounding verwenden:

• malformed_tool_use

• max_tokens

• malformed_model_output

Debugging-Tool-Zugriff

Um sicherzustellen, dass Ihre Rolle auf Web Grounding on AWS Bedrock zugreifen kann, haben Sie zwei Möglichkeiten:

1. BedrockFullAccess Aktivieren Sie dies für Ihre IAM-Rolle: Wenn Ihre Rolle dies getan hat BedrockFullAccess, hat sie automatisch Zugriff auf Web Grounding.

2. Spezifische Berechtigungen hinzufügen (falls erforderlich): Wenn Sie eine detailliertere Zugriffskontrolle benötigen, fügen Sie diese Richtlinie der IAM-Richtlinie Ihrer Rolle hinzu und ersetzen Sie den roten Text durch Ihre Konto-ID: AWS

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

Für Web Grounding ist der Bedingungs-Schlüssel „aws:requestedRegion“ auf „nicht spezifizert“ gesetzt. Wenn Ihre bestehenden Richtlinien oder Service Control-Richtlinien (SCPs) diese Bedingung durchsetzen, können Zugriffsprobleme auftreten. Dieses Problem kann durch eine Aktualisierung der Bedingung behoben werden, sodass eine „nicht spezifizierte“ requestedRegion zulässig ist.

Wichtig

Wenn Sie das Web-Grounding-Tool aktivieren, sind Sie für Ihre Nutzung und die Nutzung durch Ihre Endnutzer von Ausgaben verantwortlich, die begründete Informationen enthalten. Anhand von Zitaten oder Links zum Quellenmaterial wissen Sie, dass Ihre Ausgabe fundierte Informationen enthält. Sie müssen diese Zitate und Links in den Ausgabedaten, die Sie Ihren Endnutzern zur Verfügung stellen, beibehalten und anzeigen.

Anmerkung

Web Grounding ist mit zusätzlichen Kosten verbunden. Weitere Informationen finden Sie unter https://aws.amazon.com//bedrock/pricing/