Penentuan Dasar dengan Pencarian Bing

2025-06-16

Grounding dengan Bing Search memungkinkan Agen Azure AI Anda untuk menggabungkan data web publik real-time saat menghasilkan respons. Anda perlu membuat Grounding dengan sumber daya Pencarian Bing, lalu menyambungkan sumber daya ini ke Agen Azure AI Anda. Saat pengguna mengirim kueri, Agen Azure AI memutuskan apakah Grounding dengan Pencarian Bing harus dimanfaat atau tidak. Jika demikian, Bing akan dimanfaatkan untuk mencari melalui data web publik dan mengembalikan potongan yang relevan. Terakhir, Agen Azure AI akan menggunakan potongan yang dikembalikan untuk menghasilkan respons.

Anda dapat mengajukan pertanyaan seperti "apa berita teratas hari ini" atau "apa pembaruan terbaru di industri ritel di AS?", yang memerlukan data publik real-time.

Pengembang dan pengguna akhir tidak memiliki akses ke konten mentah yang dikembalikan dari Grounding dengan Bing Search. Namun, respons model menyertakan kutipan dengan tautan ke situs web yang digunakan untuk menghasilkan respons, dan tautan ke kueri Bing yang digunakan untuk pencarian. Anda dapat mengambil respons model dengan mengakses data di utas yang dibuat. Kedua referensi ini harus dipertahankan dan ditampilkan dalam bentuk persis yang disediakan oleh Microsoft, sesuai dengan Grounding dalam Persyaratan Penggunaan dan Tampilan Bing Search. Lihat bagian Cara menampilkan Grounding dengan hasil Pencarian Bing untuk detailnya.

Penting

Penggunaan Grounding Anda dengan Bing Search dapat dikenakan biaya. Lihat halaman harga untuk detailnya.
Dengan membuat dan menggunakan sumber daya Grounding pada Bing Search melalui pengalaman code-first seperti Azure CLI, atau mengimplementasikan melalui templat penyebaran, Anda setuju untuk terikat oleh dan mematuhi persyaratan yang tersedia di https://www.microsoft.com/en-us/bing/apis/grounding-legal, yang mungkin diperbarui dari waktu ke waktu.
Saat Anda menggunakan Grounding dengan layanan Pencarian Bing, data pelanggan Anda ditransfer ke luar batas kepatuhan Azure ke layanan Grounding dengan Pencarian Bing. Grounding dengan Bing Search tidak tunduk pada istilah pemrosesan data yang sama (termasuk lokasi pemrosesan) dan tidak memiliki standar kepatuhan dan sertifikasi yang sama dengan Azure AI Foundry Agent Service, seperti yang dijelaskan dalam Grounding dengan Ketentuan Penggunaan Pencarian Bing. Anda bertanggung jawab untuk menilai apakah penggunaan Grounding dengan Bing Search di agen Anda memenuhi kebutuhan dan persyaratan Anda.

Cara kerja Grounding dengan Bing Search

Kueri pengguna adalah pesan yang dikirim pengguna akhir ke agen, seperti "haruskah saya membawa payung dengan saya hari ini? Aku di Seattle." Instruksinya adalah pesan sistem yang dapat diberikan pengembang untuk berbagi konteks dan memberikan instruksi ke model AI tentang cara menggunakan berbagai alat atau perilaku.

Saat pengguna mengirim kueri, penyebaran model AI pelanggan terlebih dahulu memprosesnya (menggunakan instruksi yang disediakan) untuk kemudian melakukan kueri pencarian Bing (yang terlihat oleh pengembang). Penerapan Bing menghasilkan hasil pencarian yang relevan untuk penerapan model pelanggan, yang kemudian menghasilkan keluaran akhir.

Nota

Saat menggunakan Grounding dengan Bing Search, hanya kueri pencarian Bing, parameter alat, dan kunci sumber daya Anda yang dikirim ke Bing, dan tidak ada informasi khusus pengguna akhir yang disertakan. Kunci sumber daya Anda dikirim ke Bing semata-mata untuk tujuan penagihan dan pembatasan tarif.

Otorisasi akan terjadi antara Grounding dengan layanan Bing Search dan Azure AI Foundry Agent Service. Setiap kueri pencarian Bing yang dihasilkan dan dikirim ke Bing untuk tujuan dasar ditransfer, bersama-sama dengan kunci sumber daya, ke layanan Grounding dengan Bing Search di luar batas kepatuhan Azure. Grounding menggunakan Bing Search tunduk pada ketentuan Bing dan tidak memiliki standar kepatuhan dan sertifikasi yang sama dengan Azure AI Foundry Agent Service, seperti yang dijelaskan dalam Ketentuan Penggunaan Grounding dengan Pencarian Bing. Anda bertanggung jawab untuk menilai apakah penggunaan Grounding dengan Bing Search di agen Anda memenuhi kebutuhan dan persyaratan Anda.

Kemampuan yang didukung dan masalah yang diketahui

Grounding menggunakan alat Bing Search dirancang untuk mengambil informasi real-time dari web, bukan domain web tertentu.
TIDAK Disarankan untuk meringkas seluruh halaman web.
Dalam satu proses, model AI akan mengevaluasi output alat dan dapat memutuskan untuk memanggil alat lagi untuk informasi dan konteks lebih lanjut. Model AI juga dapat memutuskan bagian output alat mana yang digunakan untuk menghasilkan respons.
Layanan Azure AI Agent akan mengembalikan respons yang dihasilkan model AI sebagai output sehingga latensi end-to-end akan terpengaruh sebelum/pasca-pemrosesan LLM.
Grounding dengan alat Bing Search TIDAK mengembalikan output alat kepada pengembang dan pengguna akhir.

Dukungan penggunaan

Dukungan untuk Fasilitas Azure AI	Python SDK	C# SDK	JavaScript SDK	REST API	Penyiapan agen dasar	Pengaturan agen standar
✔️	✔️	✔️	✔️	✔️	✔️	✔️

Pengaturan

Nota

Grounding dengan Bing Search berfungsi dengan semua model Azure OpenAI yang didukung Azure AI Foundry Agent Service, kecuali gpt-4o-mini, 2024-07-18.

Buat Agen Azure AI dengan mengikuti langkah-langkah dalam panduan mulai cepat.
Buat landasan menggunakan sumber daya Pencarian Bing. Anda harus memiliki peran owner atau contributor dalam langganan atau grup sumber daya Anda agar dapat membuatnya.
1. Anda dapat membuatnya di portal Azure, dan memilih bidang yang berbeda dalam formulir pembuatan. Pastikan Anda membuat Grounding ini dengan sumber daya Bing Search di grup sumber daya yang sama dengan Agen Azure AI, Proyek AI, dan sumber daya lainnya.
1. Anda juga dapat membuatnya dengan memanfaatkan pendekatan code-first. Jika demikian, Anda perlu mendaftarkan Bing Search secara manual sebagai penyedia sumber daya Azure. Anda harus memiliki izin guna melakukan operasi /register/action untuk penyedia sumber daya. Izin disertakan dalam peran Kontributor dan Pemilik.
```
    az provider register --namespace 'Microsoft.Bing'
```
Setelah membuat Grounding dengan sumber daya Bing Search, Anda dapat menemukannya di portal Azure. Navigasikan ke grup sumber daya tempat Anda membuat sumber daya, cari sumber daya Grounding dengan Bing Search yang telah Anda buat.

Parameter opsional

Saat menambahkan alat Grounding with Bing Search ke agen, Anda dapat meneruskan parameter berikut. Parameter ini akan memengaruhi output alat Grounding with Bing Search, dan model AI mungkin tidak sepenuhnya menggunakan semua output. Lihat contoh kode untuk informasi tentang dukungan versi API dan cara meneruskan parameter ini.

Nama	Nilai	Tipe	Diperlukan
`count`	Jumlah hasil pencarian yang akan dikembalikan dalam respons. Defaultnya adalah 5 dan nilai maksimumnya adalah 50. Jumlah aktual yang dikirimkan mungkin kurang dari yang diminta. Dimungkinkan bagi beberapa halaman untuk menyertakan beberapa tumpang tindih dalam hasil. Parameter ini hanya memengaruhi hasil halaman web. Ada kemungkinan bahwa model AI mungkin tidak menggunakan semua hasil pencarian yang dikembalikan oleh Bing.	`UnsignedShort`	Tidak.
`freshness`	Saring hasil pencarian berdasarkan nilai usia yang tidak membedakan huruf besar atau kecil berikut: Hari: Mengembalikan halaman web yang ditemukan Bing dalam 24 jam terakhir. Minggu: Mengembalikan halaman web yang ditemukan Bing dalam 7 hari terakhir. Bulan: Mengembalikan halaman web yang ditemukan Bing dalam 30 hari terakhir. Untuk mendapatkan artikel yang ditemukan oleh Bing selama jangka waktu tertentu, tentukan rentang tanggal dalam formulir: `YYYY-MM-DD..YYYY-MM-DD`. Contohnya, `freshness=2019-02-01..2019-05-30`. Untuk membatasi hasil ke satu tanggal, atur parameter ini ke tanggal tertentu. Contohnya, `freshness=2019-02-04`.	string	Tidak.
`market`	Pasar dari mana hasilnya berasal. Biasanya, `mkt` adalah negara tempat pengguna membuat permintaan. Namun, itu bisa menjadi negara yang berbeda jika pengguna tidak berada di negara tempat Bing memberikan hasil. Pasar harus dalam bentuk: `<language>-<country/region>`. Contohnya, `en-US`. String tidak peka huruf besar/kecil. Untuk daftar nilai pasar yang mungkin, lihat Kode pasar. Jika diketahui, Anda dianjurkan untuk selalu menentukan pasar. Menentukan pasar membantu Bing merutekan permintaan dan mengembalikan respons yang sesuai dan optimal. Jika Anda menentukan pasar yang tidak tercantum dalam Kode pasar, Bing menggunakan kode pasar yang paling sesuai berdasarkan pemetaan internal yang dapat berubah.	string	Tidak.
`set_lang`	Bahasa yang digunakan untuk teks antarmuka pengguna. Anda dapat menentukan bahasa menggunakan kode 2 huruf atau 4 huruf. Menggunakan kode 4 huruf lebih disukai. Untuk daftar kode bahasa yang didukung, lihat Bahasa yang didukung Bing. Bing memuat string yang dilokalkan jika `setlang` berisi kode kultur netral 2 huruf yang valid (`fr`) atau kode budaya khusus 4 huruf yang valid (`fr-ca`). Misalnya, untuk `fr-ca`, Bing memuat `fr` string kode kultur netral. Jika `setlang` tidak valid (misalnya, `zh`) atau Bing tidak mendukung bahasa tersebut (misalnya, `af`, `af-na`), Bing akan menggunakan default `en` (Bahasa Inggris). Untuk menentukan kode 2 huruf, atur parameter ini ke kode bahasa ISO 639-1. Untuk menentukan kode 4 huruf, gunakan formulir `<language>-<country/region>` di mana `<language>` adalah kode bahasa ISO 639-1 (budaya netral) dan `<country/region>` merupakan kode negara/wilayah (budaya tertentu) ISO 3166. Misalnya, gunakan `en-US` untuk Bahasa Inggris Amerika Serikat. Meskipun opsional, Anda harus selalu menentukan bahasa. Biasanya, Anda mengatur `setLang` ke bahasa yang sama yang ditentukan oleh `mkt` kecuali pengguna ingin string antarmuka pengguna ditampilkan dalam bahasa yang berbeda.	string	Tidak.

Cara menampilkan Grounding dengan hasil Pencarian Bing

Menurut persyaratan penggunaan dan tampilan Bing, Anda perlu menampilkan URL situs web dan URL kueri pencarian Bing di antarmuka kustom Anda. Anda dapat menemukan URL situs web melalui annotations parameter dalam respons API dan URL kueri pencarian Bing melalui runstep detail. Untuk merender halaman web, kami sarankan Anda mengganti titik akhir URL kueri pencarian Bing dengan www.bing.com dan URL kueri pencarian Bing Anda akan terlihat seperti "https://www.bing.com/search?q={search kueri}"

run_steps = project_client.agents.list_run_steps(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")

Langkah selanjutnya

Lihat sampel kode untuk menggunakan alat Grounding with Bing secara terprogram.