Bocha Wanxiang : une API de recherche de connaissances pour les applications d’IA

Présentation

Bocha Wanxiang est le service d’API de recherche de la plateforme ouverte Bocha AI. Il associe une recherche hybride multimodale à un reranking sémantique pour retrouver actualités, images, vidéos et contenus encyclopédiques dans un index d’environ dix milliards de pages web. La cible : les agents d’IA, les chatbots et les systèmes RAG qui ont besoin d’une connaissance du monde à jour, livrée sous forme structurée. Résultat, moins d’hallucinations et des réponses dont les sources restent vérifiables.

Contrairement à un point d’accès de recherche web classique, le schéma de réponse est organisé selon ce qu’un modèle de langage consomme réellement : titre, URL, extrait, icône du site, date de publication et images arrivent dans une seule réponse, sans couche de nettoyage supplémentaire à écrire. La plateforme réunit recherche web, génération de réponses, reranking sémantique et base de recherche hybride, accepte les requêtes en langage naturel et annonce une latence de 0,15 seconde pour la recherche web. L’exploitant indique que les données ne sortent pas de Chine continentale et que les résultats respectent les règles de sécurité locales, un point important pour les déploiements réglementés.

Fonctions principales

• Web Search API : recherche en langage naturel sur le web ouvert, avec des champs structurés comme le titre, l’URL, l’extrait, l’icône du site, la date et les images. Jusqu’à 50 résultats par appel, latence à partir de 0,15 seconde.
• AI Search API : recherche hybride avec récupération automatique de données structurées par domaine, plus réponses générées par le modèle, questions de suivi et sortie en streaming. Renvoie des références multimodales accompagnées d’une réponse synthétique.
• Semantic Reranker API : un Transformer maison de 80 millions de paramètres qui réordonne les candidats après le premier passage BM25/RRF, prend en charge recall50@top_n50 et renvoie des scores de pertinence pour rapprocher le classement de ce qu’un LLM préfère lire.
• Agent Search API : confie la question à un agent désigné et renvoie une réponse plus approfondie avec des questions de suivi. La bêta est terminée ; les besoins métier spécifiques doivent passer par AI Search.
• Bocha Hybrid Search Database (BochaDB) : recherche hybride mots-clés et vecteurs avec reranking sémantique intégré, pensée comme couche de récupération unique pour le RAG.
• API de solde : consulter en temps réel le solde du compte et la consommation de ressources.

Comment l’utiliser

1. S’inscrire et obtenir une clé. Créez un compte sur https://open.bochaai.com/, récupérez le pack de ressources d’appel puis générez une clé API dans la console.
2. Choisir le mode d’intégration. API REST officielle, function calling compatible OpenAI et LangChain, plugins pour Tencent Yuanqi, Coze, DingTalk et Dify, ou serveur MCP.
3. Appeler la recherche web. Envoyez une requête en langage naturel à https://api.bocha.cn/v1/web-search ; la période, les domaines et le résumé textuel sont paramétrables.
4. Passer à AI Search quand une réponse est attendue. La recherche s’exécute d’abord, puis une réponse synthétique cite ses sources ; en produit interactif, activez le streaming pour réduire le délai avant le premier token.
5. Réordonner vos propres candidats. Transmettez un ensemble existant à bocha-semantic-reranker, récupérez les scores et reclassez avant de construire le contexte du modèle.
6. Surveiller la consommation. Branchez l’endpoint de solde et vérifiez le quota régulièrement pour éviter un blocage en production.

L’API est de type RESTful JSON et s’authentifie avec un jeton Bearer contenant la clé.

Cas d’usage

• IA conversationnelle : donner à un chatbot un accès web en direct pour que ses réponses citent des sources au lieu d’inventer des faits.
• Questions-réponses en RAG : utiliser l’API comme couche de récupération de connaissances structurées et citables issues du web ouvert, en complément d’une base interne.
• Produits de recherche assistée par IA : construire une expérience conversationnelle avec synthèse, références multimodales et questions de suivi.
• Développement d’agents : ajouter une récupération d’informations en temps réel via function calling ou un plugin de plateforme.
• Déploiements soumis à conformité : les données restent en Chine continentale, ce qui convient aux applications d’entreprise locales avec des exigences strictes sur les contenus et les flux de données.

Limites et précautions

• Une recherche renvoie au maximum 50 résultats web ; paginez ou découpez la requête pour couvrir davantage.
• Les 0,15 seconde concernent la latence de Web Search. AI Search génère du texte, donc le temps total est plus long ; le streaming améliore la perception.
• Agent Search n’est plus en bêta : les besoins verticaux spécialisés doivent passer par AI Search ou un agent maison.
• La qualité dépend de la formulation et de la couverture de l’index. Pour les sujets de niche, les contenus internes à un site ou l’actualité très mouvante, limitez domaines et périodes.
• Les résultats exigent une vérification et une citation explicite : la sortie de l’API est une preuve, pas une vérité absolue.
• Tarifs, quotas et limites de concurrence sont fixés dans la console officielle ; faites un petit test de charge avant d’envoyer du trafic de production.

Questions fréquentes

Quelle différence avec une API de recherche web classique ?

Une API classique renvoie des liens. Bocha Wanxiang renvoie des champs structurés pensés pour les modèles, avec reranking sémantique et réponses générées, pour traiter l’hallucination et la fraîcheur des données.

Quels modes d’intégration sont disponibles ?

L’API REST officielle, le function calling compatible OpenAI et LangChain, des plugins pour Tencent Yuanqi, Coze, DingTalk et Dify, ainsi qu’un serveur MCP.

Comment la conformité des données est-elle gérée ?

L’exploitant indique que les données ne sortent pas de Chine continentale et que les résultats respectent les règles locales. Il est prudent de confirmer les conditions exactes et les certifications auprès du fournisseur.