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

Pencarian 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. Pengambilan dari web eksternal hanya terjadi jika permintaan Anda dan izin IAM Anda mengizinkannya.

Tata kelola data

Untuk menjaga pengambilan dalam AWS batas sambil tetap mengizinkan konten halaman yang di-cache, set external_web_access el ke. false Pencarian kemudian disajikan dari indeks web Amazon Bedrock dan Fetch disajikan dari cache Amazon Bedrock.

AmazonBedrockFullAccessKebijakan ini memberikan Search and Fetch tetapi tidakbedrock-websearch:ExternalWebAccess. Karena external_web_access defaultnyatrue, menghilangkan parameter dengan kebijakan ini menyebabkan setiap upaya Fetch gagal dalam pemeriksaan otorisasi backend sebelum cache dibaca. Permintaan Responses API secara keseluruhan masih dapat diselesaikan menggunakan pengamatan Penelusuran, tetapi Fetch tidak memberikan kontribusi konten halaman. Secara eksplisit mengatur parameter untuk false menghindari kegagalan ini dan menjaga pengambilan dalam AWS batas. 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:

Pencarian selalu dilayani dari indeks web Amazon Bedrock. external_web_accessParameter di Responses API dan izin bedrock-websearch:ExternalWebAccess IAM mengatur apakah Fetch dapat menggunakan web eksternal setelah cache hilang. 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. Di Wilayah AS komersial, 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. Di AWS GovCloud (AS), ini didukung padaopenai.gpt-5.6-terra,openai.gpt-5.6-luna, danopenai.gpt-5.4. Contoh dalam panduan ini digunakanopenai.gpt-5.6-terra. Untuk harga Pencarian Web, lihat halaman harga Amazon Bedrock.

Ketersediaan wilayah

Pencarian Web memproses kueri di wilayah. Lihat ketersediaan saat ini di bawah ini.

Amerika Serikat

AWS GovCloud (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

Kontrol ukuran konteks pencarian

Gunakan search_context_size untuk mengontrol berapa banyak konteks setiap panggilan Pencarian dapat kembali ke model. Nilai yang didukung adalah:

Pengamatan berisi judul, URL, dan cuplikan konten. Anggaran dibagikan ketika panggilan Pencarian berisi beberapa kueri, dan layanan dapat mengembalikan pengamatan lebih sedikit daripada maksimum. Pengaturan yang lebih besar dapat meningkatkan token input model dan biaya inferensi terkait. Parameter ini tidak membatasi berapa banyak panggilan Pencarian yang dapat dilakukan model.

tools=[{
    "type": "web_search",
    "search_context_size": "low",
    "external_web_access": False,
}]

Mengontrol akses web eksternal

Pencarian dilayani dari indeks web Amazon Bedrock. Apakah Fetch dapat mengambil konten halaman dari web eksternal setelah cache hilang 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 external_web_access yang tidak disimpan ExternalWebAccess gagal dalam pemeriksaan otorisasi backend untuk setiap upaya Fetch sebelum cache dibaca. Permintaan API Tanggapan pemanggil masih dapat mengembalikan HTTP200: model dapat terus menggunakan pengamatan Pencarian dan mengembalikan url_citation anotasi. Respons model tidak dijamin untuk mengungkapkan kegagalan Fetch, dan keberadaan kutipan tidak berarti halaman yang dikutip diambil. Pang InvokeFetch gilan yang ditolak terlihat CloudTrail saat pencatatan peristiwa data Penelusuran Web diaktifkan. Untuk detailnya, lihat Monitor Penelusuran Web.

Pilih salah satu konfigurasi berikut untuk Fetch.

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 hibahInvokeFetch, Fetch yang di-cache terus berfungsi. Tetapkan parameter secara eksplisit; jangan mengandalkan penghilangan izin saat meninggalkan parameter pada defaultnyatrue, karena konfigurasi itu menyebabkan upaya Fetch gagal.

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 ke identitas permintaan dan setel external_web_access ketrue. Jalur kebijakan terkelola paling sederhana adalah melampirkan salah satu atauAmazonBedrockExternalWebSearchReadOnly. AmazonBedrockExternalWebSearchFullAccess Versi kebijakan ini saat ini memberikan tiga tindakan Penelusuran Web yang sama pada sumber daya yang sama, sehingga kebijakan tersebut memungkinkan pengambilan eksternal. Untuk detailnya, lihat Kebijakan terkelola.

Dengan konfigurasi ini, Search terus menggunakan indeks web Amazon Bedrock. Fetch memeriksa cache Amazon Bedrock terlebih dahulu dan mengambil dari web eksternal hanya jika konten halaman yang sesuai tidak ada dalam cache. Ketika Fetch mencapai web eksternal, data permintaan Anda mungkin meninggalkan AWS batas. Pengambilan eksternal hanya berlaku ketika Anda berdua memberikan izin dan membiarkan parameter diaktifkan.

Menggunakan Pencarian Web dengan Codex

Codex, agen pengkodean OpenAI, terhubung ke Amazon Bedrock melalui bedrock-mantle titik akhir dan dapat menggunakan Pencarian Web pada model yang didukung. Pencarian Web tersedia di aplikasi desktop Codex dan versi CLI 0.147.0 atau yang lebih baru.

Menggunakan Pencarian Web dengan Codex tidak memerlukan pengaturan IAM tambahan di luar izin Pencarian Web standar. Identitas IAM di balik kunci API Anda harus diizinkan untuk memanggil tindakan Pencarian Web bedrock-websearch:InvokeSearch danbedrock-websearch:InvokeFetch. Tindakan ini diberikan oleh AmazonBedrockFullAccess kebijakan. Untuk izin dan contoh kebijakan yang diperlukan, lihat Identitas dan manajemen akses untuk Penelusuran Web.

Pada model Amazon Bedrock yang didukung, Codex menggunakan Penelusuran Web khusus teks, mengembalikan judul, URL, dan cuplikan konten dari indeks dan cache web Amazon Bedrock. Codex ditetapkan external_web_access false pada setiap permintaan, sehingga data permintaan Anda tetap berada dalam AWS batas. Lihat perinciannya di Mengontrol akses web eksternal.

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.

Kutipan dapat didasarkan pada pengamatan Pencarian bahkan ketika Fetch tidak mengambil halaman lengkap. Jangan gunakan kehadiran kutipan untuk menentukan apakah konten berasal dari cache Amazon Bedrock atau web eksternal. Untuk mengaudit hasil Fetch dan sumber pengambilan, gunakan fetchedSources bidang di. CloudTrail Untuk detailnya, lihat Monitor Penelusuran Web.

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.