Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Jawaban atas pertanyaan umum tentang menggunakan Microsoft Web IQ. Untuk detail API dan contoh permintaan, lihat referensi API.
Layanan dan deployment
Apa itu Microsoft Web IQ?
Microsoft Web IQ adalah rangkaian API pencarian web berbasis AI dan grounding yang memberi LLM, agen AI, dan aplikasi akses ke informasi web yang relevan saat ini. Ini memungkinkan jawaban AI yang lebih akurat dan terkini dengan sumber yang dapat diverifikasi pengguna. Web IQ menenagai asisten AI frontier terkemuka, termasuk Microsoft Copilot dan ChatGPT.
Web IQ tersedia melalui REST di https://api.microsoft.ai/v3 dan melalui MCP di https://api.microsoft.ai/v3/mcp. API yang saat ini tersedia adalah Pencarian Web, Berita, Video, Gambar, dan Browse.
Auto tersedia dalam versi beta.
Apa itu web grounding, dan kapan agen AI membutuhkannya?
Web grounding memberikan akses AI ke informasi web terbaru sehingga dapat menjawab menggunakan fakta saat ini di luar data pelatihannya, dengan sumber yang dikutip yang dapat diperiksa pengguna. Ini paling membantu dengan informasi yang sering berubah, seperti perkembangan pasar, aktivitas pesaing, berita, dan pembaruan peraturan.
Apakah Web IQ adalah LLM? Apakah itu menghasilkan jawaban akhir?
No. Web IQ bukan model AI atau LLM. Ini adalah paket API penelusuran web native AI dan grounding yang memberi LLM, agen AI, serta memungkinkan aplikasi mengakses informasi web saat ini yang relevan.
Web IQ tidak menghasilkan jawaban AI akhir. Ini mengambil informasi yang relevan dari web, dan LLM, agen AI, atau logika aplikasi yang Anda pilih menggunakan bukti tersebut untuk menghasilkan respons.
Apa yang membuat Web IQ berbeda dari API pencarian web dan layanan grounding lainnya?
Sebagian besar API pencarian web memaksa tradeoff: cepat atau akurat, hemat biaya atau lengkap. Dalam perbandingan Microsoft yang diterbitkan, Web IQ memberikan kepuasan grounding tertinggi, kecepatan tercepat, dan token terkecil per kueri. Ini adalah platform yang sama dengan yang diandalkan oleh asisten AI seperti Copilot dan ChatGPT setiap hari, terbukti pada skala global dan siap menjadi dasar bagi agen atau aplikasi AI apa pun.
Web IQ juga dibedakan dengan cara mengakses konten. Mengambil pendekatan yang bertanggung jawab untuk akses web, menyatukan web terbuka dan data terstruktur dengan keamanan dan perlindungan tingkat perusahaan bawaan.
Web IQ berfungsi dengan tumpukan AI yang sudah Anda gunakan. Anda dapat menggunakan model AI pilihan Anda dan terhubung melalui REST API atau Model Context Protocol (MCP), tanpa terikat dengan satu model atau platform.
Sumber: Hasil tolok ukur Web IQ (bagian Kualitas, Efisiensi, dan Kecepatan).
Apa yang bisa saya buat dengan Web IQ?
Web IQ memberdayakan agen dan aplikasi AI yang membutuhkan informasi eksternal segar dari web publik. Tim internal dapat menggunakannya untuk kecerdasan kompetitif, pemantauan, penelitian peraturan, kecerdasan penjualan, dan pengoptimalan konten. Pengalaman bagi pelanggan dapat memanfaatkannya untuk penelitian, penemuan, rekomendasi, dan agen khusus.
Ini paling cocok untuk skenario di mana informasi sering berubah, mencakup banyak sumber eksternal, dan perlu didasarkan pada konten web saat ini yang dapat diatribusikan.
API Web IQ mana yang sesuai dengan kasus penggunaan saya?
Gunakan Web Search API untuk menemukan halaman dan bagian publik yang relevan untuk model Anda, News API untuk peristiwa saat ini, API Gambar dan Video untuk hasil visual dan video, dan Browse API saat Anda sudah mengetahui URL. Periksa referensi API untuk kemampuan dan batasan yang tersedia untuk akun Anda.
Dapatkah saya menggunakan Web IQ dengan model AI dan kerangka kerja agen saya yang sudah ada?
Yes. Web IQ memungkinkan Anda menambahkan informasi web ke model AI dan alur kerja agen yang Anda pilih. REST API dan MCP memberi Anda fleksibilitas dalam cara Anda menghubungkannya. Periksa SDK dan dokumentasi integrasi MCP untuk konfigurasi yang didukung.
Seperti apa integrasinya?
Agen atau aplikasi AI Anda memanggil Web IQ untuk bukti dari web, lalu meneruskan hasil yang dipilih ke modelnya untuk menghasilkan respons. Anda mengontrol bagaimana informasi dipilih, digunakan, dan dikutip. Ikuti Mulai Cepat untuk menyambungkan alur kerja pertama Anda, atau mulai menggunakan Playground.
Bisakah Web IQ memperoleh informasi perusahaan swasta?
No. Web IQ mengambil informasi dari web publik. Untuk konteks perusahaan, Microsoft menawarkan Work IQ, Fabric IQ, dan Foundry IQ, masing-masing melayani peran yang berbeda, dari konteks organisasi hingga data bisnis dan pengetahuan perusahaan.
Bagaimana Web IQ berhubungan dengan Foundry IQ, Work IQ, dan Fabric IQ?
Microsoft IQ menyatukan empat lapisan terintegrasi yang mendukung kecerdasan perusahaan di seluruh Microsoft. Web IQ menyediakan informasi dari web publik. Work IQ berfokus pada sinyal kerja, Fabric IQ pada data bisnis, dan Foundry IQ pada pengetahuan organisasi. Produk-produk ini menjawab berbagai kebutuhan informasi untuk agen dan aplikasi AI dan paling kuat ketika digunakan bersama-sama.
Apakah Web IQ merupakan sumber daya Azure?
Anda menerapkan sumber daya Web IQ di langganan Azure Anda. Resource menangani identitas, pengukuran, dan penagihan.
Layanan itu sendiri di-host oleh Microsoft dan multitenan. Pengambilan web dan peringkat berjalan di infrastruktur Microsoft, dan aplikasi Anda memanggil api.microsoft.ai melalui HTTPS. Sumber daya Azure tidak menghosting Web IQ dan tidak berada di jalur permintaan.
Di mana Web IQ diterapkan?
Web IQ dihosting Microsoft dan tersedia melalui titik akhir publikhttps://api.microsoft.ai/v3. Aplikasi Anda memanggil API, dan Web IQ melakukan pengambilan web di sisi server.
Apakah ada API khusus untuk keuangan, olahraga, atau cuaca?
Bukan hari ini. API khusus adalah Pencarian Web, Berita, Video, Gambar, dan Browse. Untuk keuangan, olahraga, cuaca, dan subjek lainnya tanpa API khusus, gunakan Pencarian Web, yang mengembalikan konten rayapan yang relevan. Konten tersebut adalah teks halaman tidak terstruktur, bukan feed terstruktur.
Akses dan orientasi
Bagaimana cara berpindah dari evaluasi ke produksi?
- Selesaikan evaluasi Anda dan konfirmasikan layanan memenuhi kebutuhan Anda.
- Langganan Azure Anda diaktifkan untuk Web IQ.
- Deploy sumber daya Web IQ dalam subscription tersebut, lalu masuk ke Situs Pelanggan Web IQ dan sambungkan sumber daya. Ini membuat AppID produksi Anda, yang dimulai pada batas default 15 kueri per detik (QPS).
- Untuk mengautentikasi dengan Entra ID, tambahkan ID klien aplikasi Anda ke AppID tersebut di Situs Pelanggan Web IQ.
Penggunaan Web IQ Anda diatur oleh Ketentuan Penggunaan Web IQ, dalam kerangka Perjanjian Pelanggan Microsoft yang sudah Anda miliki.
Langganan Azure mana yang dapat saya gunakan?
Web IQ memerlukan langganan Azure berbayar. kredit Azure tidak berfungsi untuk Web IQ.
Alamat mana yang harus saya gunakan untuk masuk?
Gunakan alamat email untuk masuk ke Microsoft yang memiliki akses ke Web IQ: alamat yang diaktifkan Microsoft untuk Anda, atau akun yang Anda gunakan untuk menyambungkan sumber daya Web IQ Anda di Situs Pelanggan Web IQ. Ini biasanya alamat yang Anda gunakan untuk Azure, Teams, atau Office, yang mungkin berbeda dari alamat kotak surat Anda.
Untuk mengonfirmasinya, masuk ke portal Azure dan periksa alamat di sudut kanan atas.
Mengapa masuk mengatakan bahwa saya tidak memiliki akses?
Pertama, konfirmasikan bahwa alamat yang ditampilkan di sudut kanan atas portal Azure sama persis dengan alamat yang memiliki akses ke Web IQ. Organisasi sering menggunakan satu alamat untuk masuk Microsoft dan alamat lainnya untuk email.
Jika alamat email cocok, organisasi Anda dapat memblokir akses tamu lintas-tenant ke tenant Microsoft Corporation. Minta administrator TI Anda untuk mengizinkan akses tersebut.
Di mana saya bisa mendapatkan bantuan?
Kunjungi situs dukungan Microsoft Web IQ untuk bantuan produk. Untuk pertanyaan tentang penggunaan, privasi, penyimpanan, atau tampilan yang diizinkan, lihat Ketentuan Penggunaan Web IQ saat ini dan perjanjian pelanggan yang berlaku.
Pengesahan API
Metode autentikasi apa yang didukung?
Web IQ mendukung:
- Microsoft Entra ID token bearer melalui alur kredensial klien OAuth 2.0. Ini direkomendasikan untuk beban kerja produksi.
- Kunci API dikirim di
x-apikeyheader permintaan.
Semua lalu lintas API menggunakan HTTPS.
Bagaimana cara mengonfigurasi autentikasi server-ke-server?
Daftarkan aplikasi di Microsoft Entra ID dan gunakan alur kredensial klien OAuth 2.0. Tambahkan ID klien aplikasi ke Web IQ AppID Anda di Situs Pelanggan Web IQ, dapatkan token akses, dan kirimkan token akses tersebut sebagai Authorization: Bearer <access_token>.
Lihat Autentikasi untuk langkah-langkah penyiapan lengkap.
Dapatkah saya mengelola kunci API saya sendiri?
Yes. Anda dapat membuat kunci API sebanyak yang Anda butuhkan dari Situs Pelanggan Web IQ. Tidak ada biaya untuk membuat kunci.
Apakah Web IQ menggunakan RBAC Azure untuk otorisasi API?
No. Web IQ adalah layanan yang dihosting Microsoft yang Anda akses melalui internet. Sumber daya Web IQ yang Anda sebarkan di langganan Azure Anda menangani identitas, pengukuran penggunaan, dan penagihan, tetapi tidak ada di jalur permintaan, sehingga tidak ada sumber daya layanan untuk peran RBAC Azure untuk dilampirkan.
Web IQ mengotorisasi permintaan per AppID. Setiap AppID memiliki profil kelayakan konten dan kuotanya sendiri, dan panggilan yang tidak sah mengembalikan HTTP 403. Untuk memisahkan tim atau beban kerja, misalnya dengan kebijakan atau kuota akses yang berbeda, gunakan beberapa AppID.
Bisakah satu Entra ID memanggil lebih dari satu AppID?
Yes. SATU ID aplikasi Entra (klien) dapat diotorisasi untuk memanggil satu atau beberapa AppID. Untuk memilih AppID, berikan sebagai parameter kueri, misalnya https://api.microsoft.ai/v3/search/web?appid=<AppID>. API menentukan AppID seperti ini:
- Entra ID Anda terikat ke satu AppID: jika Anda tidak menentukan AppID, atau Anda menentukan AppID tersebut, permintaan berhasil (HTTP 200). Jika Anda menentukan AppID yang berbeda, permintaan mengembalikan HTTP 403.
- Entra ID Anda terikat ke beberapa AppID: Anda harus menentukan salah satunya. AppID yang hilang atau kosong mengembalikan HTTP 400; salah satu AppID yang terikat ke aplikasi Anda berhasil (HTTP 200); AppID lainnya mengembalikan HTTP 403.
- Entra ID Anda tidak terikat ke AppID apa pun: permintaan mengembalikan HTTP 401.
Autentikasi kunci API (x-apikey) tidak terpengaruh. Setiap kunci API terikat ke satu AppID, jadi ?appid= tidak pernah diperlukan atau diterima untuk panggilan yang diautentikasi kunci.
Autentikasi apa yang harus digunakan agen yang dihosting: Identitas Terkelola atau AgentID?
Keduanya bisa. Identitas Terkelola dan AgentID keduanya adalah identitas Entra ID, dan Web IQ menerima identitas Entra apa pun yang ID aplikasi (klien)-nya ditautkan ke Profil Aplikasi Web IQ Anda dari halaman Manajemen Profil Situs Pelanggan Web IQ.
Mana yang Anda gunakan tergantung pada tempat agen dihosting:
- Identitas Terkelola cocok dengan agen yang berjalan pada infrastruktur Azure, seperti Foundry, App Service, Container Apps, AKS, Functions, atau VM. Identitas yang ditetapkan sistem dan ditetapkan pengguna berfungsi.
- AgentID sesuai untuk agen yang dihosting Foundry atau Copilot Studio yang mengekspos identitas agen.
- Agen yang dihosting di luar Azure, misalnya pada kluster Kubernetes Anda sendiri atau cloud lain, dapat menggunakan pendaftaran aplikasi Entra standar dengan rahasia klien atau kredensial federasi.
Dalam setiap kasus, panggilan menggunakan alur kredensial klien OAuth 2.0 dan mengirim token sebagai Authorization: Bearer <access_token>. Lihat Autentikasi untuk langkah-langkah penyiapan. Kunci API di x-apikey header tetap menjadi opsi yang lebih sederhana untuk prototipe.
Jaringan dan keamanan
Apakah Web IQ mendukung Private Link, titik akhir privat, integrasi VNet, atau daftar ip yang diizinkan?
No. Tidak ada satu pun yang didukung saat ini. Web IQ diakses melalui satu titik akhir publik, https://api.microsoft.ai/v3, melalui HTTPS dengan Entra ID atau autentikasi kunci API. Tidak ada kontrol akses berbasis IP di titik akhir API.
Sumber daya Web IQ di langganan Azure Anda menangani identitas, pengukuran, dan penagihan tetapi tidak berada di jalur permintaan, jadi kontrol jaringan Azure seperti Private Link, integrasi VNet, Azure Firewall, NSG, dan topologi hub dan spoke tidak memiliki titik penerapan di sisi Web IQ. Integrasi identitas (Entra ID) selaras Azure; lapisan jaringan tidak.
Di sisi Anda, izinkan nama host api.microsoft.ai di kontrol egress Anda.
Apakah lalu lintas dari Azure ke Web IQ tetap berada di jaringan Microsoft atau backbone Azure?
Ini tidak dijamin. Klien terhubung ke titik akhir publik https://api.microsoft.ai , dan lalu lintas diamankan saat transit dengan HTTPS.
Lalu lintas WEB IQ API berakhir pada Azure Front Door, yang mendukung TLS 1.2 dan TLS 1.3 dengan suite sandi ini:
-
TLS 1.3:
TLS_AES_256_GCM_SHA384,TLS_AES_128_GCM_SHA256 -
TLS 1.2:
TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384,TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
Apakah Zscaler atau alat inspeksi keluar lainnya akan mengganggu Web IQ?
Ini tidak boleh mengganggu ketika dikonfigurasi untuk memungkinkan koneksi ke api.microsoft.ai. Ini adalah tindakan daftar yang diizinkan standar, bukan bypass luas. Pendekatan yang sama berlaku untuk gateway web aman lainnya seperti Netskope.
Bisakah saya menempatkan Web IQ di belakang Azure API Management?
Yes. Anda dapat menempatkan Azure API Management atau gateway lain di depan Web IQ di langganan Azure Anda sendiri untuk pengamatan dan tata kelola, dan tidak ada batasan pemblokiran yang diketahui. Panggilan API berjalan dari pemanggil Anda ke https://api.microsoft.ai/v3 melalui TLS dengan kunci API atau token Entra ID, jadi apa pun yang Anda letakkan di depan lalu lintas tersebut adalah infrastruktur Anda sendiri di tenant Anda. Microsoft tidak menerbitkan arsitektur referensi untuk penyebaran ini; tim arsitektur cloud Anda bertanggung jawab atas desain tersebut.
Di bawah Ketentuan Penggunaan Web IQ, konten respons tidak dapat di-cache atau disimpan untuk membangun himpunan data turunan, terlepas dari apa yang dilakukan gateway. Telemetri operasional seperti status, latensi, header, dan ID pelacakan dapat dipertahankan, misalnya di Application Insights atau Log Analytics.
Kontrol keamanan apa yang tersedia?
- Autentikasi: Entra ID (kredensial klien OAuth 2.0) atau kunci API.
- Otorisasi: akses per AppID ke API. Panggilan tidak sah mengembalikan HTTP 403.
- Pembatasan laju: pemberlakuan kuota per AppID. Permintaan yang melebihi batas mengembalikan HTTP 429.
- Transport: hanya HTTPS.
Kebijakan jaringan di perimeter Anda adalah tanggung jawab Anda. Jika Anda memiliki persyaratan arsitektur tertentu yang ingin dinilai, hubungi Web IQ Support.
Batas permintaan dan kunci API
Apakah ada batas permintaan?
Yes. Setiap sumber daya Web IQ memiliki batas default 15 kueri per detik (QPS). Batas berlaku untuk AppID yang dibuat saat Anda menyambungkan sumber daya, dan Situs Pelanggan Web IQ menampilkannya.
Batas berlaku untuk semua kunci API dan klien Entra ID untuk AppID tersebut. Permintaan yang melebihi batas mengembalikan HTTP 429.
Dapatkah saya meningkatkan batas laju saya?
Yes. Setiap sumber daya Web IQ dimulai dari 15 QPS. Untuk meminta batas yang lebih tinggi, hubungi Dukungan Web IQ dengan perkiraan lalu lintas dan kasus penggunaan Anda.
Berapa banyak kunci API yang dapat saya buat?
Anda dapat membuat key sebanyak yang dibutuhkan aplikasi Anda. Pembuatan kunci gratis, tetapi semua kunci untuk satu sumber daya berbagi batas lajunya.
Privasi dan penanganan data
Apakah Web IQ mencatat kueri API?
Yes. Permintaan API dicatat untuk tujuan operasional: keandalan layanan, penelusuran kesalahan, dan peningkatan kualitas. Ini adalah standar untuk layanan Microsoft.
- Akses dibatasi untuk personel rekayasa dan operasi Microsoft yang berwenang dan diatur oleh kebijakan kontrol akses internal Microsoft. Data dalam log tidak dapat diakses oleh pelanggan lain atau pihak ketiga.
- Log disimpan dalam infrastruktur produksi Microsoft dan tunduk pada kontrol keamanan standar Microsoft, termasuk kontrol akses berbasis peran dan jejak audit.
- Log dienkripsi saat transit (HTTPS) dan saat disimpan menggunakan praktik enkripsi standar Microsoft.
Microsoft beroperasi sebagai pengontrol data di bawah Pernyataan Privasi Microsoft.
Berapa lama kueri dipertahankan?
Retensi telemetri kueri diatur oleh Bagian 4 dari Ketentuan Penggunaan Web IQ, yang menetapkan bahwa pemrosesan Microsoft tunduk pada Pernyataan Privasi Microsoft. Tidak ada komitmen retensi khusus Web IQ terpisah di luar apa yang dijelaskan oleh Pernyataan Privasi.
Bisakah saya menonaktifkan pengelogan kueri untuk beban kerja yang diatur atau sensitif?
Teks kueri diambil sebagai bagian dari telemetri permintaan standar, dan pemrosesannya diatur oleh Pernyataan Privasi Microsoft dan Bagian 4 dari Ketentuan Penggunaan Web IQ.
Jika Anda memiliki persyaratan regulasi atau kepatuhan tertentu, Web IQ menawarkan Zero Query Logging, yang menekan teks kueri dari telemetri. Ini bukan fitur layanan mandiri; setiap kasus penggunaan ditinjau dan disetujui satu per satu, dan persetujuan ini dapat berlaku untuk semua aplikasi Anda atau hanya untuk aplikasi tertentu. Untuk memintanya, hubungi tim akun Microsoft Anda dan bagikan:
- Kerangka kerja peraturan atau kepatuhan yang berlaku (misalnya, GLBA, HIPAA, GDPR, atau APPI).
- Deskripsi singkat tentang skenario penyebaran Anda.
Komitmen residensi data apa yang disediakan Web IQ?
Tidak ada hari ini. Web IQ tidak memberikan komitmen residensi data khusus wilayah atau pemrosesan dalam wilayah, dan perutean lintas wilayah ke titik akhir terdekat yang tersedia merupakan perilaku yang diharapkan. Privasi dicakup oleh Pernyataan Privasi Microsoft.
Apakah Web IQ dicakup oleh Adendum Perlindungan Data Azure atau Batas Data UE?
No. Bagian 4.1 dari Ketentuan Penggunaan Web IQ mengecualikan layanan dari Adendum Perlindungan Data Produk dan Layanan Microsoft.
Sebagai gantinya, Microsoft dan pelanggan bertindak sebagai pengontrol data independen untuk Data Pribadi apa pun yang diproses berdasarkan Ketentuan Penggunaan (Bagian 4.4). pemrosesan Microsoft diatur oleh Pernyataan Privasi Microsoft (Bagian 4.2), dan Anda bertanggung jawab untuk memberikan pemberitahuan yang sesuai kepada pengguna akhir Anda.
Untuk transfer internasional, Ketentuan Penggunaan menggabungkan Klausul Kontrak Standar jika diperlukan (Bagian 4.6.1). Mekanisme transfer tersebut diatur melalui Ketentuan Penggunaan, yang berada di bawah Perjanjian Pelanggan Microsoft Anda, bukan melalui Adendum Perlindungan Data.
Web IQ tidak memberikan komitmen EU Data Boundary, residensi data khusus wilayah, atau pemrosesan di wilayah saat ini.
Apakah Web IQ mendeteksi atau menyamarkan data pribadi dalam kueri?
No. Web IQ tidak melakukan deteksi sisi server atau masking data pribadi dalam kueri masuk. Jika beban kerja dapat mengirim data pribadi atau sensitif, scrub data tersebut sebelum memanggil Web IQ, misalnya dengan Azure AI Bahasa PII Detection sebagai langkah praproses. Dengan begitu tidak ada data sensitif yang meninggalkan lingkungan Anda, dan Anda tetap memegang kendali penuh atas apa yang mencapai API.
Apakah Web IQ mendukung industri teregulasi?
Yes. Web IQ mendukung berbagai kasus penggunaan perusahaan dan yang diatur regulasi. Jika Anda memiliki persyaratan kepatuhan, tata kelola, atau industri khusus, hubungi Web IQ Support.
Keamanan dan cakupan konten
Kontrol keamanan konten apa yang diterapkan?
Web IQ menerapkan klasifikasi kualitas dan keamanan saat perayapan, pemfilteran konten dewasa, dan aturan kelayakan konten per pelanggan. SafeSearch diterapkan di sisi server pada strict secara default. Hasil Pencarian Web juga menyertakan isAdult bidang untuk penanganan sisi klien tambahan.
Apakah Web IQ melindungi LLM dari prompt injection dalam konten hasil retrieval?
Microsoft Web IQ mengambil dan memberi peringkat konten dari web; Microsoft Web IQ tidak menjalankan, menginterpretasikan, atau bertindak berdasarkan instruksi yang disematkan dalam konten yang diambil. Web IQ melengkapi perilaku penelusuran ini dengan penyaringan kualitas, kepercayaan, spam, dan konten berbahaya milik Bing yang sudah ada.
Perlindungan terhadap injeksi prompt tidak langsung, upaya jailbreak, dan serangan yang mengeksploitasi kepatuhan terhadap instruksi terutama merupakan tanggung jawab model hilir dan lapisan orkestrasi. Perlakukan prompt dan konten yang diambil sebagai input yang tidak tepercaya dan terapkan kontrol berlapis seperti Prompt Shields, Keamanan Konten Azure AI, isolasi system prompt, akses alat dengan hak istimewa paling rendah, validasi grounding, dan validasi output. Web IQ tidak boleh diperlakukan sebagai satu-satu titik penegakan untuk mitigasi prompt-injection.
Bagaimana konten web diproses sebelum Web IQ mengembalikannya? Apakah ini disanitasi untuk instruksi mirip prompt?
Microsoft Web IQ tidak beroperasi langsung pada HTML halaman mentah pada waktu pengambilan. Selama pengindeksan, konten web dinormalisasi ke dalam representasi dokumen terstruktur yang dirancang untuk mempertahankan konten dan struktur dokumen yang bermakna. Bagian yang dikembalikan oleh Web IQ dipilih dari representasi tersebut, yang memungkinkan ekstraksi dan pengambilan yang lebih konsisten di seluruh permukaan API. Penyaringan kualitas, keamanan, spam, dan konten berbahaya Bing yang sudah ada juga berlaku sebagai bagian dari alur pengindeksan.
Normalisasi ini tidak boleh ditafsirkan sebagai jaminan bahwa teks mirip prompt diidentifikasi atau dihapus. Perlakukan konten yang diambil sebagai input yang tidak tepercaya dan terapkan perlindungan lapisan model dan orkestrasi yang dijelaskan dalam jawaban sebelumnya.
Apakah Web IQ mengembalikan konten halaman tersembunyi atau yang tidak ditampilkan kepada pengguna?
Microsoft Web IQ mencoba mengambil konten yang terlihat melalui interaksi pengguna normal, termasuk konten yang diungkapkan melalui kontrol halaman biasa atau penyajian sisi klien. Ini tidak dijamin. Struktur dan implementasi halaman bervariasi, sehingga aplikasi tidak boleh berasumsi bahwa setiap bagian yang dikembalikan terlihat dalam status awal halaman atau bahwa setiap elemen tersembunyi akan selalu dikecualikan.
Bagaimana Microsoft mempertahankan kualitas indeks?
Halaman dievaluasi untuk kualitas, otoritas, dan kepercayaan. Konten berbahaya, spam, dan pengelabuan terdeteksi dan dikecualikan, dan indeks terus disegarkan. Ini adalah indeks yang sama yang diandalkan oleh produk AI Microsoft sendiri.
Bagaimana Web IQ menghormati preferensi konten penerbit?
Web IQ dirancang untuk menghormati kontrol penerbit yang didukung, termasuk arahan robots.txt yang berlaku dan sinyal penerbit lainnya yang dikenali oleh Microsoft.
Apakah ada daftar situs yang dikecualikan yang diterbitkan atau kategori yang diblokir?
No. Kontrol pengecualian mencakup kepatuhan terhadap robots.txt, penghapusan karena alasan hukum dan kepatuhan (seperti pemberitahuan DMCA dan perintah pengadilan), pemfilteran spam, malware, dan phishing, serta pemfilteran konten dewasa. Daftar itu sendiri bersifat proprietary dan terus diperbarui. Jika Anda memiliki kekhawatiran tentang kategori konten tertentu yang muncul, atau tidak muncul, dalam hasilnya, hubungi Web IQ Support untuk membahas apakah konfigurasi Profil Aplikasi Anda memenuhi persyaratan tersebut.
Konten apa yang dibahas Web IQ, dan seberapa segar kontennya?
Web IQ terus mengambil informasi baru di seluruh halaman web, berita, dan hasil gambar dan video untuk membantu agen AI atau aplikasi Anda menjawab pertanyaan di luar data pelatihan modelnya.
Ketersediaan dan kesegaran bervariasi menurut API, jenis sumber, dan kasus penggunaan; tidak ada jaminan kesegaran tunggal di semua konten. Pertimbangkan persyaratan keterkinian beban kerja Anda saat memilih sumber dan pengaturan pengambilan.
Bahasa dan pasar mana yang didukung Web IQ?
Web IQ mengambil data dari web global, tetapi cakupan bervariasi menurut bahasa, pasar, topik, dan jenis sumber. Tinjau halaman Bahasa dan wilayah yang didukung untuk kode yang diterima setiap API, dan nilai cakupan terhadap informasi yang dibutuhkan pengguna yang Anda maksudkan.
Bisakah saya mengonfigurasi daftar domain yang diizinkan atau ditolak?
Untuk domain individual atau daftar kecil, gunakan operator kueri standar seperti site:example.com untuk menyertakan domain dan -site:example.com untuk mengecualikan domain. Daftar yang dapat dikonfigurasi yang lebih besar saat ini belum tersedia sebagai fitur yang dikelola pelanggan.
Mengapa saya tidak melihat hasil LinkedIn?
Hasil LinkedIn saat ini dikecualikan.
Apa yang terjadi saat Browse dipanggil untuk URL yang dikecualikan?
Penelusuran mengembalikan HTTP 403. Daftar pengecualian dasarnya tidak diekspos.
Bagaimana cara membuat situs web saya dapat ditemukan oleh Web IQ?
Web IQ dibangun pada indeks web yang sama yang Microsoft gunakan untuk produk AI-nya sendiri. Gunakan praktik penemuan web standar seperti peta situs, IndexNow, Alat Webmaster Bing, dan kebijakan robots.txt yang sesuai. Tidak ada jalur pengiriman Web IQ terpisah.
Perilaku kueri dan kualitas hasil
Haruskah saya menggunakan kueri bahasa alami atau kueri kata kunci?
Keduanya berfungsi. Kueri bahasa alami sering bekerja dengan baik dengan contentFormat=passage, sementara kueri kata kunci berguna untuk pencarian yang tepat seperti nama perusahaan, ticker, atau topik tertentu. Hindari kueri yang terlalu panjang atau kueri gabungan; pisahkan beberapa kebutuhan informasi menjadi panggilan API terpisah.
Berapa panjang kueri maksimum?
Maksimum adalah 1.000 karakter, dan kueri yang lebih panjang ditolak. Kueri yang lebih pendek dan terfokus umumnya menghasilkan hasil yang lebih baik: jika kueri berisi banyak konteks, pengambilan mungkin tidak berfokus pada sinyal yang tepat.
Bisakah saya memfilter hasil Pencarian Web menurut tanggal?
Pencarian Web tidak menawarkan filter rentang tanggal saat ini, dan sebaiknya hindari filter tanggal tetap kecuali Anda benar-benar membutuhkannya. Kesegaran sudah diperhitungkan dalam peringkat berdasarkan kueri, dan menambahkan batasan tanggal keras hampir selalu mengurangi relevansi. Untuk skenario berita, gunakan News API daripada memfilter hasil Pencarian Web menurut tanggal.
lastUpdatedAt adalah tanggal terakhir penerbit memperbarui konten, bukan tanggal terakhir Web IQ memeriksa halaman, sehingga tanggal yang lebih lama tidak berarti halaman tersebut tidak diperiksa baru-baru ini. Ini dikembalikan dalam respons, ini bukan filter permintaan, dan tidak setiap hasil menyertakannya. Anda dapat menggunakannya untuk mengurutkan atau memfilter hasil dalam aplikasi Anda.
Bisakah Pencarian Web menangani perintah yang berisi beberapa pertanyaan?
Setiap permintaan Pencarian Web menangani satu kueri. Jika permintaan berisi beberapa pertanyaan atau niat, bagi menjadi kueri terpisah di aplikasi Anda, panggil Web Search untuk masing-masing, dan gabungkan hasilnya sebelum menghasilkan jawabannya.
Bisakah Web IQ mendukung alur kerja agen multi-langkah?
Yes. Agen dapat memanggil Web IQ setiap kali membutuhkan bukti web tambahan selama tugas. Latensi pengambilan sangat penting dalam alur kerja yang melakukan beberapa panggilan sebelum menghasilkan jawaban.
Bagaimana agen AI atau aplikasi saya harus menangani bukti yang diambil dari hasil retrieval?
Gunakan bukti yang relevan dengan pertanyaan dan lacak sumber mana yang mendukung jawabannya. Pisahkan konten yang diambil dari instruksi yang mengontrol agen. Ketika sumber saling bertentangan atau bukti tidak lengkap, jelaskan ketidakpastian itu dengan jelas daripada mengisi kesenjangan dengan pernyataan yang tidak didukung.
Bagaimana perbandingan kualitas grounding?
Microsoft melaporkan kepuasan grounding tertinggi dalam perbandingan yang diterbitkan, dengan skor 79,05. Hasil bergantung pada set kueri, model, dan metode evaluasi, jadi validasi kualitas pada skenario Anda sendiri.
Sumber: Hasil tolok ukur Web IQ. 3K Global, Blind Queries diambil sampelnya dari prod, Config: 10 results, 10K char per result (atau setara).
Mengapa hasilnya berbeda dari Bing.com?
Web IQ dioptimalkan untuk konsumsi LLM, kepadatan faktual, kualitas bagian, dan latensi rendah. Bing.com adalah pengalaman pengguna bagi konsumen dengan sinyal peringkat tambahan, personalisasi, jawaban visual, dan konten yang mungkin tidak dapat didistribusikan ulang melalui API. Beberapa perbedaan peringkat diharapkan.
Dapatkah permintaan yang identik mengembalikan hasil yang berbeda?
Beberapa variasi diharapkan karena indeks terus disegarkan dan pembaruan disebarluaskan di seluruh pusat data. Hasil untuk permintaan identik yang dibuat berdekatan harus tetap relatif stabil. Jika Anda melihat varians yang signifikan pada kueri yang identik dalam hitungan detik, hubungi Dukungan Web IQ.
Mengapa kueri mengembalikan hasil yang lebih sedikit dari yang diharapkan?
Periksa respons IQ Web mentah sebelum menghitung hasil. Penyebab paling umum adalah pengaturan sisi klien atau langkah alur hilir yang memfilter hasil yang valid sebelum diukur.
maxResults Verifikasi juga kelayakan konten, perilaku SafeSearch, dan operator -site: atau site: apa pun dalam kueri.
Konten respons
Mengapa Pencarian Web dan Pencarian Berita tidak mengembalikan field snippet?
Ini memang disengaja. Keduanya mengembalikan content sebagai ekstrak dependen kueri (passage) alih-alih snippet terpisah yang independen terhadap kueri.
Format konten apa yang didukung Pencarian Web?
Dengan passage, setiap hasil mengembalikan bagian dokumen yang paling relevan dengan kueri, hingga maxLength karakter (tanpa akses dokumen penuh, paling banyak 3.000). Ini adalah format yang direkomendasikan untuk grounding. Aplikasi dengan akses dokumen lengkap juga dapat menggunakan text, html, dan markdown. Lihat Bagian dan format konten.
Apa itu passage, dan mengapa menggunakannya?
Atur contentFormat=passage dan API mengembalikan, untuk setiap hasil, hanya segmen dokumen yang paling relevan dengan kueri, bukan dokumen lengkap. Dokumen lengkap diproses di sisi Web IQ, dan apa yang kembali adalah ekstrak yang ditargetkan kueri, sehingga LLM Anda tidak perlu melewati paragraf yang tidak terkait untuk menemukan kalimat yang relevan.
- Penghematan token: LLM menerima sebagian kecil dari dokumen alih-alih semuanya.
- Faktualitas yang lebih baik: dengan konten yang kurang di luar topik dalam konteks, model cenderung tidak terpaku pada paragraf yang menyimpang.
Atur contentFormat=passage pada setiap permintaan Pencarian Web dan Berita. Browse tidak mendukung passage, karena mengambil URL tertentu yang sudah Anda pilih dan tidak ada kueri untuk diekstrak.
Berapa nilai maksimum maxResults untuk Pencarian Web?
Pencarian Web mendukung hingga 50 hasil per permintaan.
Parameter permintaan mana yang dapat saya konfigurasi?
Pencarian Web mengekspos maxResults, language dan region, contentFormat (passage, text, htmlatau markdown), maxLength, dan safeSearch. Lihat referensi API untuk daftar parameter lengkap.
Apa perbedaan antara lastUpdatedAt dan crawledAt?
lastUpdatedAt adalah tanggal pembaruan konten yang dilaporkan penerbit, dikembalikan oleh Pencarian Web, Berita, Video, Gambar, Telusuri, dan Otomatis jika tersedia.
crawledAt adalah waktu saat terakhir kali Web IQ mengambil halaman, yang dikembalikan oleh Pencarian Web, Telusuri, Berita, dan Otomatis. Cakupan kedua bidang bervariasi menurut hasil.
Bagaimana cara menyetel maxResults dan maxLength untuk mengelola jendela konteks dan biaya token?
Web IQ dapat memprioritaskan bagian yang relevan dengan kueri alih-alih menyediakan konteks halaman yang tidak perlu. Ini dapat mengurangi jumlah teks yang diteruskan ke model Anda dan menurunkan biaya token input. Manfaat bergantung pada model, prompt, campuran kueri, dan setelan retrieval Anda.
Untuk sebagian besar skenario grounding, lebih banyak hasil dengan bagian yang lebih pendek memberikan output yang lebih baik daripada lebih sedikit hasil dengan bagian yang lebih lama untuk anggaran token total yang kira-kira sama. Titik awal yang baik adalah maxResults=10 dengan maxLength sekitar 3.000 karakter dalam passage format. Tolok ukur dengan kueri dan model Anda sendiri.
Apa itu Browse Live Crawl dan kapan saya harus menggunakannya?
Telusuri mengembalikan konten dari indeks web Bing, yang terus disegarkan saat perayap kami mengamati perubahan di seluruh web. Ini adalah cara kerja pencarian web secara umum: hasil pencarian dilayani dari indeks alih-alih mengambil setiap URL secara langsung pada setiap permintaan, dan itulah yang memberi Browse kecepatan dan konsistensinya.
Untuk skenario yang secara khusus memerlukan pengambilan URL just-in-time pada waktu permintaan, seperti pemantauan real time, pemeriksaan kompetitif, atau alur kerja yang memicu perubahan yang Anda ketahui baru saja terjadi, Browse mendukung Live Crawl. Atur liveCrawl: "fallback" pada permintaan untuk mengaktifkan pengambilan langsung saat salinan terindeks hilang atau basi. Menghilangkan parameter (atau pengaturan liveCrawl: "none") hanya mengembalikan konten terindeks. Lihat referensi API Browse untuk detail parameter lengkap.
Live Crawl tersedia secara default di Web IQ Browse dan disediakan dengan batas kapasitas per detik yang terbatas, terpisah dari Browse QPS Anda secara keseluruhan. Batas maksimum ini dibagikan di semua kunci API di bawah AppID. Sebagian besar beban kerja Telusuri tidak memerlukan Perayapan Langsung dan sebaiknya menggunakan jalur terindeks standar; gunakan Perayapan Langsung untuk serangkaian skenario sempit di atas.
Bisakah Browse mengambil halaman yang dirender JavaScript?
Yes. Gunakan renderDynamicPages: true bersama dengan liveCrawl: "fallback". Lihat referensi API Browse untuk set parameter lengkap dan detail respons. Uji URL perwakilan sebelum Anda bergantung pada perilaku ini dalam produksi.
Dapatkah Browse mengekstrak file PDF online?
PDF yang dihosting online bukan skenario penelusuran yang terdokumentasi saat ini. Jika Anda memiliki kasus penggunaan PDF tertentu, hubungi Web IQ Support dengan URL perwakilan dan perilaku yang Anda harapkan, dan Anda akan mendapatkan jawaban pasti.
Penagihan dan urusan hukum
Berapa biaya Web IQ?
Web IQ menggunakan harga per panggilan berbasis konsumsi. Harga tergantung pada API yang diaktifkan untuk akun Anda, penggunaan Anda, dan persyaratan komersial Anda. Lihat Harga untuk tarif saat ini.
Apakah Web IQ menyertakan komitmen SLA, RTO, atau RPO?
No. Microsoft Web IQ tidak menyertakan perjanjian tingkat layanan. Ketentuan Penggunaan Web IQ tidak berkomitmen untuk target waktu aktif, latensi, Tujuan Waktu Pemulihan (RTO), atau Tujuan Titik Pemulihan (RPO), dan persyaratan SLA tidak ditambahkan untuk pelanggan individual.
Apakah saya perlu menampilkan sitasi?
Yes. Lampiran A, Bagian 1 (Penggunaan LLM) dari Ketentuan Penggunaan Web IQ memerlukan atribusi sumber dan tautan kembali ke setiap sumber yang digunakan untuk konten LLM yang ditampilkan, di dekat konten tersebut.
- Kutip hanya sumber yang benar-benar digunakan untuk menghasilkan jawabannya. Jika Web IQ mengembalikan 10 hasil dan model Anda menggunakan 3, tampilkan 3 hasil tersebut.
- Kutipan harus tetap terlihat dengan jawaban dan dapat diakses dengan satu tindakan. Jangan perlihatkan itu hanya secara singkat, sembunyikan di balik beberapa layar, atau haruskan pengguna meminta sumber secara terpisah.
- Untuk antarmuka yang dibatasi seperti mobil, wearable, perangkat voice-first, atau kios, gunakan kode QR persisten yang mengarah ke halaman yang mencantumkan setiap kutipan yang digunakan untuk jawaban saat ini, aplikasi pendamping yang menunjukkan jawaban dengan kutipan yang dapat diklik, atau daftar di layar yang dapat dibuka pengguna secara langsung.
Anda dapat menyimpan sitasi sebagai bagian dari riwayat obrolan pengguna akhir individu hingga 30 hari. Lihat pertanyaan cache di bawah ini.
Berapa banyak konten sumber yang dapat ditampilkan agen AI atau aplikasi saya?
Lampiran A dari Web IQ Terms of Use membatasi Konten Grounding yang ditampilkan dari sumber tunggal mana pun sebesar nilai yang lebih kecil antara 200 karakter atau maksimum yang ditentukan oleh pemilik situs web atau webmaster. Untuk pengalaman suara atau audio, terapkan batas yang sama ke output lisan. Pembatasan tambahan berlaku untuk ringkasan dan tampilan. Tinjau Ketentuan Penggunaan sebelum membuat kutipan; batas ini bukan izin untuk mereproduksi seluruh halaman sumber.
Dapatkah hasil gambar dan video digunakan untuk memberikan landasan bagi LLM?
Metadata gambar dan video dan teks alt disertakan dalam definisi Konten Grounding. Namun, Ketentuan Penggunaan Web IQ melarang penggunaan gambar atau video aktual dari hasil untuk grounding, termasuk dalam output LLM, atau membuat gambar atau video turunan darinya. Tinjau ketentuan untuk implementasi yang Anda rencanakan.
Bisakah saya menyimpan cache atau menyimpan konten Web IQ?
Sebagai aturan umum, tidak. Ketentuan Penggunaan Web IQ melarang penyalinan, penyimpanan, cache, pengarsipan, atau pembuatan database Konten, kecuali di bawah pengecualian sempit (Bagian 3.2.15 dan Bagian 4 Lampiran A dan B):
- Riwayat obrolan pengguna akhir (hingga 30 hari): Konten dapat disimpan secara non-agregat per pengguna akhir untuk riwayat obrolan pengguna akhir individu hingga 30 hari. Untuk Penggunaan LLM (Lampiran A) ini mencakup Konten secara umum; untuk Penggunaan Pencarian (Lampiran B) mencakup URL gambar dan video.
- Pemrosesan sementara Atomic Action: Konten dapat disimpan dalam status pemrosesan sementara hanya seperlunya untuk menyelesaikan satu permintaan logis atau alur kerja yang dimulai oleh LLM ("Atomic Action", yang mungkin melibatkan beberapa langkah internal atau interaksi agenik). Konten harus segera dihapus ketika Atomic Action selesai.
- Produk kerja Anda sendiri: sejauh yang diizinkan oleh undang-undang hak cipta, Konten dapat disalin atau disimpan sebagai bagian terintegrasi dari produk kerja Anda sendiri, selama produk kerja tidak dibuat untuk menggantikan Layanan (misalnya, membangun database Konten, mengindeks tautan untuk perayapan, atau menawarkan pencarian terpisah).
Di luar pengecualian ini, Ketentuan Penggunaan tidak mengizinkan database turunan, cache persisten, atau pengarsipan konten jangka panjang.
Di mana saya dapat membaca Ketentuan Penggunaan Web IQ?
Ketentuan saat ini tersedia di Microsoft Web IQ Terms of Use. Mereka berlaku bersama dengan Perjanjian Pelanggan Microsoft Anda yang ada.
Akses dokumen penuh
Mengapa saya mendapatkan HTTP 403 saat saya mengatur contentFormat ke html?
Di Pencarian Web dan Pencarian Berita, text, html, dan markdown mengembalikan dokumen lengkap dan tersedia untuk aplikasi dengan akses dokumen lengkap. Aplikasi lain mendapatkan HTTP 403 dengan kode kesalahan AuthContentFormatForbidden.
passage berfungsi di semua aplikasi. Lihat Passase dan format konten.
Bagaimana cara meminta akses dokumen penuh?
Buka permintaan Dukungan IQ Web melalui Dukungan Azure dan pilih kategori Konten halaman penuh. Aplikasi yang sudah menggunakan html atau text terus bekerja seperti saat ini.