Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Pembumian Web

Web Grounding memungkinkan Amazon Nova untuk mencari web untuk informasi terkini dan memberikan tanggapan dengan kutipan. Fitur ini berguna untuk kueri yang membutuhkan up-to-date informasi di luar data pelatihan model.

Bagaimana Web Grounding bekerja

Ketika Web Grounding diaktifkan untuk prompt, langkah-langkah berikut dilakukan:

Cara menggunakan Web Grounding

Untuk contoh lengkap kode yang menggunakan Web Grounding, lihat bagian Sampel Kode.

Untuk menyertakan Web Grounding dalam hasil Anda, tentukan systemTool parameter berikut di blok ToolConfig Anda:

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)

Ketersediaan wilayah

Web Grounding saat ini hanya tersedia di wilayah AS dan hanya didukung oleh profil CRIS AS.

Struktur respons

Berikut ini adalah contoh respons. Tanggapan telah dipersingkat untuk singkatnya:

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

Setiap kutipan meliputi:

Keamanan grounding

Data Anda tidak pernah meninggalkan AWS infrastruktur. Kueri yang dihasilkan model tetap berada dalam AWS layanan dan tidak pernah dikirim ke internet yang lebih luas. Indeks pencarian web internal dan grafik pengetahuan kami yang luas memprioritaskan sumber yang dapat dipercaya dan berkualitas tinggi serta menyaring konten berbahaya saat masuk. Terakhir, kami melindungi aplikasi Anda dari injeksi prompt tidak langsung dan informasi yang salah dengan pemfilteran runtime (perhatikan bahwa mitigasi ini terbatas untuk bahasa non-Inggris).

Penanganan kesalahan

Jangan menyertakan toolSpec entri dengan namanova_grounding. Menyertakan alat dengan nama ini akan mengakibatkan kesalahan.

Berikut ini adalah daftar potensi kesalahan yang dapat terjadi saat menggunakan Web Grounding:

Izin diperlukan untuk alat bawaan

Untuk memastikan peran Anda dapat mengakses Web Grounding di Amazon Bedrock, Anda memiliki dua opsi:

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

Web Grounding memiliki kunci aws:requestedRegion kondisi yang disetel ke “tidak ditentukan”. Jika kebijakan yang ada atau Kebijakan Kontrol Layanan (SCPs) memberlakukan kondisi ini, Anda mungkin mengalami masalah akses. Memperbarui kondisi untuk mengizinkan requestedRegion “tidak ditentukan” dapat menyelesaikan masalah ini.