Bocha Wanxiang: API di ricerca della conoscenza per applicazioni AI

Che cos’è

Bocha Wanxiang è il servizio API di ricerca della piattaforma aperta Bocha AI. Combina ricerca ibrida multimodale e reranking semantico per recuperare notizie, immagini, video e contenuti enciclopedici da un indice di circa dieci miliardi di pagine web. L’obiettivo sono agenti AI, chatbot e sistemi RAG che hanno bisogno di conoscenza aggiornata del mondo in forma strutturata: così le allucinazioni diminuiscono e le risposte restano tracciabili fino alle fonti.

A differenza di un endpoint di ricerca web tradizionale, lo schema di risposta è costruito su ciò che un modello linguistico consuma davvero: titolo, URL, estratto, icona del sito, data di pubblicazione e immagini arrivano in un’unica risposta, senza dover scrivere un ulteriore livello di pulizia. La piattaforma riunisce ricerca web, generazione di risposte, reranking semantico e un database di ricerca ibrida, accetta query in linguaggio naturale e dichiara una latenza della ricerca web fino a 0,15 secondi. Il gestore afferma che i dati non escono dalla Cina continentale e che i risultati rispettano le norme di sicurezza locali, un aspetto rilevante nei contesti regolamentati.

Funzioni principali

• Web Search API: ricerca in linguaggio naturale sul web aperto con campi strutturati come titolo, URL, estratto, icona del sito, data e immagini. Fino a 50 risultati per chiamata, latenza da 0,15 secondi.
• AI Search API: ricerca ibrida con recupero automatico di dati strutturati per dominio verticale, più risposte generate dal modello, domande di follow-up e output in streaming. Restituisce riferimenti multimodali insieme a una risposta sintetica.
• Semantic Reranker API: un Transformer proprietario da 80 milioni di parametri che riordina i candidati dopo il primo passaggio BM25/RRF, supporta recall50@top_n50 e restituisce punteggi di rilevanza per avvicinare l’ordine a ciò che un LLM preferisce leggere.
• Agent Search API: indirizza la domanda a un agente designato e restituisce una risposta più approfondita con domande di follow-up. La beta è conclusa; i casi verticali specialistici dovrebbero passare a AI Search.
• Bocha Hybrid Search Database (BochaDB): ricerca ibrida per parole chiave e vettori con reranking semantico integrato, pensata come unico strato di retrieval per il RAG.
• API saldo: consultazione in tempo reale del saldo e del consumo di risorse.

Come si usa

1. Registrarsi e ottenere la chiave. Crea un account su https://open.bochaai.com/, ritira il pacchetto di risorse per le chiamate e genera una chiave API dalla console.
2. Scegliere l’integrazione. API REST ufficiale, function calling compatibile con OpenAI e LangChain, plugin per piattaforme come Tencent Yuanqi, Coze, DingTalk e Dify, oppure un server MCP.
3. Chiamare la ricerca web. Invia una query in linguaggio naturale a https://api.bocha.cn/v1/web-search; puoi limitare il periodo, restringere i domini e chiedere un riassunto testuale.
4. Passare a AI Search quando serve una risposta. Prima avviene la ricerca, poi viene redatta una risposta sintetica con le fonti; nei prodotti interattivi conviene attivare lo streaming per ridurre il tempo al primo token.
5. Riordinare i propri candidati. Passa un insieme esistente a bocha-semantic-reranker, usa i punteggi e riordina prima di costruire il contesto per il modello.
6. Monitorare i consumi. Collega l’endpoint del saldo e controlla la quota con regolarità, così il lancio in produzione non si blocca per i limiti.

L’API è RESTful in JSON e si autentica con un token Bearer che trasporta la chiave.

Dove si applica

• IA conversazionale: dare a un chatbot accesso al web in tempo reale, così le risposte citano fonti invece di inventare fatti.
• Domande e risposte in RAG: usare l’API come strato di retrieval di conoscenza strutturata e citabile dal web aperto, insieme a una base interna.
• Prodotti di ricerca con AI: costruire un’esperienza conversazionale con riassunti, riferimenti multimodali e domande di follow-up.
• Sviluppo di agenti: aggiungere recupero di informazioni in tempo reale tramite function calling o un plugin di piattaforma.
• Contesti con requisiti di conformità: i dati restano nella Cina continentale, il che si adatta ad applicazioni aziendali locali con regole severe su contenuti e flussi di dati.

Limiti e avvertenze

• Una ricerca restituisce al massimo 50 risultati web; per una copertura maggiore usa la paginazione o dividi le query.
• I 0,15 secondi riguardano la latenza di Web Search. AI Search genera testo, quindi il tempo complessivo è maggiore; lo streaming migliora la percezione.
• Agent Search non è più in beta: le esigenze verticali specialistiche vanno gestite con AI Search o con un agente proprio.
• La qualità dipende da come è formulata la query e dai siti indicizzati. Per temi di nicchia, contenuti interni a un sito o notizie molto dinamiche, limita domini e periodi.
• I risultati richiedono verifica e citazione esplicita: l’output dell’API è una prova, non una verità assoluta.
• Prezzi, quota e limiti di concorrenza sono definiti nella console ufficiale; prima di mandare traffico di produzione conviene fare un piccolo test di carico.

Domande frequenti

In che cosa differisce da una normale API di ricerca web?

Una API normale restituisce elenchi di link. Bocha Wanxiang restituisce campi strutturati pensati per i modelli, con reranking semantico e risposte generate, mirando a allucinazioni e freschezza dei dati.

Quali opzioni di integrazione sono disponibili?

L’API REST ufficiale, il function calling compatibile con OpenAI e LangChain, plugin per Tencent Yuanqi, Coze, DingTalk e Dify, e un server MCP.

Come viene gestita la conformità dei dati?

Il gestore dichiara che i dati non escono dalla Cina continentale e che i risultati seguono le norme locali. È opportuno confermare termini e certificazioni con il fornitore prima di affidarsi a queste garanzie.