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

Penelusuran Web

Pencarian Web adalah alat bawaan yang menyediakan kemampuan pencarian web di Amazon Bedrock. Saat Anda mengaktifkannya, model yang didukung dapat mengambil informasi terkini dari web selama permintaan dan menggunakannya untuk mendasarkan jawaban mereka, alih-alih hanya mengandalkan data yang dilatih. Tanggapan termasuk kutipan ke sumber yang digunakan model. Pencarian Web di-host dan dibangun oleh AWS, dan data Anda tetap berada dalam AWS batas secara default.

Tata kelola data

Secara default, saat menggunakan AmazonBedrockFullAccess kebijakan, Penelusuran Web disajikan dari indeks dan cache web Amazon Bedrock, dan data permintaan Anda tidak meninggalkan AWS batas untuk pengambilan. Anda juga dapat menggunakan IAM untuk menegakkan ini di tingkat kebijakan. Tergantung pada model yang Anda gunakan, data Anda tunduk pada Deteksi penyalahgunaan Amazon Bedrock mekanisme otomatis.

Kapan menggunakan Pencarian Web

Pencarian Web berguna ketika jawaban tergantung pada informasi yang lebih baru, lebih khusus, atau lebih otoritatif daripada pengetahuan parametrik model. Kebaruan adalah salah satu kasus umum: peristiwa terkini, rilis produk terbaru, harga, atau dokumentasi untuk versi pustaka baru. Ini sama bergunanya untuk pertanyaan panjang atau khusus di mana pengetahuan model tipis atau tidak tepat, seperti API khusus, nilai konfigurasi tertentu, atau fakta khusus domain, dan untuk kasus di mana Anda menginginkan sumber yang berdasar dan dapat dikutip daripada ingatan.

Cara kerja Penelusuran Web

Karena alat ini berjalan di dalam Amazon Bedrock, Anda tidak perlu meng-host indeks pencarian, mengelola crawler, atau menulis loop panggilan alat sendiri. Anda menambahkan alat ke permintaan inferensi Amazon Bedrock Anda, dan model memanggilnya sesuai kebutuhan. Pencarian Web memberikan informasi terkini ke model, memungkinkan model mengembalikan jawaban yang berdasar dengan kutipan.

Ketika Pencarian Web diaktifkan, model memutuskan apakah permintaan memerlukan informasi terkini. Jika ya, model mengeluarkan satu atau lebih kueri pencarian ke alat Pencarian Web dan menerima serangkaian pengamatan yang diambil dari indeks web yang dibangun dan dikelola oleh Amazon. Setiap pengamatan mencakup judul, URL sumber, dan cuplikan konten. Model kemudian menyusun jawaban yang didasarkan pada hasil tersebut dan menambahkan kutipan yang mengarah kembali ke sumber.

Jika kumpulan hasil pertama tidak cukup untuk menjawab pertanyaan, model dapat merumuskan kembali kuerinya menggunakan apa yang ditemukan dan mencari lagi dalam giliran yang sama. Ketika hasilnya tidak mendukung jawaban, model memberi tahu Anda alih-alih mengisi celah dari data pelatihannya.

Operasi Pencarian dan Ambil

Pencarian Web dibangun dari dua operasi:

Secara default, kedua operasi dilayani seluruhnya dari dalam batas AWS layanan menggunakan indeks dan cache web Amazon Bedrock, snapshot konten web yang dihosting di dalamnya AWS, daripada mengambil dari web langsung pada waktu permintaan. external_web_accessParameter di Responses API dan izin bedrock-websearch:ExternalWebAccess IAM mengatur apakah pencarian dan pengambilan dapat mencapai web eksternal secara langsung. Lihat perinciannya di Mengontrol akses web eksternal.

Model yang didukung

Pencarian Web tersedia untuk model OpenAI GPT yang disajikan melalui titik akhir Amazon Bedrock, menggunakan bedrock-mantle Responses API. Saat ini didukung pada GPT-5.6 keluarga - openai.gpt-5.6-solopenai.gpt-5.6-terra,, dan openai.gpt-5.6-luna - serta sebelumnya openai.gpt-5.4 danopenai.gpt-5.5. Contoh dalam panduan ini digunakanopenai.gpt-5.6-terra. Untuk harga Pencarian Web, lihat halaman harga Amazon Bedrock.

Ketersediaan wilayah

Penelusuran Web memproses kueri dalam wilayah di tiga Wilayah AS:

Pencarian Web benar-benar regional. Setiap Wilayah mengoperasikan tingkat pencarian dan pengambilan sendiri, dan kueri, pengambilan, data indeks, dan hasil tidak dirutekan di seluruh Wilayah. Kueri yang dikeluarkan di Wilayah tertentu tetap berada dalam batas Wilayah tersebut.

Aktifkan Pencarian Web

Untuk menggunakan Pencarian Web, identitas IAM di balik permintaan Anda harus diizinkan untuk memanggil tindakan Pencarian Web. Untuk izin dan contoh kebijakan yang diperlukan, lihat Identitas dan manajemen akses untuk Penelusuran Web.

Atur lingkungan Anda

Atur yang berikut sebelum menjalankan contoh:

export OPENAI_API_KEY="your-amazon-bedrock-api-key"
export OPENAI_BASE_URL="https://bedrock-mantle.us-west-2.api.aws/openai/v1"

Menambahkan alat Penelusuran Web ke permintaan

Untuk mengaktifkan Pencarian Web, tambahkan alat jenis web_search ke tools array dalam permintaan Anda. Model menggunakan alat hanya ketika menentukan permintaan membutuhkan informasi terkini. Untuk contoh yang dapat dijalankan, lihat. Contoh kode

Mengontrol akses web eksternal

Secara default, Pencarian Web dilayani seluruhnya dari indeks dan cache web Amazon Bedrock, dan tidak ada data permintaan yang meninggalkan AWS batas untuk pengambilan. Apakah pencarian dan pengambilan dapat mencapai web eksternal diatur oleh dua kontrol yang bekerja bersama: external_web_access parameter di Responses API dan izin bedrock-websearch:ExternalWebAccess IAM.

external_web_accessParameter default ketrue, cocok dengan OpenAI Responses API sehingga panggilan Anda tidak perlu berubah. AmazonBedrockFullAccessKebijakan ini memberikan tindakan Penelusuran Web dasar bedrock-websearch:InvokeFetch — bedrock-websearch:InvokeSearch dan — tetapi tidak memberikanbedrock-websearch:ExternalWebAccess. Akibatnya, permintaan yang keluar true dari identitas yang tidak disimpan ExternalWebAccess mengembalikan tanda centang 403 AccessDenied pada pemeriksaan otorisasi. external_web_access Model tidak gagal dalam permintaan: ia mendasarkan jawabannya di Pencarian dan cache Fetch dan melaporkan bahwa ia tidak dapat memperoleh akses web eksternal.

Untuk membuat permintaan yang tidak mencapai kesalahan ini, gunakan salah satu dari dua pendekatan di bawah ini.

Simpan permintaan dalam AWS batas

Atur "external_web_access": false pada alat. Ini tidak memerlukan ExternalWebAccess izin, pengambilan disajikan sepenuhnya dari indeks web Amazon Bedrock dan cache, dan data permintaan Anda tidak meninggalkan batas. AWS Karena AmazonBedrockFullAccess tidak memberikanExternalWebAccess, konfigurasi ini aman secara default.

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="Summarize recent guidance on AWS Lambda cold starts.",
    tools=[{"type": "web_search", "external_web_access": False}],
)

curl "https://bedrock-mantle.us-west-2.api.aws/openai/v1/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai.gpt-5.6-terra",
    "input": "Summarize recent guidance on AWS Lambda cold starts.",
    "tools": [{"type": "web_search", "external_web_access": false}]
  }'

Aktifkan akses web eksternal

Ber bedrock-websearch:ExternalWebAccess ikan identitas permintaan dan biarkan external_web_access pada defaultnyatrue. Konfigurasi ini mengatur apakah pencarian dan pengambilan dapat mencapai web eksternal. Saat ini, pengambilan disajikan seluruhnya dari indeks web Amazon Bedrock dan cache, jadi tidak ada data permintaan yang meninggalkan AWS batas bahkan ketika izin ini diberikan. Dalam rilis mendatang, konfigurasi ini memungkinkan pencarian dan pengambilan untuk mengambil konten dari web eksternal langsung, di mana data permintaan dapat meninggalkan AWS batas. Akses web eksternal dinonaktifkan secara default (bedrock-websearch:ExternalWebAccessyaitu, tidak diizinkan), dan setiap perubahan di masa mendatang akan memerlukan izin bedrock-websearch:ExternalWebAccess sebagai opt-in eksplisit sebelum berlaku. Akses web eksternal tetap di bawah kendali Anda: ini berlaku hanya karena Anda memberikan izin dan membiarkan parameter diaktifkan.

Contoh kode

API Tanggapan

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
)

print(response.output_text)

Tanggapan mencakup teks jawaban yang didasarkan bersama dengan url_citation anotasi yang mengarah kembali ke sumber:

{
  "content": [
    {
      "annotations": [
        {
          "end_index": 573,
          "start_index": 441,
          "title": "Upgrade Amazon EKS clusters with confidence using Kubernetes version rollbacks | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/upgrade-amazon-eks-clusters-with-confidence-using-kubernetes-version-rollbacks/"
        },
        {
          "end_index": 1094,
          "start_index": 888,
          "title": "AWS Weekly Roundup: AWS Builder Center at 1 year, Network Scanning in Security Hub, Loom for AWS, and more (July 13, 2026) | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/aws-weekly-roundup-aws-builder-center-at-one-year-network-scanning-in-security-hub-loom-for-aws-and-more-july-13-2026/"
        },
        {
          "end_index": 1837,
          "start_index": 1414,
          "title": "AWS Weekly Roundup: One-click Lambda setup prompt, OpenAI GPT-5.6 models on Bedrock, and more (July 20, 2026) | AWS News Blog",
          "type": "url_citation",
          "url": "https://aws.amazon.com/blogs/aws/aws-weekly-roundup-one-click-lambda-setup-prompt-openai-gpt-5-6-models-on-bedrock-and-more-july-20-2026/"
        }
      ],
      "logprobs": [],
      "text": "As of **July 30, 2026**, the most significant AWS launches this month:\n\n1. **Amazon EKS Kubernetes version rollbacks** — EKS now lets admins roll back a Kubernetes version upgrade within **seven days**, effectively adding an “undo” path for cluster upgrades and reducing upgrade risk for large or regulated Kubernetes fleets. It’s available at no additional cost in commercial Regions where EKS is available. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/upgrade-amazon-eks-clusters-with-confidence-using-kubernetes-version-rollbacks/))\n\n2. **AWS Security Hub Network Scanning + Azure support** — Security Hub added active Network Scanning to find resources actually reachable from the public internet, and also expanded unified security management to **Microsoft Azure** resources, making this a notable multi-cloud security/posture-management move. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/aws-weekly-roundup-aws-builder-center-at-one-year-network-scanning-in-security-hub-loom-for-aws-and-more-july-13-2026/))\n\n3. **New frontier models on Amazon Bedrock: Claude Sonnet 5, Claude Opus 5, and OpenAI GPT-5.6 models** — AWS added major new model choices to Bedrock this month: Anthropic’s Claude Sonnet 5 and Claude Opus 5, plus OpenAI GPT-5.6 Sol, Terra, and Luna, expanding Bedrock’s role as a multi-model enterprise AI platform. ([aws.amazon.com](https://aws.amazon.com/blogs/aws/aws-weekly-roundup-one-click-lambda-setup-prompt-openai-gpt-5-6-models-on-bedrock-and-more-july-20-2026/))",
      "type": "output_text"
    }
  ],
  "id": "msg_dcda8e4b477f5a1d96bfbcadefef7a77",
  "phase": "final_answer",
  "role": "assistant",
  "status": "completed",
  "type": "message"
}

Permintaan HTTPS langsung

Jika Anda tidak menggunakan OpenAI SDK, kirim permintaan langsung ke titik akhir Respons. Bid tools ang ini membawa alat Pencarian Web.

curl "https://bedrock-mantle.us-west-2.api.aws/openai/v1/responses" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai.gpt-5.6-terra",
    "input": "What are the most significant AWS launches announced this month?",
    "tools": [{"type": "web_search", "external_web_access": false}]
  }'

Membaca kutipan dari tanggapan

Pencarian Web mengembalikan kutipan sebagai url_citation anotasi yang dilampirkan pada teks. Setiap anotasi membawa judul sumber dan URL dan rentang karakter dalam jawaban yang didukungnya. Pertahankan dan tampilkan ini kepada pengguna akhir.

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
)

# The grounded answer
print(response.output_text)

# The sources behind it
for item in response.output:
    if item.type == "message":
        for block in item.content:
            if block.type == "output_text":
                for ann in block.annotations:
                    if ann.type == "url_citation":
                        print(f"- {ann.title}: {ann.url}")

Jika Anda bekerja dengan JSON mentah (misalnya, dari panggilan HTTPS langsung), data yang sama berada dioutput[].content[].annotations[]:

jq '.output[] | select(.type=="message") | .content[]
      | select(.type=="output_text") | .annotations[]
      | select(.type=="url_citation") | {title, url, start_index, end_index}' response.json

Streaming tanggapan

Responses API mengalirkan jawaban saat dihasilkan. Teks tiba sebagai response.output_text.delta peristiwa, dan setiap kutipan tiba sebagai response.output_text.annotation.added peristiwa sebagai model mendasari pernyataan.

from openai import OpenAI

client = OpenAI()

stream = client.responses.create(
    model="openai.gpt-5.6-terra",
    input="What are the most significant AWS launches announced this month?",
    tools=[{"type": "web_search", "external_web_access": False}],
    stream=True,
)

for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
    elif event.type == "response.output_text.annotation.added":
        ann = event.annotation
        print(f"\n[source] {ann['title']}: {ann['url']}")

Di atas kawat, acara anotasi terlihat seperti ini:

event: response.output_text.annotation.added
data: {"type":"response.output_text.annotation.added","annotation":{"type":"url_citation","title":"News and Updates from the July 2025 Pokémon Presents","url":"https://www.pokemon.com/us/pokemon-news/...","start_index":589,"end_index":698},"annotation_index":2,"content_index":0,"item_id":"msg_...","output_index":1}

Keamanan

Pencarian Web di Amazon Bedrock menggunakan AWS Identity and Access Management (IAM) untuk mengontrol siapa yang dapat menjalankan pencarian dan pengambilan dan di Wilayah mana. Awalan layanan IAM untuk Pencarian Web adalahbedrock-websearch. Untuk daftar lengkap tindakan, kebijakan terkelola, kunci kondisi, kebijakan contoh, dan kontrol administrator untuk menonaktifkan Pencarian Web, lihat Identitas dan manajemen akses untuk Penelusuran Web.

Pemantauan CloudTrail dengan

Pencarian Web di Amazon Bedrock terintegrasi dengan AWS CloudTrail. CloudTrail menangkap aktivitas API untuk Pencarian Web sebagai peristiwa data, sehingga Anda dapat mengaudit siapa yang memanggil alat, kapan, dan dari mana. Untuk bidang yang diambil, cara mengaktifkan pencatatan peristiwa data, dan apa yang sengaja dikecualikan, lihat Meman tau Penelusuran Web.

Penggunaan yang dapat diterima

Jika Anda menggunakan Pencarian Web di Amazon Bedrock, Amazon Bedrock menyediakan hasil Penelusuran Web (“Hasil Pencarian”) ke model yang didukung, yang dapat digunakan model untuk menghasilkan responsnya. Anda bertanggung jawab atas penggunaan Anda, dan penggunaan apa pun oleh pengguna akhir Anda, dari keluaran model yang menggabungkan Hasil Pencarian. Anda harus mempertahankan dan menampilkan kutipan sumber dan tautan yang disediakan dalam keluaran model dalam output apa pun yang Anda tampilkan kepada pengguna akhir Anda. Anda tidak boleh menggunakan Penelusuran Web untuk (a) mengekstrak, menyimpan, atau mereproduksi konten dari Hasil Pencarian secara massal, atau (b) membangun atau mengisi indeks atau database yang bersaing.