Bocha Wanxiang: yapay zekâ uygulamaları için bilgi arama API’si

Genel bakış

Bocha Wanxiang, Bocha AI açık platformunun sunduğu arama API hizmetidir. Çok kipli hibrit aramayı anlamsal yeniden sıralamayla birleştirerek yaklaşık on milyar web sayfalık bir dizinden haber, görsel, video ve ansiklopedik içerik çıkarır. Hedef kitle, güncel dünya bilgisini yapılandırılmış biçimde alması gereken yapay zekâ ajanları, sohbet botları ve RAG sistemleridir. Böylece halüsinasyon azalır ve yanıtlar kaynağına kadar izlenebilir kalır.

Klasik bir web arama uç noktasından farklı olarak yanıt şeması, dil modelinin gerçekte tükettiği biçime göre kurgulanmıştır: başlık, URL, alıntı, site simgesi, yayın zamanı ve görseller tek bir yanıtla gelir; ayrı bir temizleme katmanı yazmaya gerek kalmaz. Platform web aramasını, yanıt üretimini, anlamsal yeniden sıralamayı ve hibrit arama veritabanını bir arada sunar, doğal dildeki sorguları kabul eder ve web aramasında 0,15 saniyeye kadar inen gecikme bildirir. İşletmeci, verilerin Çin anakarası dışına çıkmadığını ve sonuçların yerel güvenlik kurallarına uyduğunu belirtir; bu, düzenlemeye tabi kurulumlarda önemlidir.

Temel yetenekler

• Web Search API: açık webde doğal dilde arama; başlık, URL, alıntı, site simgesi, yayın zamanı ve görsel gibi yapılandırılmış alanlar döner. Çağrı başına en fazla 50 sonuç, 0,15 saniyeye kadar düşük gecikme.
• AI Search API: hibrit arama ve dikey alanlara özel yapılandırılmış verilerin otomatik alınması; ayrıca modelin ürettiği yanıt, takip soruları ve akış çıktısı. Çok kipli referansları özet yanıtla birlikte verir.
• Semantic Reranker API: 80 milyon parametreli, kendi geliştirdiği Transformer modeli; BM25/RRF ilk sıralamasından sonra adayları yeniden sıralar, recall50@top_n50 destekler ve alaka puanı döndürerek sıralamayı LLM’in okumayı tercih ettiği düzene yaklaştırır.
• Agent Search API: soruyu belirli bir ajana yönlendirip daha derin yanıt ve takip soruları verir. Beta süreci kapandı; dikey ihtiyaçlar AI Search’e taşınmalıdır.
• Bocha Hybrid Search Database (BochaDB): anahtar sözcük ve vektör hibrit araması, yerleşik anlamsal yeniden sıralama; RAG için tek bir erişim katmanı.
• Bakiye API’si: hesap bakiyesini ve kaynak tüketimini anlık görüntüleme.

Nasıl kullanılır

1. Kaydolun ve API anahtarı alın. https://open.bochaai.com/ adresinde hesap açın, çağrı kaynak paketini alın ve konsoldan bir API anahtarı oluşturun.
2. Entegrasyon yolunu seçin. Resmî REST API, OpenAI ve LangChain uyumlu function calling, Tencent Yuanqi, Coze, DingTalk ve Dify eklentileri ya da MCP sunucusu.
3. Web aramasını çağırın. https://api.bocha.cn/v1/web-search adresine doğal dilde sorgu gönderin; zaman aralığı, alan adı kısıtı ve metin özeti isteğe bağlıdır.
4. Yanıt gerektiğinde AI Search’e geçin. Önce arama yapılır, ardından kaynaklarıyla birlikte özet yanıt üretilir; etkileşimli ürünlerde akış çıktısını açmak ilk belirteç süresini kısaltır.
5. Kendi adaylarınızı yeniden sıralayın. Mevcut belge kümesini bocha-semantic-reranker’a verin, puanları alın ve model bağlamını kurmadan önce sırayı değiştirin.
6. Tüketimi izleyin. Bakiye uç noktasını bağlayın ve kotayı düzenli kontrol edin; üretim başladıktan sonra limit nedeniyle durma olmasın.

API, RESTful JSON yapısındadır ve API anahtarını taşıyan Bearer belirteciyle kimlik doğrular.

Kullanım alanları

• Konuşma tabanlı yapay zekâ: sohbet botuna canlı web erişimi vererek yanıtların uydurma bilgi yerine kaynak içermesini sağlar.
• RAG soru-cevap: açık webden yapılandırılmış ve alıntılanabilir bilgi getiren erişim katmanı olarak, kurum içi bilgi tabanıyla birlikte kullanılır.
• Yapay zekâ destekli arama ürünleri: özet, çok kipli referans ve takip soruları olan konuşmalı bir arama deneyimi kurulur.
• Ajan geliştirme: function calling veya platform eklentisi üzerinden ajana gerçek zamanlı bilgi erişimi eklenir.
• Uyumluluk gerektiren kurulumlar: veriler Çin anakarasında kalır; içerik ve veri akışı konusunda katı kuralları olan yerel kurumsal uygulamalara uygundur.

Sınırlar ve dikkat edilmesi gerekenler

• Tek aramada en fazla 50 web sonucu döner; daha geniş kapsam için sayfalama yapın veya sorguyu bölün.
• 0,15 saniye Web Search gecikmesidir. AI Search metin ürettiği için toplam süre daha uzundur; akış çıktısı algıyı iyileştirir.
• Agent Search artık beta değildir; özel dikey ihtiyaçlar AI Search veya kendi ajanınızla çözülmelidir.
• Kalite, sorgunun ifadesine ve dizin kapsamına bağlıdır. Niş konularda, site içi içeriklerde veya hızla değişen haberlerde alan adı ve tarih aralığı sınırlayın.
• Sonuçların insan ya da alt sistem tarafından doğrulanması ve açıkça kaynak gösterilmesi gerekir; API çıktısı kanıttır, kesin doğru değildir.
• Fiyatlandırma, kota ve eşzamanlılık sınırları resmî konsolda belirlenir; üretim trafiğinden önce küçük bir yük testi yapın.

Sık sorulan sorular

Normal bir web arama API’sinden farkı nedir?

Normal API bağlantı listesi döndürür. Bocha Wanxiang, model dostu yapılandırılmış alanların yanında anlamsal yeniden sıralama ve üretilmiş yanıtlar sunar; odağı RAG ve ajan iş akışlarındaki halüsinasyon ile güncellik sorunudur.

Hangi entegrasyon seçenekleri var?

Resmî REST API, OpenAI ve LangChain uyumlu function calling, Tencent Yuanqi, Coze, DingTalk ve Dify eklentileri ile MCP sunucusu.

Veri uyumluluğu nasıl ele alınıyor?

İşletmeci, verilerin Çin anakarası dışına çıkmadığını ve sonuçların yerel güvenlik kurallarına uyduğunu belirtir. Kesin koşulları ve sertifikaları kullanmadan önce sağlayıcıdan doğrulamak gerekir.