Respons pembumian dengan hasil pencarian real-time

catatan

Dokumentasi ini untuk Amazon Nova Versi 1. Untuk informasi tentang penggunaan Web Grounding dengan Amazon Nova 2, kunjungi Web Grounding.

Web Grounding meningkatkan model Nova dengan menghubungkannya ke informasi real-time di luar batas pengetahuan mereka, yang menghasilkan respons yang lebih akurat dan andal.

Bagaimana Web Grounding bekerja

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

1. Permintaan Konfigurasi - Aplikasi Anda mengirimkan prompt pengguna ke Amazon Bedrock API dengan nova_grounding diaktifkan sebagai SystemTool.

2. Penilaian Pencarian — Model menganalisis prompt dan menentukan apakah pencarian diperlukan untuk meningkatkan respons.

3. Eksekusi Pencarian — Bila diperlukan, model secara otomatis melakukan satu atau lebih pencarian untuk informasi yang relevan.

4. Analisis Hasil — Model memutuskan apakah pencarian tambahan diperlukan, untuk memperluas pemahamannya atau menyelam lebih dalam pada subtopik tertentu.

5. Response Generation — Nova secara otomatis mensintesis informasi dari hasil pencarian untuk menghasilkan respons API akhir yang didasarkan pada informasi real-time, lengkap dengan kutipan ke sumbernya.

Cara menggunakan Web Grounding

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

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

Di AndatoolConfig, tambahkan alat dengan systemTool parameter seperti pada contoh di atas. Parameter ini memungkinkan Anda untuk menentukan alat yang ditentukan sistem. Alat yang ditentukan sistem adalah alat yang disediakan dan dipanggil oleh penyedia model. Untuk detail tentang penggunaan systemTool parameter, lihat SystemTooldi referensi Amazon Bedrock API.

catatan

Web Grounding hanya tersedia di wilayah AS. Anda dapat menggunakan Web Grounding dengan memanggil Amazon Nova Premier dengan profil inferensi lintas wilayah. us.amazon.nova-premier-v1:0

Contoh berikut adalah perintah AWS CLI menggunakan 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?"}]}]'

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

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

Respons ini berisi dua komponen: teks yang dihasilkan oleh model dan informasi kutipan untuk teks itu. Elemen yang disertakan adalah:

• text— Segmen dari respons yang dihasilkan model.

• citationsContent— Wadah utama untuk data kutipan yang terkait dengan text segmen.

• citations— Sebuah wadah di dalamnya citationsContent yang menyimpan lokasi kutipan.

• location— Sebuah wadah di dalamnya citations yang menyimpan sumber kutipan.

• web— Sebuah wadah di dalamnya location yang menyimpan detail sumber web.

• url— Alamat web lengkap (URL) dari sumber kutipan.

• domain— Domain root dari sumberurl.

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. Web Grounding lebih lanjut menyempurnakan informasi saat runtime dengan referensi silang dari berbagai sumber. 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 sertakan 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:

• malformed_tool_use

• max_tokens

• malformed_model_output

Akses Alat Debugging

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

1. BedrockFullAccess Aktifkan peran IAM Anda: Jika peran Anda memiliki BedrockFullAccess, itu akan memiliki akses secara otomatis ke Web Grounding.

2. Tambahkan Izin Khusus (jika diperlukan): Jika Anda memerlukan kontrol akses yang lebih terperinci, tambahkan kebijakan ini ke kebijakan IAM peran Anda, ganti teks merah dengan ID akun Anda AWS :

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

Web Grounding memiliki kunci kondisi AWS:requestedRegion 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.

penting

Jika Anda mengaktifkan alat Pembumian Web, Anda bertanggung jawab atas penggunaan Anda, dan penggunaan apa pun oleh pengguna akhir Anda, dari output yang menggabungkan informasi yang dibumikan. Anda akan tahu kapan output Anda menyertakan informasi yang dibumikan dari kutipan atau tautan ke materi sumber. Anda harus menyimpan dan menampilkan kutipan dan tautan ini dalam output yang Anda berikan kepada pengguna akhir Anda.

catatan

Web Grounding adalah biaya tambahan. Untuk informasi lebih lanjut lihat https://aws.amazon.com//bedrock/pricing/