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

Alat Pencarian Web

Agen AI mengubah cara organisasi berinteraksi dengan informasi, tetapi mereka menghadapi batasan mendasar: pengetahuan mereka dibekukan pada waktu pelatihan. Ketika pengguna bertanya tentang harga saham hari ini atau rilis perangkat lunak yang dikirim satu jam yang lalu, agen yang hanya mengandalkan data pelatihannya tidak dapat memberikan jawaban yang akurat.

Membangun integrasi pencarian web khusus untuk mengatasi hal ini sangat mahal — pengadaan API pencarian pihak ketiga, mengelola kunci dan kuota serta batas tarif, mengurai format hasil yang tidak konsisten di seluruh penyedia, membangun logika ekstraksi cuplikan sehingga model mendapatkan bagian yang relevan alih-alih HTML mentah, beralasan tentang ke mana permintaan pelanggan bepergian dan bagaimana data dapat disimpan, dan menjaga kesegaran dan cakupan dari waktu ke waktu. Masing-masing adalah proyek tersendiri.

Alat Pencarian Web di Amazon Bedrock AgentCore menghilangkan kerumitan itu. Ini adalah kemampuan pencarian MCP-compliant web yang dikelola sepenuhnya yang memungkinkan agen Anda mengambil informasi dari web tanpa biaya infrastruktur apa pun. Ini tersedia sebagai konektor terkelola yang Anda sambungkan ke AgentCore Gateway Anda. Agen menemukannya dengan tools/list panggilan standar dan memanggilnya seperti alat Protokol Konteks Model lainnya. Tidak ada API pencarian untuk disediakan, tidak ada kredentif keluar untuk dikelola, dan tidak ada lem penguraian hasil untuk dipertahankan.

Bagian berikut membahas kemampuan utama, arsitektur indeks web yang dibuat khusus, jaminan privasi, kasus penggunaan, dan cara mengatur Alat Penelusuran Web.

Kemampuan utama

Purpose-built indeks web

Banyak solusi yang menambahkan pencarian web ke agen adalah pembungkus melalui mesin pencari pihak ketiga. Alat Pencarian Web di Amazon Bedrock AgentCore berbeda — didukung oleh indeks web yang dibuat dan dioperasikan Amazon secara langsung.

Pribadi berdasarkan desain

Bagi banyak perusahaan, pertanyaan yang menghambat peluncuran pencarian web bukanlah “apakah itu berhasil” - melainkan “ke mana permintaan pengguna saya pergi, dan apa yang terjadi pada mereka?” Alat Pencarian Web dibangun sehingga jawaban itu mudah.

Cara kerjanya

Alat Pencarian Web adalah konektor bawaan. Gateway menangani manajemen skema, tata kelola parameter, resolusi titik akhir, dan otentikasi layanan.

Kasus penggunaan

Menyiapkan Alat Pencarian Web

Untuk petunjuk tentang cara membuat Target Gateway dengan konfigurasi konektor Alat Pencarian Web, termasuk contoh penyiapan menggunakan Python SDK dan CLI, lihat Mengatur Alat Pencarian Web di panduan konfigurasi target.

Gunakan dengan harness

Untuk memberikan kemampuan pencarian web AgentCore harness, lampirkan gateway yang Anda buat di Set up Web Search Tool ke harness sebagai agentcore_gateway alat. Peran eksekusi harness memerlukan bedrock-agentcore:InvokeGateway izin pada gateway ARN. Untuk panduan ujung ke ujung, lihat Alat dalam dokumentasi harness.

Konfigurasikan pemfilteran domain

Web Search Tool mendukung 2 lapisan penyaringan yang menyusun setiap permintaan:

Request-level filter menyusun dengan daftar pengecualian tingkat target dan menyertakan daftar:

Request-level filter tidak dapat mengganti daftar pengecualian tingkat target atau memperluas hasil di luar daftar sertakan tingkat target.

Untuk contoh dan detail konfigurasi, lihat Meng konfigurasi pemfilter an domain di panduan konfigurasi target.

Konfigurasikan Peran Layanan Gateway

Gateway memerlukan peran layanan yang memungkinkan AgentCore layanan melakukan tindakan atas nama Anda. Untuk izin IAM yang diperlukan dan konfigurasi kebijakan, lihat Meng onfigurasi Peran Layanan Gateway di panduan konfigurasi target.

Skema masukan

Alat Pencarian Web menerima skema input berikut saat dipanggil melaluitools/call. Bid filters ang hanya tersedia ketika target disematkan ke versi konektor 1.2.0 atau yang lebih baru. Pada versi sebelumnya, skema hanya mengekspos query danmaxResults.

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "description": "The search query string",
        "type": "string"
      },
      "maxResults": {
        "description": "Maximum number of results to return. Valid range: 1-25. Defaults to 10.",
        "type": "integer"
      },
      "filters": {
        "description": "Optional request-level filters (connector version 1.2.0+). Applied on top of the target-level exclude list and include list.",
        "type": "object",
        "properties": {
          "domainFilter": {
            "description": "Per-call domain filter. Include and exclude lists each hold up to 100 domains. Root domain matches subdomains.",
            "type": "object",
            "properties": {
              "include": {
                "description": "Restrict results to these domains.",
                "type": "array",
                "items": {"type": "string"}
              },
              "exclude": {
                "description": "Drop results from these domains.",
                "type": "array",
                "items": {"type": "string"}
              }
            }
          },
          "publishedDateFilter": {
            "description": "Per-call published-date filter. Bounds inclusive, ISO-8601 UTC. Applies to web results only.",
            "type": "object",
            "properties": {
              "from": {
                "description": "Earliest publication date (ISO-8601 UTC).",
                "type": "string"
              },
              "to": {
                "description": "Latest publication date (ISO-8601 UTC).",
                "type": "string"
              }
            }
          }
        }
      }
    },
    "required": ["query"]
  }
}

Format respons

Alat Penelusuran Web mengembalikan hasil dalam MCP-compliant format berikut:

{
  "isError": false,
  "content": [
    {
      "type": "text",
      "text": "{\"id\":\"824f89d0\",\"results\":[{\"text\":\"Python 3.13 was released on October 7, 2024, featuring improvements to the interactive interpreter, experimental free-threaded mode, and a preliminary JIT compiler...\",\"publishedDate\":\"2024-10-07\",\"url\":\"https://example.com/python/releases/3.13\",\"title\":\"Python 3.13 Release Highlights\"}]}"
    }
  ]
}

Ketersediaan

Konektor Alat Pencarian Web tersedia di Wil AWS ayah berikut:

Karena Amazon mengoperasikan tumpukan pencarian penuh, peningkatan kesegaran, cakupan, relevansi, dan kualitas cuplikan mengalir ke agen Anda secara otomatis melalui konektor terkelola yang sama. Tidak ada peningkatan versi atau migrasi yang diperlukan di pihak Anda.

Penggunaan yang dapat diterima

Jika Anda menggunakan Alat Penelusuran Web, Anda bertanggung jawab atas penggunaan Anda, dan penggunaan apa pun oleh pengguna akhir Anda, atas konten yang diambil dari Alat Penelusuran Web (“Hasil Pencarian”). Anda harus menyimpan dan menampilkan kutipan sumber dan tautan yang disediakan dengan setiap Hasil Penelusuran dalam output apa pun yang Anda tampilkan kepada pengguna akhir yang menggunakan Hasil Penelusuran. Anda tidak boleh menggunakan Alat Penelusuran Web untuk (a) mengekstrak, menyimpan, atau mereproduksi konten dari Hasil Pencarian secara massal, atau (b) membangun atau mengisi indeks atau database yang bersaing.