Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Microsoft Web IQ kullanma hakkında sık sorulan soruların yanıtları. API ayrıntıları ve istek örnekleri için bkz. API başvurusu.
Hizmet ve yayına alma
Microsoft Web IQ nedir?
Microsoft Web IQ, LLM'lere, yapay zeka aracılarına ve uygulamalara güncel, ilgili web bilgilerine erişim sağlayan yapay zekaya özel web araması ve grounding API'lerinden oluşan bir pakettir. Bu, kullanıcıların doğrulayabildiği kaynaklarla daha doğru, güncel yapay zeka yanıtları sağlar. Web IQ, Microsoft Copilot ve ChatGPT gibi önde gelen öncü yapay zeka yardımcılarına güç verir.
Web IQ, REST üzerinden https://api.microsoft.ai/v3 adresinden ve MCP aracılığıyla https://api.microsoft.ai/v3/mcp adresinden kullanılabilir. Her bir Web IQ AppID, Web Araması'nı, Haberler'i, Resimler'i, Videolar'ı, Gözat'ı, Yerler'i ve Otomatik'i çağırabilir.
web grounding nedir ve yapay zeka aracısının buna ne zaman ihtiyacı vardır?
web grounding, yapay zekanın en son web bilgilerine erişmesini sağlayarak eğitim verilerinin ötesindeki güncel olguları kullanarak yanıt verebilmesini sağlar; kullanıcıların kontrol edebileceği atıf yapılan kaynaklarla. Pazardaki gelişmeler, rakip etkinlik, haberler ve mevzuat güncelleştirmeleri gibi sık değişen bilgiler konusunda en çok yardımcı olur.
Web IQ bir LLM mi? Son yanıtı oluşturuyor mu?
No. Web IQ bir yapay zeka modeli veya LLM değildir. LLM'lere, yapay zeka aracılarına ve uygulamalara geçerli, ilgili web bilgilerine erişim sağlayan yapay zekaya özel web araması ve grounding API'lerinden oluşan bir pakettir.
Web IQ son yapay zeka yanıtını oluşturmaz. Web'den ilgili bilgileri alır ve seçtiğiniz LLM, AI aracısı veya uygulama mantığı bu kanıtı kullanarak yanıt oluşturur.
Web IQ'yi diğer web arama API'lerinden ve grounding hizmetlerinden farklı kılan nedir?
Web arama API'lerinin çoğu bir ödünleşimi zorlar: hızlı veya doğru, uygun maliyetli veya eksiksiz. Microsoft'un yayımlanmış benchmarklarında Web IQ'nun P95 gecikme süresi, test edilen bir sonraki en hızlı hizmetten yaklaşık 2 kat daha hızlıydı; Auto ve Web Araması, karşılaştırılan hizmetlere kıyasla daha düşük belirteç sayılarında daha yüksek grounding memnuniyetine ulaştı ve genel olarak en yüksek olan Auto'ydu; ve Auto, FreshSearch tazelik benchmark'ında en yüksek puanı aldı. Bu, Copilot ve ChatGPT gibi yapay zeka yardımcılarının her gün güvendiği, küresel ölçekte kanıtlanmış ve her türlü yapay zeka aracısının veya uygulamanın üzerine inşa edebileceği aynı platformdur.
Web IQ, içeriğe erişme biçimiyle de farklılaşır. Açık web ve yapılandırılmış verileri yerleşik kurumsal düzeyde güvenlik ve korumalarla bir araya getirerek web erişimine sorumlu bir yaklaşım benimser.
Web IQ, zaten kullandığınız AI altyapısıyla çalışır. Tercih ettiğiniz yapay zeka modelini kullanabilir ve tek bir modele veya platforma bağlı kalmadan REST API veya Model Bağlam Protokolü (MCP) aracılığıyla bağlanabilirsiniz.
Kaynak: Web IQ benchmark sonuçları (P95 gecikme süresi, Kalite ve belirteç verimliliği ve Grounding güncelliği bölümleri).
Web IQ ile neler oluşturabilirim?
Web IQ, genel web'den güncel, harici bilgilere ihtiyaç duyan yapay zeka ajanlarını ve uygulamalarını destekler. İç ekipler bunu rekabet zekası, izleme, mevzuat araştırması, satış zekası ve içerik iyileştirme için kullanabilir. Müşteriye yönelik deneyimler bunu araştırma, keşif, öneriler ve özel ajanlar için kullanabilir.
Bilgilerin sık sık değiştiği, birçok dış kaynağa yayıldığı ve güncel, atıf yapılabilir web içeriğine dayanması gereken senaryolar için idealdir.
Hangi Web IQ API'si kullanım örneğime uyuyor?
Modeliniz için ilgili genel sayfaları ve bölümleri, geçerli olaylar için Haber API'sini, görsel ve video sonuçları için Görüntü ve Video API'lerini, yapılandırılmış yer bilgileri için Yerler API'sini ve URL'yi zaten biliyorsanız Gözat API'sini bulmak için Web Araması API'sini kullanın. Hesabınızda kullanılabilen özellikler ve limitler için API referansını denetleyin.
Web IQ'yu mevcut yapay zeka modelim ve aracı çerçevemle kullanabilir miyim?
Yes. Web IQ, seçtiğiniz yapay zeka modeline ve ajan iş akışına web bilgileri eklemenize olanak tanır. REST API'leri ve MCP, ona nasıl bağlanacağınız konusunda size esneklik sağlar. Desteklenen yapılandırmalar için SDK ve MCP tümleştirme belgelerine bakın.
Entegrasyon nasıl görünür?
Yapay zeka aracınız veya uygulamanız web kanıtı için Web IQ'yu çağırır, ardından seçilen sonuçları modeline geçirerek yanıt oluşturur. Bilgilerin nasıl seçildiğini, kullanıldığını ve alıntı yapıldığını siz denetlersiniz. İlk iş akışınızı bağlamak için Hızlı Başlangıç'ı izleyin veya Playground'u kullanmaya başlayın.
Web IQ şirketlere ait gizli bilgileri alabilir mi?
No. Web IQ, herkese açık web bilgilerini alır. Kurumsal bağlam için Microsoft, kurumsal bağlamdan iş verilerine ve kurumsal bilgiye kadar uzanan alanlarda her biri farklı bir rol üstlenen Work IQ, Fabric IQ ve Foundry IQ sunar.
Web IQ ile Foundry IQ, Work IQ ve Fabric IQ arasındaki ilişki nedir?
Microsoft IQ, Microsoft genelinde kurumsal zekayı güçlendiren dört tümleşik katmanı bir araya getirir. Web IQ, herkese açık web'den bilgi sağlar. Work IQ iş sinyallerine, Fabric IQ iş verilerine ve Foundry IQ kurumsal bilgiye odaklanır. Bu ürünler yapay zeka ajanları ve uygulamaları için farklı bilgi gereksinimlerini karşılar ve birlikte kullanıldığında en güçlü olanlardır.
Web IQ bir Azure kaynağı mı?
Azure aboneliğinizde bir Web IQ kaynağı dağıtırsınız. Bu kaynak ölçüm ve faturalamayı yönetir. Web IQ'daki uygulamanızın kimliği, Web IQ Geliştirici Portalı'nda kaynağı bağladığınızda oluşturulan Web IQ AppID'dir.
Hizmetin kendisi Microsoft tarafından barındırılır ve çok kiracılıdır. Web alma ve derecelendirme, Microsoft altyapısında çalıştırılır ve uygulamanız api.microsoft.ai öğesini HTTPS üzerinden çağırır. Azure kaynağı Web IQ barındırmaz ve istek yolunda değildir.
Web IQ kaynağı ile Web IQ AppID arasındaki fark nedir?
Web IQ kaynağı, Azure aboneliğinizde, Azure portalında veya Azure CLI ile oluşturduğunuz Azure kaynaktır. Web IQ kullanımı ölçülür ve bunun ücreti aboneliğiniz üzerinden faturalandırılır. Kaynak istek yolunda değil: uygulamanız api.microsoft.ai öğesini doğrudan çağırır.
Web IQ AppID, uygulamanızın Web IQ'daki kimliğidir. Web IQ Geliştirici Portalı'nda bir Web IQ kaynağına bağlandığınızda oluşturulur. Uygulamanızın Web IQ kullanma şekliyle ilgili her şey AppID'de ayarlanır: çağırabileceği API'ler, hız sınırı (varsayılan olarak 15 QPS), API anahtarları ve AppID'ye bağlı Entra uygulaması (istemci) kimlikleri. Bunu uygulama kaydınızın Entra uygulaması (istemci) kimliğiyle karıştırmayın: bu kimlik, belirteç aldığında uygulamanızı Microsoft Entra ID'ye tanımlar ve bunu bir Web IQ AppID'ye bağlarsınız.
Bir kaynağın bağlanması bir AppID oluşturur, bu nedenle müşterilerin çoğu her birinden bir tane ile başlar. Ortam veya iş yükü başına bir tane gibi birden fazla AppID'ye ihtiyacınız varsa, Microsoft irtibat kişiniz size seçenekleri söyleyebilir.
Web IQ nerede kurulur?
Web IQ, Microsoft tarafından barındırılır ve genel https://api.microsoft.ai/v3 uç noktası üzerinden kullanılabilir. Uygulamanız API'yi çağırır ve Web IQ, web'den veri almayı sunucu tarafında gerçekleştirir.
Finans, spor veya hava durumu için ayrılmış API'ler var mı?
Finans, spor veya hava durumu için özel bir API yoktur. Hava durumu için Otomatik , bir sorgu hava durumuyla ilgili olduğunda yapılandırılmış hava durumu sonuçlarını (geçerli koşullar, günlük tahminler ve veren yetkiliye bağlantı içeren etkin hava durumu uyarıları) döndürür. Finans, spor ve diğer konular için, ilgili gezinilen içeriği yapılandırılmış akış yerine yapılandırılmamış sayfa metni olarak döndüren Web Araması'nı kullanın.
Erişim ve başlangıç
Değerlendirmeden üretime nasıl geçebilirim?
- Değerlendirmenizi tamamlayın ve hizmetin gereksinimlerinizi karşıladığını onaylayın.
- Ücretli Azure aboneliğinde bir Web IQ kaynağı oluşturun, ardından Web IQ Geliştirici Portalı'nda oturum açın ve kaynağı bağlayın. Bu, Profil Yönetimi'nden kopyalayabileceğiniz üretim AppID'nizi oluşturur. Varsayılan saniyede 15 sorgu (QPS) sınırında başlar.
- Microsoft Entra ID kimlik doğrulaması yapmak için uygulama kaydınızın Entra uygulama (istemci) kimliğini Geliştirici Portalı'ndaki bu AppID'ye bağlayın.
Web IQ kullanımınız, mevcut Microsoft Müşteri Sözleşmesi bağlamında Web IQ Kullanım Koşulları'na tabidir.
Hangi Azure abonelikleri kullanabilirim?
Web IQ, Bulut Çözümü Sağlayıcısı (CSP) iş ortağı aracılığıyla satın alınan abonelikler de dahil olmak üzere ücretli bir Azure aboneliği gerektirir. Visual Studio, ücretsiz deneme ve öğrenci abonelikleri ile Azure kredileri Web IQ için geçerli değildir. Web IQ kaynağını oluşturma işlemi Azure hesabınızın durumu nedeniyle engelleniyorsa, hata iletisi gözden geçirme talebinde bulunabilen Microsoft hesabı destek ekibiyle iletişime geçmenizi ister.
Uygulamam hangi API'leri çağırabilir?
Her bir Web IQ AppID, Web Araması, Haberler, Resimler, Videolar, Göz Atma, Yerler ve Otomatik hizmetlerini çağırabilir. Otomatik, İzin Verilen Hizmetler altında listelenmiyorsa AppID'nizle bir Web IQ Desteği isteği açın. AppID'nizin hangi API'leri çağırabileceğini görmek için Web IQ Geliştirici Portalı'nda oturum açın, Profil Yönetimi'ne gidin, sol üstteki açılan listeden AppID'nizi ada göre seçin ve İzin Verilen Hizmetler'i işaretleyin.
Ticaret API'lerine nasıl erişebilirim?
Ticaret API'leri (Arama, Teklifler ve Ürün Ayrıntıları) özel önizleme aşamasındadır ve tam belge erişimine sahip AppID'lere dahil edilir. AppID'nizde yoksa, bir Web IQ Destek isteği açın, sorun türü olarak Kimlik Doğrulaması ve Erişim'i seçin ve appID'nizi veya şirketinizin adını ve henüz yoksa Web IQ kaynağınızın adını ekleyin. Ticaret kullanımı çağrı başına faturalandırılır; bkz. Fiyatlandırma. API başvurusu için bkz. Commerce.
Ticaret API'leri ne yapabilir? Checkout'ı destekliyorlar mı?
Üç Ticaret API'si vardır. Arama, bir ürün sorgusunu her biri satıcı tekliflerine sahip dereceli ürünlere dönüştürür (fiyat, satıcı, teklifin bağlantısı, görüntüler, sevkiyat bilgileri ve koşulu). Teklifler, arama sonucundan bir ürün için uygun satıcı tekliflerini döndürür. Ürün Ayrıntıları, bir ürünün başlığını, açıklamasını ve ortalama derecelendirmesini döndürür. Ticaret API'leri satın alma, ödeme veya diğer işlemleri desteklemez: satıcıdaki her teklife bağlantılar içeren ürün ve teklif bilgilerini döndürür.
Uygulamam Commerce tekliflerine nasıl bağlanmalıdır?
Bir kullanıcı veya kullanıcı adına hareket eden bir temsilci tarafından teklife yapılan her bağlantı ya da gezinti için, her teklifin clickUrl değerini bu yanıtta döndürüldüğü şekliyle aynen kullanın. Çıkarmayın, yeniden yazmayın, kısaltmayın veya yeniden kullanmayın ve yalnızca tüccarı veya satıcıyı tanımlayan displayUrl bağlantısı vermeyin.
clickUrl öğesini kendi izleme bağlantınızla yalnızca orijinali değiştirmeden iletiyorsa sarabilirsiniz. Her bağlantıyı, bir modelin yeniden üretmesine izin vermek yerine, yanıttan uygulama kodunda oluşturun. Ayrıntılar için Teklif bağlantıları ve kaynak belirtme bölümüne ve Web IQ Kullanım Koşulları belgesinin Ek B'sine bakın.
Oturum açmak için hangi adresi kullanmalıyım?
Web IQ'ya erişimi olan Microsoft oturum açma adresini kullanın: sizin için etkinleştirilmiş Microsoft adresi veya Web IQ Geliştirici Portalı'nda Web IQ kaynağınızı bağlamak için kullandığınız hesabı kullanın. Bu normalde posta kutusu adresinizden farklı olabilecek Azure, Teams veya Office için kullandığınız adrestir.
Onaylamak için Azure portalına oturum açın ve sağ üst köşedeki adresi denetleyin.
Oturum açarken neden erişimim olmadığı söyleniyor?
İlk olarak, Azure portalın sağ üst köşesinde gösterilen adresin Web IQ'ya erişimi olan adresle tam olarak eşleştiğinden emin olun. Kuruluşlar genellikle Microsoft oturum açma için bir adres, e-posta için başka bir adres kullanır.
Adresler eşleşiyorsa, kuruluşunuz Microsoft Corporation kiracısına kiracılar arası konuk erişimini engelleyebilir. BT yöneticinizden bu erişime izin vermesini isteyin.
Nereden yardım alabilirim?
Ürün yardımı için Microsoft Web IQ destek sitesini ziyaret edin. İzin verilen kullanım, gizlilik, depolama veya görüntüleme hakkındaki sorular için geçerli Web IQ Kullanım Koşulları'na ve geçerli müşteri sözleşmenize başvurun.
API kimlik doğrulaması
Hangi kimlik doğrulama yöntemleri desteklenir?
Web IQ şunları destekler:
- OAuth 2.0 istemci kimlik bilgileri akışı aracılığıyla Microsoft Entra ID bearer belirteçleri Bu, üretim iş yükleri için önerilir.
-
x-apikeyistek üst bilgisinde gönderilen API anahtarları.
Tüm API trafiği HTTPS kullanır.
Sunucudan sunucuya kimlik doğrulamasını nasıl yapılandırebilirim?
Microsoft Entra ID'a bir uygulama kaydedin ve OAuth 2.0 istemci kimlik bilgileri akışını kullanın. Uygulama kaydının Entra uygulama (istemci) kimliğini Web IQ Geliştirici Portalı'nda Web IQ AppID'nize bağlayın, bir erişim belirteci alın ve bunu Authorization: Bearer <access_token> olarak gönderin.
Kurulumun tüm adımları için Kimlik doğrulaması bölümüne bakın.
Kendi API anahtarlarımı yönetebilir miyim?
Yes. Web IQ Geliştirici Portalı'ndan istediğiniz kadar API anahtarı oluşturabilirsiniz. Anahtar oluşturmak için ücret alınmaz.
Web IQ API yetkilendirmesi için Azure RBAC kullanıyor mu?
No. Web IQ, İnternet üzerinden çağırdığınız Microsoft tarafından barındırılan bir hizmettir. Azure aboneliğinize dağıttığınız Web IQ kaynağı ölçüm ve faturalamayı işler, ancak istek yolunda olmadığından Azure RBAC rollerinin bağlanacağı bir hizmet kaynağı yoktur.
Web IQ istekleri AppID başına yetkilendirir. Her AppID'nin kendi içerik uygunluğu profili ve kotası vardır ve yetkisiz çağrılar HTTP 403 döndürür. Farklı erişim ilkeleri veya kotaları gibi ekipleri veya iş yüklerini ayırmak için birden çok AppID kullanın.
Bir Entra uygulaması (istemci) kimliği birden fazla Web IQ AppID çağırabilir mi?
Yes. Tek bir Entra uygulaması (istemci) kimliği, bir veya daha fazla AppID'yi çağırmak için yetkilendirilebilir. AppID'yi seçmek için bunu sorgu parametresi olarak geçirin, örneğin https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>. API, AppID'yi şu şekilde belirler:
- Entra uygulama (istemci) kimliğiniz bir AppID'ye bağlıdır: AppID belirtmezseniz veya söz konusu AppID'yi belirtirseniz, istek başarılı olur (HTTP 200). Farklı bir AppID belirtirseniz, istek HTTP 403 döndürür.
- Entra uygulama (istemci) kimliğiniz birkaç AppID'ye bağlıdır: birini belirtmeniz gerekir. Eksik veya boş bir AppID HTTP 400 döndürür; bağlı AppID'lerinizden biri başarılı olur (HTTP 200); diğer tüm AppID'ler HTTP 403 döndürür.
- Entra uygulama (istemci) kimliğiniz herhangi bir AppID'ye bağlı değil: istek HTTP 401 döndürür.
API anahtarıyla kimlik doğrulaması (x-apikey) etkilenmeden kalır. Her API anahtarı tek bir AppID'ye bağlıdır, bu nedenle APPID anahtar kimliği doğrulanmış çağrılar için hiçbir zaman gerekli değildir ve kabul edilmez.
Barındırılan bir aracı hangi kimlik doğrulamayı kullanmalıdır: Yönetilen Kimlik veya AgentID?
İkisi de işe yarar. Yönetilen Kimlik ve AgentID Entra ID kimliklerdir ve Web IQ, Web IQ Geliştirici Portalı'nın Profil Yönetimi sayfasından Entra uygulaması (istemci) kimliği Web IQ AppID'nize bağlı olan tüm Entra kimliklerini kabul eder.
Hangisini kullandığınız, aracının nerede barındırıldığına bağlıdır:
- Yönetilen Kimlik, Foundry, App Service, Container Apps, AKS, İşlevler veya VM'ler gibi Azure altyapısında çalışan aracılara uyar. Sistem tarafından atanan ve kullanıcı tarafından atanan kimliklerin her ikisi de çalışır.
- AgentID, bir aracı kimliği sağlayan Foundry veya Copilot Studio tarafından barındırılan aracılar için uygundur.
- Azure dışında, örneğin kendi Kubernetes kümenizde veya başka bir bulutta barındırılan aracılar, istemci sırrı veya federe kimlik bilgisiyle standart bir Entra uygulama kaydı kullanabilir.
Her durumda, çağrı OAuth 2.0 istemci kimlik bilgileri akışını kullanır ve belirteci Authorization: Bearer <access_token> olarak gönderir. Kurulum adımları için bkz. Kimlik doğrulaması . Üst bilgideki x-apikey bir API anahtarı, prototipler için daha basit bir seçenek olarak kalır.
Ağ ve güvenlik
Web IQ Özel Bağlantı, özel uç noktaları, VNet tümleştirmesini veya IP izin listesini destekliyor mu?
No. Bunların hiçbiri bugün desteklenmemektedir. Web IQ'ya, https://api.microsoft.ai/v3Entra ID veya API anahtarı kimlik doğrulaması ile HTTPS üzerinden tek bir genel uç nokta üzerinden erişilir. API uç noktasında IP tabanlı erişim denetimi yoktur.
Azure aboneliğinizdeki Web IQ kaynağı ölçüm ve faturalamayı işler ancak istek yolunda yer almaz; bu nedenle Özel Bağlantı, sanal ağ tümleştirmesi, Azure Güvenlik Duvarı, NSG'ler ve merkez-uç topolojileri gibi Azure ağ denetimlerinin Web IQ tarafında bağlanacak hiçbir şeyi yoktur. Kimlik (Entra ID) tümleştirmesi Azure ile hizalıdır; ağ katmanı ise hizalı değildir.
Sizin tarafınızda, çıkış denetimlerinizde api.microsoft.ai ana bilgisayar adına izin verin.
Azure'dan Web IQ'ya giden trafik Microsoft ağında mı yoksa Azure omurgasında mı kalıyor?
Bunun garantisi yoktur. İstemciler genel https://api.microsoft.ai uç noktaya bağlanır ve trafik aktarım sırasında HTTPS ile güvence altına alınır.
Web IQ API trafiği, şu şifreleme paketleriyle TLS 1.2 ve TLS 1.3'ü destekleyen Azure Front Door’da sonlanır:
-
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
Zscaler veya başka bir çıkış trafiği inceleme aracı Web IQ'yu etkiler mi?
api.microsoft.ai bağlantılarına izin verecek şekilde yapılandırıldığında müdahale etmemelidir. Bu, geniş kapsamlı bir baypas değil, standart bir allow-list eylemidir. Aynı yaklaşım, Netskope gibi diğer güvenli web ağ geçitleri için de geçerlidir.
Web IQ'yu Azure API Management arkasına koyabilir miyim?
Yes. Azure API Management veya başka bir ağ geçidini, gözlemlenebilirlik ve idare için kendi Azure aboneliğinize Web IQ'nun önüne yerleştirebilirsiniz ve bilinen engelleme sınırlamaları yoktur. API çağrıları, API anahtarı veya Entra ID belirteci ile çağıranınızdan https://api.microsoft.ai/v3 öğesine TLS üzerinden gider; dolayısıyla bu trafiğin önüne koyduğunuz her şey kiracınızda kendi altyapınızdır. Microsoft bu dağıtımlar için bir başvuru mimarisi yayımlamaz; bu tasarım bulut mimarisi ekibinize aittir.
Web IQ Kullanım Koşulları uyarınca, ağ geçidinin ne yaptığı fark etmeksizin yanıt içeriği bir türev veri kümesi oluşturmak için önbelleğe alınamaz veya depolanamaz. Durum, gecikme süresi, üst bilgiler ve izleme kimlikleri gibi operasyonel telemetri, örneğin Application Insights'ta veya Log Analytics'te tutulabilir.
Hangi güvenlik denetimleri kullanılabilir?
- Kimlik doğrulaması: Entra ID (OAuth 2.0 istemci kimlik bilgileri) veya bir API anahtarı.
- Yetkilendirme: API'lere AppID başına erişim. Yetkisiz aramalar HTTP 403 döndürür.
- Oran sınırlaması: AppID başına kota uygulaması. Sınırın üzerindeki istekler HTTP 429 döndürür.
- Taşıma: Yalnızca HTTPS.
Ağ sınırınızdaki ağ ilkesi sizin sorumluluğunuzdadır. Değerlendirmek istediğiniz belirli mimari gereksinimleriniz varsa Web IQ Desteği'ne başvurun.
Hız sınırları ve API anahtarları
İstek sınırı var mı?
Yes. Her Web IQ AppID'nin varsayılan sınırı saniyede 15 sorgudur (QPS). Bir Web IQ kaynağında genellikle, kaynağa bağlandığınızda oluşturulan bir AppID bulunur. Web IQ Geliştirici Portalı sınırı görüntüler.
Sınır, söz konusu AppID için tüm API anahtarları ve bağlı Entra uygulaması (istemci) kimlikleri arasında paylaşılır. Sınırın üzerindeki istekler HTTP 429 döndürür.
Hız sınırımı artırabilir miyim?
Yes. Her Web IQ AppID 15 QPS ile başlar. Daha yüksek bir sınır istemek için, beklenen trafik ve kullanım örneğinizle bir Web IQ Desteği isteği açın.
Kaç API anahtarı oluşturabilirim?
Uygulamanızın ihtiyaç duyduğu kadar anahtar oluşturabilirsiniz. Anahtar oluşturma ücretsizdir, ancak bir AppID için tüm anahtarlar hız sınırını paylaşır.
Gizlilik ve veri işleme
Web IQ, API sorgularını günlüğe kaydeder mi?
Yes. API istekleri işletimsel amaçlarla günlüğe kaydedilir: hizmet güvenilirliği, hata ayıklama ve kalite geliştirme. Bu, Microsoft hizmetleri için standarttır.
- Erişim, yalnızca yetkili Microsoft mühendislik ve operasyon personeli ile sınırlıdır ve Microsoft iç erişim denetimi ilkelerine tabidir. Günlüklerdeki verilere diğer müşteriler veya üçüncü taraflar erişemez.
- Günlükler Microsoft üretim altyapısında depolanır ve rol tabanlı erişim denetimi ve denetim izleri dahil olmak üzere Microsoft standart güvenlik denetimlerine tabidir.
- Günlükler, Microsoft standart şifreleme uygulamaları kullanılarak aktarım sırasında (HTTPS) ve depolanırken şifrelenir.
Microsoft, Microsoft Gizlilik Bildirimi kapsamında veri denetleyicisi olarak faaliyet gösterir.
Sorgular ne kadar süreyle korunur?
Sorgu telemetrisinin saklanması, Web IQ Kullanım Koşulları'nın 4. Bölümü tarafından düzenlenir; bu bölüm, Microsoft'un işlemesini Microsoft Gizlilik Bildirimi'ne tabi kılar. Gizlilik Bildirimi'nin tanımladığı dışında Web IQ'ya özgü ayrı bir saklama taahhüdü yoktur.
Yasal düzenlemelere tabi veya hassas iş yükleri için sorgu günlüğünü kapatabilir miyim?
Sorgu metni, standart istek telemetrisinin bir parçası olarak yakalanır ve işlenmesi Microsoft Gizlilik Bildirimi ve Web IQ Kullanım Koşulları'nın 4. Bölümüne tabidir.
Belirli bir mevzuat veya uyumluluk gereksiniminiz varsa, Web IQ sorgu metnini telemetri verilerinden hariç tutan Sıfır Sorgu Günlüğü sunar. Sorgu hâlâ isteği karşılamak için Microsoft’a gönderilir; Sıfır Sorgu Günlüğü, sorgu metnini günlüklerimizden uzak tutar. Self servis değildir: Ürün ekibimiz tüm uygulamalarınız veya yalnızca belirli uygulamalar için bu özelliği sizin için açar. İstekte bulunmak için Microsoft hesabı ekibinize başvurun ve şunları paylaşın:
- Geçerli olan mevzuat veya uyumluluk çerçevesi (örneğin, GLBA, HIPAA, GDPR veya APPI).
- Dağıtım senaryonuzun kısa bir açıklaması.
Zero Query Logging ile sorgu metni, sonuç başlıkları ve URL'ler, IP adresi ve Entra uygulama kimliği saklanmaz. Hizmeti çalıştırıp faturalandırabilmemiz için AppID, izleme kimliği, zamanlama, durum ve faturalama alanları tutulur. Sizin tarafınızda yapılandıracak bir şey yok.
Sıfır Sorgu Günlüğü'nin açık olup olmadığını kontrol edebilir miyim?
Web IQ Geliştirici Portalı'nda veya API'de değil. Örneğin bir denetim için onay gerekiyorsa, AppID'nizle bir Web IQ Destek talebi açın ve Web IQ Desteği ayarı yazılı olarak onaylar.
Api, Terraform veya Azure İlkesi aracılığıyla Sıfır Sorgu Günlüğünü açabilir veya zorunlu kılabilir miyim?
Bugün olmaz. Ürün ekibimiz, tüm uygulamalarınız veya belirli uygulamalar için istek üzerine Zero Query Logging’i açar. Tüm uygulamalarınız için açık olduğunda, kuruluşunuzun Microsoft Entra kiracısı altında oluşturulan yeni uygulamalar, başka bir isteğe gerek kalmadan otomatik olarak kapsanır. Açmak, gerektirmek veya denetlemek için API, Terraform ayarı veya Azure İlkesi tanımı yoktur. Mevcut Azure izinlerinizle aboneliklerinizde Web IQ kaynaklarını kimlerin oluşturabileceğini denetleyebilirsiniz. Denetimin ayarını onaylamak için AppID'nizle bir Web IQ Desteği isteği açın.
Web IQ hangi veri ikameti taahhütlerini sağlar?
Bugün yok. Web IQ bölgeye özgü veri ikameti veya bölge içi işleme taahhütleri oluşturmaz ve kullanılabilir en yakın uç noktaya bölgeler arası yönlendirme beklenen bir davranıştır. Gizlilik, Microsoft Gizlilik Bildirimi kapsamındadır. Microsoft, verilere erişebilecek personelin konumu veya uyrukları hakkında taahhüt sunmaz.
Web IQ, Azure Veri Koruma Eki veya AB Veri Sınırı kapsamında yer alıyor mu?
No. Web IQ Kullanım Koşulları'nın 4.1. Bölümü, hizmeti Microsoft Ürün ve Hizmetler Veri Koruma Eki'nin dışında tutar.
Bunun yerine, Microsoft ve müşteri Kullanım Koşulları (Bölüm 4.4) kapsamında işlenen tüm Kişisel Veriler için bağımsız veri denetleyicileri olarak hareket eder. Microsoft işlemesi Microsoft Gizlilik Bildirimi 'ne (Bölüm 4.2) tabidir ve son kullanıcılarınıza uygun bildirimi vermek sizin sorumluluğunuzdadır.
Uluslararası aktarımlar için, Kullanım Koşulları gerektiğinde Standart Sözleşme Maddelerini içerir (Bölüm 4.6.1). Bu aktarım mekanizması, Veri Koruma Eki aracılığıyla değil, Microsoft Müşteri Sözleşmesi altında yer alan Kullanım Koşulları üzerinden ilerler.
Web IQ bugün EU Data Boundary, bölgeye özgü veri yerleşimi veya bölge içi işleme taahhüdünde bulunmaz.
Japonya'nın APPI'sı gibi belirli bir gizlilik yasası için DPA veya uyumluluk bildirimi sağlıyor musunuz?
No. Web IQ, Microsoft Ürün ve Hizmet Veri Koruma Eki'nin (Web IQ Kullanım Koşulları'nın 4.1. Bölümü) dışındadır ve belirli gizlilik yasaları için bildirim yayınlamayız. Microsoft'un yazılı görüşü, Kullanım Koşulları'nın 4. Bölümü ile Microsoft Gizlilik Bildirimi'nin birlikte 4.2 Bölümünün Web IQ için geçerli olduğunu belirtmesidir. Bölüm 4 şunları kapsar:
- Sorgu, son kullanıcının IP adresi, isteğin zamanı ve döndürülen sonuçlar da dahil olmak üzere, isteklerle bağlantılı olarak Microsoft'un toplayabileceği bilgiler (Bölüm 4.2).
- Microsoft ve müşteri, bağımsız veri denetleyicileridir (Bölüm 4.4).
- İlgili kişi talepleri (Bölüm 4.5).
- Kişisel verilerin, alt yükleniciler ve en azından Kullanım Koşulları kadar korumacı hükümlerle sınırlanmış üçüncü taraflar dışında üçüncü taraflara aktarılması gerekmez (Bölüm 4.7.2).
- Mevzuat şikayetleriyle ilgili işbirliği (Bölüm 4.8).
Web IQ sorgulardaki kişisel verileri algılamaz veya maskelemez ve veri yerelliği taahhütleri vermez. Hukuk ekibiniz, bunun sizin için geçerli olan yasa kapsamındaki yükümlülüklerinize nasıl uyduğunu değerlendirmek için en uygun olandır; takip sorularına yanıt vermek bizim için bir mutluluk.
Web IQ sorgulardaki kişisel verileri algılar veya maskeler mi?
No. Web IQ, gelen sorgulardaki kişisel verileri sunucu tarafında algılamaz veya maskelemez. Bir iş yükü kişisel veya hassas veriler gönderebilirse, Web IQ'yu çağırmadan önce bu verileri temizleyin; örneğin, ön işleme adımı olarak Azure Yapay Zeka Dil PII Algılama kullanın. Bu şekilde, hassas hiçbir şey ortamınızdan ayrılmaz ve API'ye ulaşan öğe üzerinde tam denetim sahibi olursunuz.
Web IQ düzenlemeye tabi sektörleri destekliyor mu?
Yes. Web IQ, çeşitli kurumsal ve düzenlenmiş kullanım örneklerini destekler. Özel uyumluluk, yönetişim veya sektör gereksinimleriniz varsa Web IQ Desteği'ne başvurun.
İçerik güvenliği ve kapsamı
Hangi içerik güvenliği denetimleri uygulanır?
Web IQ, tarama sırasında kalite ve güvenlik sınıflandırması, yetişkinlere yönelik içerik filtreleme ve müşteri başına içerik uygunluk kuralları uygular. Güvenli Arama varsayılan olarak strict sunucu tarafında zorlanır. Web Araması sonuçları, ek istemci tarafı işleme için bir isAdult alan da içerir.
Web IQ, bir LLM'yi alınan içerikteki prompt enjeksiyonuna karşı korur mu?
Microsoft Web IQ içeriği web'den getirir ve sıralar; alınan içeriğe eklenmiş yönergeleri yürütmez, yorumlamaz veya yönergelere göre işlem yapmaz. Web IQ, Bing'in mevcut kalitesi, güveni, spam ve kötü amaçlı içerik taramasıyla bu alma davranışını tamamlar.
Dolaylı istem enjeksiyonu, jailbreak girişimleri ve yönerge takip saldırılarına karşı koruma öncelikli olarak aşağı akış modelinin ve orkestrasyon katmanının sorumluluğundadır. İstemlere ve alınan içeriğe güvenilmeyen girişler olarak davranın ve İstem Kalkanları, Azure Yapay Zeka İçerik Güvenliği, sistem istemi yalıtımı, en az ayrıcalıklı araç erişimi, dayanak doğrulaması ve çıkış doğrulaması gibi katmanlı denetimler uygulayın. Web IQ, prompt enjeksiyonunu önleme için tek uygulama noktası olarak değerlendirilmemelidir.
Web IQ bunu döndürmeden önce web içeriği nasıl işlenir? İstem benzeri yönergeler için arındırılmış mı?
Microsoft Web IQ geri getirme sırasında doğrudan ham sayfa HTML'sinde çalışmaz. Dizin oluşturma sırasında, web içeriği anlamlı içeriği ve belge yapısını korumak için tasarlanmış yapılandırılmış bir belge gösterimine normalleştirilir. Web IQ tarafından döndürülen pasajlar bu gösterimden seçilir ve bu da API genelinde daha tutarlı ayıklama ve alma sağlar. Bing'in mevcut kalite, güvenlik, istenmeyen posta ve kötü amaçlı içerik taraması, dizin oluşturma işlem hattının bir parçası olarak da geçerlidir.
Web IQ, döndürülen içeriğin betik veya kötü amaçlı yazılım içermediğini garantileyemez ve bu normalleştirme, istem benzeri metnin tanımlanmasını veya kaldırılmasını garantilemez. Alınan içeriği güvenilmeyen giriş olarak değerlendirin ve önceki yanıtta açıklanan model ve orkestrasyon katmanı korumalarını uygulayın.
Web IQ gizli veya kullanıcıya yönelik olmayan sayfa içeriğini döndürür mü?
Microsoft Web IQ, normal sayfa denetimleri veya istemci tarafı işleme aracılığıyla görüntülenen içerik de dahil olmak üzere normal kullanıcı etkileşimi aracılığıyla görünen içeriği döndürmeye çalışır. Bu garanti edilmez. Sayfa yapısı ve uygulaması farklılık gösterir, bu nedenle uygulamalar döndürülen her pasajın sayfanın ilk durumunda görünür olduğunu veya her gizli öğenin her zaman dışlandığını varsaymamalıdır.
Microsoft dizin kalitesini nasıl korur?
Sayfalar kalite, otorite ve güvenilirlik açısından değerlendirilir. Kötü amaçlı, istenmeyen posta ve kimlik avı içeriği algılanır ve dışlanır ve dizin sürekli yenilenir. Bu, Microsoft'un kendi yapay zeka ürünlerinin bağlı olduğu aynı dizindir.
Web IQ yayımcı içerik tercihlerine nasıl saygı duymaktadır?
Web IQ, geçerli robots.txt yönergeleri ve Microsoft tarafından tanınan diğer yayımcı sinyalleri de dahil olmak üzere desteklenen yayımcı denetimlerine uymak için tasarlanmıştır.
Dışlanan sitelerin veya engellenen kategorilerin yayımlanmış bir listesi var mı?
No. Dışlama denetimleri robots.txt uyumluluğu, yasal nedenlerle ve uyumluluk kapsamında kaldırmalar (DMCA bildirimleri ve mahkeme emirleri gibi), istenmeyen posta, kötü amaçlı yazılım ve kimlik avı filtreleme ve yetişkinlere yönelik içerik filtrelemeyi içerir. Listelerin kendileri tescillidir ve sürekli olarak güncelleştirilir. Sonuçlarda görünen veya görünmeyen belirli içerik kategorileri hakkında endişeleriniz varsa, Web IQ AppID yapılandırmanızın bu gereksinimleri karşılayıp karşılamadığını görüşmek üzere Web IQ Desteği ile iletişime geçin.
Web IQ hangi içeriği kapsar ve ne kadar yenidir?
Web IQ, yapay zeka aracınızın veya uygulamanızın kendi modelinin eğitim verilerinin ötesindeki soruları yanıtlamasına yardımcı olmak için web sayfaları, haberler ve görüntü ve video sonuçları genelinde güncel bilgileri sürekli olarak toplar.
Kullanılabilirlik ve güncellik API'ye, kaynak türüne ve kullanım örneğine göre değişir; tüm içerikte tek bir güncellik garantisi yoktur. Kaynakları ve alma ayarlarını seçerken iş yükünüzün güncellik gereksinimlerini göz önünde bulundurun.
Web IQ hangi dilleri ve pazarları destekler?
Web IQ küresel webden yararlanır, ancak kapsam dile, pazara, konuya ve kaynak türüne göre değişir. Her API’nin kabul ettiği kodlar için Desteklenen diller ve bölgeler sayfasını gözden geçirin ve kapsamı hedeflenen kullanıcılarınızın ihtiyaç duyduğu bilgilere göre değerlendirin.
Çin'deki müşteriler https://api.microsoftol.com/v3 numarasını aramalıdır; Haber Arama Çin'de kullanılamaz (Temel URL).
Alan adı izin verme veya reddetme listelerini yapılandırabilir miyim?
Tek tek etki alanları veya küçük listeler için, bir etki alanını eklemek üzere -site:example.com ve bir etki alanını dışlamak için site:example.com gibi standart sorgu işleçlerini kullanın. Web Araması veya Haber Arama'da adlandırılmış bir ekleme ve dışlama kuralları kümesini yeniden kullanmak için, kapsam yönetimi kullanılabilir durumda olan bir ödeme hesabı için bir Web IQ kapsamı oluşturun . Adlandırılmış kapsamlar, birleştirilmiş tanım boyutu sınırına bağlı olarak liste başına en fazla 10.000 normalleştirilmiş benzersiz seçiciyi destekler.
Neden LinkedIn sonuçları göremiyorum?
LinkedIn sonuçları şu anda hariç tutuluyor.
Gözat, dışlanan URL için çağrıldığında ne olur?
Gözat, HTTP 403 döndürür. Temel alınan dışlama listesi erişime sunulmaz.
Web sitemi Web IQ'da nasıl bulunabilir hale getirebilirim?
Web IQ, Microsoft'un kendi yapay zeka ürünlerinde kullandığı aynı web dizini üzerine kuruludur. Site haritaları, IndexNow, Bing Web Yöneticisi Araçları ve uygun bir robots.txt ilkesi gibi standart web bulma uygulamalarını kullanın. Ayrı bir Web IQ gönderim yolu yoktur.
Adlandırılmış arama kapsamları
Web IQ'nun sonuçlarını nasıl denetleyebilirim ve filtreleyebilirim?
Yeniden kullanılabilir URL, site, etki alanı veya yol listelerini dahil etmek ya da hariç tutmak için kullanarak Web Araması ve Haber Araması sonuçlarını filtrelemek üzere Kapsamlar'ı kullanın. Adlandırılmış bir kapsam oluşturun ve ardından scopeName istek parametresiyle seçin. İstisnalar, dahil edilenlerden önce gelir. Bkz. Kapsamlarla sonuçları filtreleme.
Web IQ ödeme hesabının AppID veya Entra istemci kimliğinden farkı nedir?
Web IQ ödeme hesabı, Web IQ AppID'lerini, hesap erişimini ve atanmış bir kapsam koleksiyonunu gruplandırıyor. Web IQ AppID, uygulamanızın çalışma zamanı arama yapılandırmasını seçer. Entra uygulaması (istemci) kimliği, Entra belirteçlerini alan uygulama kaydını tanımlar; Web IQ kimliği değildir. Bakın önemli kavramlara ve yetkilendirilmiş kaynak keşfine.
Kapsam oluşturmak için arama kimlik bilgilerimi kullanabilir miyim?
Arama erişimi otomatik olarak yönetim erişimi vermez. Web IQ yönetim API'sini çağıran bir uygulama için yalnızca uygulamaya özel bir Entra belirteci ve hedeflenen ödeme hesabında CustomerApiAccess gerekir. Bir insan hesabı yöneticisi bunu ayrı olarak verir. Bkz. uygulamaya yönetim API erişimi verme.
Kapsamlar sayfasında neden kullanılabilir faturalandırma hesabı olmadığı belirtiliyor?
Kapsamlar sayfasında yalnızca oturum açma bilgilerinizin erişebileceği faturalama hesapları listelenir. İki şeyi denetleyin:
- Web IQ kaynağınızı Web IQ Geliştirici Portalı'na bağladınız. Bunu yaptıysanız, AppID'niz Profil Yönetimi altında gösterilir. Öyle değilse, Azure portalında Web IQ kaynağı oluşturma adımlarını izleyin.
- Kaynağı bağlamak için kullandığınız adresle oturum açtınız.
Her ikisi de doğruysa ve sayfa hala boşsa bir Web IQ Desteği isteği açın, sorun türü olarak Kimlik Doğrulaması ve Erişim'i seçin ve AppID'nizi ve oturum açtığınız adresi ekleyin.
Kapsamlar tek bir Web IQ AppID'ye özgü mü?
No. Bir ödeme hesabındaki Web IQ AppID'leri kendisine atanan kapsam koleksiyonunu kullanır. Adlar bu koleksiyon içinde büyük/küçük harfe duyarsız olarak benzersizdir. Aynı koleksiyona atanan hesaplar tanımlarını paylaşır, bu nedenle düzenleme veya silme işlemleri bu tanımların tüm tüketicilerini etkiler. Bir adı bilmek başka bir hesabın kapsamlarına erişim izni vermez.
Dahil edilen boş bir liste kapsamı devre dışı bırakır mı?
No. Boş dahil etme, dışlanmayan her kaynağa izin verir. Her iki liste de boşsa, kapsamın kendisi site kısıtlaması uygulamaz. Dışlama her zaman dahil edilmeye göre önceliklidir.
Arama kapsamımı bulamazsa ne olur?
failOnMissingScope varsayılan değeri true: bildirilen kapsam-uygulama hatası kapsamsız bir sonuç yerine bir hata döndürür. Yanlış bir ad veya eksik yayılım, kapsamın eksik olmasına neden olabilir.
false öğesini açıkça ayarlarsanız, arama kapsam olmadan dizinin tamamında devam edebilir ve scopeApplied: false rapor eder. Bu ayarı yalnızca kapsamsız sonuçlar kabul edilebilirse kullanın.
adlandırılmış kapsam hatalarına bakın.
scopeApplied true, aramanın en son kapsam tanımımı kullandığı anlamına mı geliyor?
No.
scopeApplied: true , bu istek için bir kapsam uygulandığı anlamına gelir. Kullanılan sürümü tanımlamaz veya genel yayma garantisi vermez. Hiçbir uygulama sonucu bildirilmemişse alan isteğe bağlıdır; her zaman mevcut olduğunu veya scopeName içermeyen isteklerde false olduğunu varsaymayın.
Dağıtım sırasında önceki bir tanımın kullanılması kabul edilemezse, çağıranları değiştirmeden önce yeni bir ad altında kapsam oluşturun ve doğrulayın. Henüz readiness endpoint'i veya kapsam sürümlendirmesi yok. Tam küresel yayma genellikle yaklaşık 10 dakika sürer, ancak bazı durumlarda 30 dakikaya kadar sürebilir. Şu anda yayma SLA'sı yoktur ve bu zamanlamalar garanti edilmemektedir. Arayanların değiştirilmesi genel olarak eşzamanlı ve bölünemez değildir.
Sorgu davranışı ve sonuç kalitesi
Doğal dil veya anahtar sözcük sorguları mı kullanmalıyım?
İkisi de çalışıyor. Doğal dil sorguları genellikle contentFormat=passage ile iyi çalışır, anahtar sözcük sorguları ise şirket adları, ticker sembolleri veya belirli konular gibi hassas aramalar için kullanışlıdır. Aşırı uzun veya bileşik sorgulardan kaçının; birden çok bilgi gereksinimini ayrı API çağrılarına bölün.
Sorgu uzunluğu üst sınırı nedir?
En fazla 1.000 karakterdir ve daha uzun sorgular reddedilir. Daha kısa, odaklanmış sorgular genellikle daha iyi sonuçlar üretir: sorgu çok fazla bağlam içeriyorsa geri getirme doğru sinyale odaklanmayabilir.
Web Araması sonuçlarını tarihe göre filtreleyebilir miyim?
Web Araması bugün bir tarih aralığı filtresi sunmaz ve gerçekten ihtiyacınız varsa sabit tarih filtresi kullanmanızı öneririz. Güncellik zaten sorguya göre derecelendirmeye dahil edilir ve sabit tarih kısıtlaması eklemek neredeyse her zaman alaka düzeyine mal olur. Haber senaryoları için Web Araması sonuçlarını tarihe göre filtrelemek yerine Haber API'sini kullanın.
lastUpdatedAt , Web IQ'nun sayfayı son denetlediği tarih değil, yayımcının içeriği son güncelleştirdiği tarihtir, bu nedenle eski bir tarih sayfanın yakın zamanda denetlenmediği anlamına gelmez. Yanıtta döndürülür, bir istek filtresi değildir ve her sonuç bunu içermez. Bunu kullanarak uygulamanızdaki sonuçları sıralayabilir veya filtreleyebilirsiniz.
Web Araması birkaç soru içeren bir istem işleyebilir mi?
Her Web Araması isteği bir sorguyu işler. İstem birkaç soru veya amaç içeriyorsa, bunu uygulamanızda ayrı sorgulara bölün, her sorgu için Web Araması'nı çağırın ve yanıtı oluşturmadan önce sonuçları birleştirin.
Web IQ çok adımlı ajan iş akışlarını destekleyebilir mi?
Yes. Bir ajan, görev sırasında ek web kanıtına ihtiyaç duyduğunda Web IQ'yu çağırabilir. Alma gecikmesi, bir yanıt oluşturmadan önce birkaç çağrı yapan iş akışlarında özellikle önemlidir.
Yapay zeka aracım veya uygulamam alınan kanıtları nasıl işlemelidir?
Soruyla ilgili kanıt kullanın ve hangi kaynakların yanıtı desteklediğini izleyin. Alınan içeriği aracıyı denetleen yönergelerden ayrı tutun. Kaynaklar çakıştığında veya kanıt eksik olduğunda, boşlukları desteklenmeyen ifadelerle doldurmak yerine bu belirsizliği açık hale getirin.
Topraklama kalitesi nasıl karşılaştırılır?
Microsoft'un yayımladığı karşılaştırmada, Otomatik ve Web Araması karşılaştırılan hizmetlere göre daha düşük belirteç sayılarında daha yüksek dayanak memnuniyetine ulaştı ve Otomatik genel olarak en yüksek dayanak memnuniyetine ulaştı. Sonuçlar sorgu kümesine, modele ve değerlendirme yöntemine bağlıdır, bu nedenle kendi senaryolarınızda kaliteyi doğrulayın.
Kaynak: Web IQ kıyaslama sonuçları. 8-9 Kasım 2026'da değerlendirilen 2.850 rastgele örneklenmiş küresel sorgu.
Web IQ sağlık kaynaklarını farklı mı ele almaktadır?
Web IQ'nun sıralama modelleri, kaynak güvenilirliği için sinyalleri kullanır. Sağlıkla ilgili sorgular için bu sinyaller, Ulusal Tıp Akademisi tarafından bağımsız olarak geliştirilen ilkeleri temel alır. Bu, Web Araması ve Web Araması'ndan gelen Otomatik sonuçlar için geçerlidir; Haberler için geçerli değildir. Otomatiktir: Açacak bir şey yoktur. Listeyi veya kaynak sayısını yayımlamayız. Sonuçları seçtiğiniz sitelerle sınırlamak için Scopes kullanın.
Sonuçlar neden Bing.com'dan farklıdır?
Web IQ, LLM tüketimi, olgu yoğunluğu, metin kalitesi ve düşük gecikme süresi için iyileştirilmiştir. Bing.com, ek derecelendirme sinyalleri, kişiselleştirme, görsel yanıtlar ve API aracılığıyla yeniden dağıtılamayabilecek içerik içeren bir tüketici deneyimidir. Bazı derecelendirme farklılıkları beklenir.
Özdeş istekler farklı sonuçlar döndürebilir mi?
Dizin sürekli yenilendiğinden ve güncelleştirmeler veri merkezleri arasında yayıldığından bazı çeşitlemeler beklenir. Birbirine yakın yapılan özdeş isteklerin sonuçları geniş ölçüde kararlı kalmalıdır. Birkaç saniye arayla yapılan özdeş sorgularda önemli tutarsızlık görürseniz, Web IQ Desteği ile iletişime geçin.
Sorgu neden beklenenden daha az sonuç döndürmektedir?
Sonuçları saymadan önce ham Web IQ yanıtını denetleyin. En yaygın neden, ölçülmeden önce geçerli sonuçları filtreleyen istemci tarafı ayarı veya aşağı akış işlem hattı adımıdır. Ayrıca site:, içerik uygunluğu, Güvenli Arama davranışı ve sorgudaki herhangi bir -site: veya maxResults işlecini doğrulayın.
Dil, bölge ve konum sonuçları nasıl etkiler?
Sorgunun dili en önemli unsurdur; language ve region parametreleri ikincil bir rol oynar ve bunların etkisi API'ye göre farklılık gösterebilir. Desteklenen tüm diller desteklenen herhangi bir bölgeyle çalışır, örneğin en ile AU, NZ veya IN. Bölge sıralamayı, kaynakların ve birimlerin (örneğin °C veya °F) karışımını etkiler, ancak tarih biçimini etkilemez. Genel bir konu hakkındaki sorgu yine de genel sonuçlar döndürür. "Yakınımda hava durumu" gibi yerel sorgular için konum bölgeden daha önemlidir.
Her iki parametre de iki harfli kodlar alır; diğer herhangi bir değer HTTP 400 döndürür. İki harfli bir bölge desteklenmiyorsa, Web IQ US kullanır. İki harfli dil desteklenmiyorsa, bu bölge için varsayılan dili kullanır. Her iki durumda da hata döndürmez. Bu, Web Araması, Haber Arama ve Otomatik'te de aynı şekilde çalışır. Bkz. Desteklenen diller ve bölgeler.
Auto ve Auto Advanced arasındaki fark nedir?
Bunlar aynı API'nin iki modu. Varsayılan olan Otomatik, bir sorunun kaynaklarını seçer ve alıntı yapılan kanıtı tek bir çağrıda döndürür. Auto Advanced, karmaşık sorular için ek getirme geçişleri çalıştırır; kullanmak için "mode": "advanced" ayarını yapın. Ayrı olarak fiyatlandırılır; bkz. Fiyatlandırma.
Auto ile responseFilter ihtiyacım var mı?
No. Auto, bir sorgu için hangi kanıtın (web, haberler, hava durumu ve daha fazlası) gerekli olduğuna karar verir ve her API'yi ayrı ayrı çağırmanız gerekmeyecek şekilde bunu tek bir çağrıda döndürür.
responseFilter Auto'nun içerebileceği kanıt türlerini listeler; bunu atladığınızda, tüm türler kullanılabilir. Resimler veya videolar gibi hiç istemediğiniz türleri dışarıda bırakmak için yalnızca istediklerinizi (örneğin ["web", "news"]) listeleyin. Sorgu başına değil, uygulamanız için bir kez ayarlayın. Auto, Web Araması ile aynı dilleri ve bölgeleri destekler ve responseFilter her bölgede aynı şekilde çalışır.
Auto API referansına bakın.
İçerik biçimleri
Her sonuç ne döndürür: pasajlar mı yoksa belgenin tamamı mı?
Web Araması ve Haber Arama, her sonucun içeriğini content alanında döndürür.
contentFormat
passage olarak ayarlandığında, belgenin sorgunuzla en ilgili bölümlerini alırsınız.
html, markdown veya text ile tam belgeyi alırsınız: Web IQ'nun dizin oluşturma sırasında oluşturduğu sayfanın yapılandırılmış sürümü. Bölümler her uygulama için çalışır; tam belge biçimleri için belgenin tamamına erişim gerekir. Resimler ve Videolar sayfa içeriğini değil başlıklar, URL'ler ve küçük resimler gibi sonuç ayrıntılarını döndürür. Places; adresler, açılış saatleri, incelemeler ve fotoğraflar gibi yapılandırılmış yer ayrıntılarının yanı sıra sorguyla ilgili bölümleri döndürür. Bkz. Passages ve içerik biçimleri.
passage nedir ve neden kullanılır?
contentFormat=passage değerini ayarlayın; API, her sonuç için belgenin tamamını değil, yalnızca sorguyla en ilgili bölümlerini döndürür. Belgenin tamamı Web IQ tarafında işlenir ve geri gelen sorgu hedefli bir ayıklamadır, bu nedenle LLM'nizin ilgili tümceyi bulmak için ilgisiz paragrafları aşması gerekmez.
- Belirteç tasarrufu: LLM, belgenin tümü yerine bir bölümünü alır.
- Daha iyi olgusal doğruluk: Bağlamda daha az konu dışı içerik olduğunda modelin tanjantel bir paragrafa bağlanma olasılığı daha düşüktür.
contentFormat=passage öğesini her Web Araması ve Haber isteğinde ayarlayın. Gözat ayrıca passage destekler: bir query gönderin; Gözat, sayfanın sorgunuzla en ilgili bölümlerini döndürür.
Hangi biçimi kullanmalıyım?
Topraklama için passage kullanın. Önerilen biçimdir ve her uygulama için çalışır. Belgenin tamamına ihtiyacınız olduğunda, örneğin eksiksiz bir sayfayı özetlemek veya ayıklamak için, html, markdown veya text kullanın. Bu biçimler tam belge erişimine ihtiyaç duyar.
Her istekte maxLength ve contentFormat ayarlamalı mıyım?
Yes. Beklediğiniz biçimi ve uzunluğu her zaman elde edebilmeniz için her Web Araması ve Haber isteğinde her ikisini de ayarlayın.
content alanı ne kadar uzun olabilir?
maxLength karaktere kadar. Tam belge erişimi olmadan, pasajlar maxLength daha yüksek olsa bile sonuç başına en fazla 3.000 karakterdir. Tam belge erişimi ile content, maxLength olabilir; en fazla 500.000 karakter.
maxLength değerinden uzun olan tam belgeler kesilir.
text öğesini html, contentFormat veya AuthContentFormatForbidden olarak ayarladığımda neden HTTP 403 (markdown) alıyorum?
Web Araması ve Haber Araması'nda text, html ve markdown, belgenin tamamını döndürür ve belgenin tamamına erişim gerektirir. Bu olmadan, bu biçimler AuthContentFormatForbidden hata koduyla HTTP 403 döndürür.
passage her uygulama için çalışır.
Belgenin tamamını html, markdown veya text olarak nasıl alabilirim?
Bir Web IQ Desteği isteği açın. Halihazırda html veya text kullanan uygulamalar bugün olduğu gibi çalışmaya devam eder.
Gözat işlevi ne döndürür?
Gözat, seçtiğiniz URL için maxLength karaktere kadar içerik döndürür.
contentFormat ve queryolarak ayarlandığındapassage, sayfanın sorguyla en ilgili bölümlerini döndürür. Bu, uygulamanız tam belge erişimine sahip değilse varsayılan biçimdir. Tam belge erişimiyle, belgenin tamamını html, markdown veya text olarak da döndürebilir. Bkz. Browse API referansına göz atın.
Neden bir query göndermediğimde Browse'dan HTTP 400 alıyorum?
Bir geçiş isteği, boş olmayan bir query gerektirir.
passage, uygulamanızın tam belge erişimi yoksa varsayılan biçimdir; bu nedenle her Gözat isteğine en fazla 1000 karakter olacak şekilde query ekleyin. Bkz. Passages ve içerik biçimleri.
Bağlam penceresini ve belirteç maliyetlerini yönetmek için maxLength ve maxResults değerlerini nasıl ayarlamalıyım?
Web IQ, gereksiz sayfa bağlamı sağlamak yerine sorguyla ilgili bölümlerin önceliğini ayarlayabilir. Bu, modelinize geçirilen metin miktarını azaltabilir ve giriş belirteci maliyetlerini düşürebilir. Avantajlar modelinize, istemlerinize, sorgu karışımına ve alma ayarlarınıza bağlıdır.
Çoğu grounding senaryosunda, daha kısa pasajlara sahip daha fazla sonuç, kabaca aynı toplam belirteç bütçesi için daha uzun pasajlı daha az sonuçtan daha iyi çıkış sağlar. İyi bir başlangıç noktası, passage ile maxResults=10 biçiminde yaklaşık 3.000 karakterlik maxLength içeriğidir. Kendi sorgularınız ve modelinizle karşılaştırın.
Web Araması ve Haber Arama neden bir snippet alan döndüremiyor?
Bu, tasarım gereğidir. Her ikisi de, ayrı, sorgudan bağımsız bir content yerine, sorguya bağımlı bir ayıklama (passage) olarak snippet döndürür.
Yanıt içeriği
Web Araması için en yüksek maxResults değer nedir?
Web Araması, istek başına en fazla 50 sonuç destekler.
Hangi istek parametrelerini yapılandırabilirim?
Web Araması maxResults, region ve language, contentFormat (passage, text, html veya markdown), maxLength ve safeSearch sunar. Tam parametre listesi için API başvurusuna bakın.
ile lastUpdatedAtarasındaki crawledAt fark nedir?
lastUpdatedAt, kullanılabilir olduğunda Web Araması, Haberler, Videolar, Görüntüler, Gözat ve Otomatik tarafından döndürülen, yayımcı tarafından bildirilen içerik güncelleştirme tarihidir.
crawledAt Web IQ'sunun sayfayı en son getirme zamanıdır; Web Araması, Gözat, Haberler ve Otomatik tarafından döndürülür. İsteğinizin zamanı değil. Her iki alanın kapsamı da sonuclara göre değişir ve her sonuç bunları içermez.
Browse Live Crawl nedir ve ne zaman kullanmalıyım?
Gözat işlevi, Bing web dizininden içerik döndürür. Bu dizin, web tarayıcılarımız web genelindeki değişiklikleri gözlemledikçe sürekli yenilenir. Web araması genel olarak bu şekilde çalışır: Arama sonuçları, her istekte her URL'yi canlı olarak getirmek yerine bir dizinden sunulur ve Browse'ın hızını ve tutarlılığını sağlayan budur.
Gözat özelliği, dizinde bulunmayan URL'ler için Live Crawl'u destekler. Dizine alınan kopya eksik olduğunda canlı getirme istemek için istekte liveCrawl: "fallback" değerini ayarlayın. Canlı tarama yayıncı nezaketi kısıtlamalarına ve erişilebilirliğine tabidir; fallback gerçek bir taramayı garanti etmez. Dizine alınan içerik varsa Browse bunu döndürür. Parametrenin (veya liveCrawl: "none" olarak ayarlanmasının) atlanması, canlı tarama olmadan yalnızca dizine alınmış içeriği döndürür. Tüm parametre ayrıntıları için API başvurusuna göz atma bölümüne bakın.
Live Crawl, Web IQ Browse'da varsayılan olarak kullanılabilir ve genel Browse QPS'nizden ayrı olarak sınırlı bir saniye başına kapasite tavanı ile sağlanır. Bu tavan, AppID altındaki tüm API anahtarları arasında paylaşılır. Çoğu Browse iş yükünün Live Crawl’a ihtiyacı yoktur ve en iyi standart dizinli yol üzerinden sunulur; bir URL dizinde mevcut olmadığında Live Crawl’ı kullanın.
Browse, JavaScript ile işlenen sayfaları alabilir mi?
Yes.
liveCrawl: "fallback" ile birlikte renderDynamicPages: true kullanın. Tam parametre kümesi ve yanıt ayrıntıları için Browse API başvurusu. Üretimdeki bu davranışa bağlı olmadan önce temsili URL'leri test edin.
Browse, çevrimiçi PDF dosyalarını çıkarabilir mi?
Çevrimiçi ortamda barındırılan PDF'ler bugün belgelenmiş bir Browse senaryosu değildir. Belirli bir PDF kullanım örneğiniz varsa, örnek bir URL ve beklediğiniz davranışla Web IQ Desteği'ne başvurun ve kesin bir yanıt alırsınız.
Faturalama ve Hukuk
Web IQ maliyeti nedir?
Web IQ, tüketim tabanlı, çağrı başına fiyatlandırmayı kullanır. Fiyatlandırma, hesabınız için etkinleştirilen API'lere, kullanımınıza ve ticari koşullarınıza bağlıdır. Güncel fiyatlar için Fiyatlandırma sayfasına bakın. Web IQ, Azure üzerinden faturalandırılır, dolayısıyla kullanımınız Microsoft Azure Tüketim Taahhüdü (MACC) kapsamında sayılır ve Azure Tüketim İndirimi (ACD) ile diğer anlaşmalı Azure indirimleriniz bu fiyatlara uygulanır. Commerce, özel önizlemede, çağrı başına da faturalandırılır: Arama, Teklifler ve Ürün Ayrıntıları tek bir sayaç ve aynı fiyatı paylaşır.
Faturalama Azure'da nasıl görünecek?
Web IQ kullanımı ölçülür ve Web IQ kaynağınız aracılığıyla Azure aboneliğinize faturalandırılır. Hizmetin kendisi Microsoft tarafından barındırılır, kiracınızda sağlanmaz.
Web IQ maliyetlerinizi görmek için Azure portalında aboneliğinizin Maliyet analizi'ni açın, Kaynağa göre maliyet görünümünü kullanın ve kaynak türüne microsoft.webiq/accountsgöre filtreleyin. Çağırdığınız her API (örneğin, Web Araması, Resimler veya Haberler) kendi sayacı olarak gösterilir. Auto'nun iki sayacı vardır, biri /auto için, diğeri ise mode: advanced ile birlikte /auto içindir. Ticaret API'leri bir sayaç paylaşır.
Web IQ bir SLA, RTO veya RPO taahhüdü içeriyor mu?
No. Microsoft Web IQ, bir hizmet düzeyi sözleşmesi içermez. Web IQ Kullanım Koşulları çalışma süresi, gecikme süresi, Kurtarma Süresi Hedefi (RTO) veya Kurtarma Noktası Hedefi (RPO) hedeflerini taahhüt etmez ve tek tek müşteriler için SLA koşulları eklenmez.
Alıntıları görüntülemem gerekiyor mu?
Yes. Web IQ Kullanım Koşulları'nın Ek A, Bölüm 1'i (LLM Kullanımı), görüntülenen LLM içeriği için kullanılan her kaynağın belirtilmesini ve bu içeriğin yakınında her bir kaynağa geri bağlantı verilmesini gerektirir.
- Yalnızca yanıtı oluşturmak için kullanılan kaynakları alıntılayın. Web IQ 10 sonuç döndürdüyse ve modeliniz 3 kullandıysa, bu 3'leri görüntüleyin.
- Alıntılar yanıtla birlikte görünür kalmalı ve tek bir eylemle erişilebilir olmalıdır. Bunları yalnızca kısa bir süre göstermeyin, birden çok ekranın arkasında gizleyin veya kullanıcıların kaynakları ayrı olarak istemesini zorunlu tutun.
- Araba, giyilebilir cihazlar, ses öncelikli cihazlar veya bilgi noktaları gibi kısıtlanmış arabirimler için, geçerli yanıt için kullanılan her alıntıyı listeleyen bir sayfaya yönlendiren kalıcı bir QR kodu, tıklanabilir alıntılarla yanıtı gösteren yardımcı bir uygulama veya kullanıcının doğrudan açabileceği bir ekran listesi kullanın.
LLM Özeti ile gösterilen kaynak bağlantılarını onunla birlikte, son kullanıcının sohbet geçmişinde veya dahili iş ürününüzün bir parçası olarak depolayabilirsiniz. Aşağıdaki önbelleğe alma sorusuna bakın.
Yapay zeka aracım veya uygulamam ne kadar kaynak içeriği görüntüleyebilir?
Web IQ Kullanım Koşulları'nın Ek A'sı, tek bir kaynaktan görüntülenen Grounding Content'i 200 karakter ya da web sitesi sahibi veya web yöneticisi tarafından belirtilen azami sınırdan düşük olanla sınırlar. Ses veya sesli deneyimler için aynı sınırı konuşulan çıkışa uygulayın. Özetler ve görüntüleme için ek kısıtlamalar geçerlidir. Alıntılar oluşturmadan önce Kullanım Koşullarını gözden geçirin; bu sınır, kaynak sayfaların tamamını çoğaltma izni değildir.
Görüntü ve video sonuçları bir LLM'yi temellendirmek için kullanılabilir mi?
Resim ve video meta verileri ile alternatif metinler, Grounding Content tanımına dahil edilir. Ancak, Web IQ Kullanım Koşulları, grounding amacıyla sonuçlardan alınan gerçek görüntülerin veya videoların kullanılmasını, bunların LLM çıkışına dahil edilmesini veya bunlardan türetilmiş görüntüler ya da videolar oluşturulmasını yasaklar. Hedeflenen uygulamaya alma şartlarını gözden geçirin.
Web IQ içeriğini önbelleğe alabilir veya depolayabilir miyim?
Genel bir kural olarak, hayır. Web IQ Kullanım Koşulları, koşulların izin verdiği durumlar dışında İçeriği kopyalamayı, depolamayı, önbelleğe almayı, arşivlemeyi veya İçerikten bir veritabanı oluşturmayı yasaklar (Bölüm 3.2.15 ve Ek A, Bölüm 4):
- Son kullanıcı sohbet geçmişi: GEÇERLİ yasalar izin verdiği sürece LLM Özetlerini (uygulamanızın son kullanıcılar için Temel İçerikten oluşturduğu özetler, Bölüm 2.5) her son kullanıcının sohbet geçmişi için toplu olmayan, her bir son kullanıcı bazında depolayabilirsiniz.
- Kurum içi çalışma ürünü: LLM Özetlerini ve bunlarla gösterilen kaynak bağlantıları, telif hakkı yasasının izin verdiği ölçüde notlar, raporlar, sunular veya güvenlik ve denetim günlükleri gibi kurum içi çalışma ürününüzün tümleşik bir parçası olarak depolayabilirsiniz. Hizmetler veya İçerik'in yerine, örneğin İçerik veritabanı oluşturmak, bağlantıları dizine eklemek, taramak veya kazımak ya da ayrı bir arama sunmak için kullanılamazlar.
- Atomik Eylem geçici işleme durumu: İçerik yalnızca llM tarafından başlatılan tek bir mantıksal isteği veya iş akışını (birden çok iç adım veya aracılı etkileşim içerebilen "Atomik Eylem") tamamlamak için kesin olarak gerekli olduğu şekilde geçici bir işlem durumunda tutulabilir. Atomic Action tamamlandığında içerik hemen silinmelidir.
Bu özel durumlar dışında, arama sonuçlarını depolamayın: Kullanım Koşulları türev veritabanlarına, kalıcı önbelleğe almaya veya İçeriğin uzun süreli arşivlenmesine izin vermez.
Web IQ Kullanım Koşulları'nı nereden okuyabilirim?
Geçerli koşullar Microsoft Web IQ Kullanım Koşulları adresinde yayımlanmaktadır. Bunlar mevcut Microsoft Müşteri Sözleşmesi ile birlikte uygulanır.