Bocha Wanxiang: API de búsqueda con conocimiento para aplicaciones de IA

Qué es

Bocha Wanxiang es el servicio de API de búsqueda de la plataforma abierta Bocha AI. Combina recuperación híbrida multimodal con reordenación semántica para localizar noticias, imágenes, vídeos y contenido enciclopédico dentro de un índice de casi diez mil millones de páginas web. Está pensado para agentes de IA, chatbots y sistemas RAG que necesitan conocimiento actual del mundo en formato estructurado: así se reduce la alucinación y las respuestas conservan fuentes verificables.

A diferencia de un endpoint de búsqueda web convencional, el esquema de respuesta se organiza según lo que consume un modelo de lenguaje: título, URL, fragmento, icono del sitio, fecha de publicación e imágenes llegan en una sola carga, de modo que el equipo no tiene que escribir otra capa de limpieza. La plataforma reúne búsqueda web, generación de respuestas, reordenación semántica y una base de datos de búsqueda híbrida, acepta consultas en lenguaje natural y declara una latencia de hasta 0,15 segundos en la búsqueda web. El operador indica que los datos no salen de China continental y que los resultados cumplen la normativa de seguridad local, algo relevante en despliegues regulados.

Funciones principales

• Web Search API: búsqueda en lenguaje natural en toda la web con campos estructurados como título, URL, fragmento, icono del sitio, fecha e imágenes. Hasta 50 resultados por llamada y latencia de hasta 0,15 segundos.
• AI Search API: recuperación híbrida con datos estructurados automáticos por dominio vertical, además de respuestas generadas por el modelo, preguntas de seguimiento y salida en streaming. Devuelve referencias multimodales junto a un resumen.
• Semantic Reranker API: un Transformer propio de 80 millones de parámetros que reordena candidatos después del primer paso BM25/RRF, admite recall50@top_n50 y devuelve puntuaciones de relevancia para acercar el resultado a lo que prefiere leer un LLM.
• Agent Search API: dirige la pregunta a un agente designado y devuelve una respuesta más profunda con sugerencias de seguimiento. La beta ya cerró; los casos verticales deben migrar a AI Search.
• Bocha Hybrid Search Database (BochaDB): recuperación híbrida de palabras clave y vectores con reordenación semántica integrada, pensada como capa única para sistemas RAG.
• API de saldo: consulta en tiempo real del saldo y del consumo de recursos.

Cómo se usa

1. Registrarse y obtener la clave. Crea una cuenta en https://open.bochaai.com/, reclama el paquete de recursos de llamadas y genera una API key en la consola.
2. Elegir la vía de integración. API REST oficial, function calling compatible con OpenAI y LangChain, plugins para plataformas como Tencent Yuanqi, Coze, DingTalk y Dify, o un servidor MCP.
3. Llamar a la búsqueda web. Envía la consulta a https://api.bocha.cn/v1/web-search en lenguaje natural; puedes acotar el rango temporal, restringir dominios y pedir resúmenes de texto.
4. Pasar a AI Search cuando necesites una respuesta. Primero recupera y después redacta un resumen con referencias; en productos interactivos conviene activar el streaming para reducir el tiempo hasta el primer token.
5. Reordenar tus propios candidatos. Envía un conjunto existente a bocha-semantic-reranker, toma las puntuaciones y reordena antes de construir el contexto del modelo.
6. Vigilar el consumo. Conecta el endpoint de saldo y revisa la cuota con regularidad para que el lanzamiento no se detenga por límites.

La API es RESTful con JSON y se autentica mediante un token Bearer que transporta la clave.

Casos de uso

• IA conversacional: dar acceso web en vivo a un chatbot para que las respuestas incluyan citas en lugar de datos inventados.
• Preguntas y respuestas con RAG: usar la API como capa de recuperación que trae conocimiento estructurado y citable de la web abierta, junto a una base interna.
• Productos de búsqueda con IA: construir una experiencia conversacional con resúmenes, referencias multimodales y preguntas de seguimiento.
• Desarrollo de agentes: añadir recuperación de información en tiempo real mediante function calling o un plugin de plataforma.
• Despliegues con requisitos de cumplimiento: los datos permanecen en China continental, lo que encaja con aplicaciones empresariales locales con reglas estrictas de contenido y flujo de datos.

Límites y advertencias

• Una búsqueda devuelve como máximo 50 resultados web; pagina o divide las consultas si necesitas más cobertura.
• La cifra de 0,15 segundos corresponde a la latencia de Web Search. AI Search debe generar texto, así que el tiempo total es mayor; el streaming mejora la percepción de velocidad.
• Agent Search ya no está en pruebas, por lo que las necesidades verticales especializadas deben resolverse con AI Search o con un agente propio.
• La calidad depende de cómo se formula la consulta y de los sitios indexados; en temas de cola larga, contenido interno o asuntos muy cambiantes conviene acotar dominios y fechas.
• Los resultados requieren verificación humana o posterior y citación explícita: la salida de la API es evidencia, no verdad absoluta.
• Precios, cuota y límites de concurrencia se fijan en la consola oficial; conviene hacer una prueba de carga pequeña antes de enviar tráfico de producción.

Preguntas frecuentes

¿En qué se diferencia de una API de búsqueda web estándar?

Un endpoint estándar devuelve enlaces. Bocha Wanxiang devuelve campos estructurados pensados para modelos, además de reordenación semántica y respuestas generadas, con el foco puesto en la alucinación y la frescura de los datos.

¿Qué opciones de integración existen?

La API REST oficial, function calling compatible con OpenAI y LangChain, plugins para Tencent Yuanqi, Coze, DingTalk y Dify, y un servidor MCP.

¿Cómo se gestiona el cumplimiento de datos?

El operador declara que los datos no salen de China continental y que los resultados cumplen la normativa local. Conviene confirmar los términos y certificaciones exactos con el proveedor antes de depender de ellos.